Unified Communications Diagnostics 8.6.3

UC Diagnostics ships with a PowerShell script called new-Exchange2007TestMailboxes to simplify creating test mailboxes for Exchange 2007 servers. This script will create one test mailbox per store per server. The list of Exchange servers must be piped into the script.

The script must be run inside the Exchange 2007 Management Shell from a computer in the same forest as the Exchange servers. The script has the following syntax:

.\new-Exchange2007TestMailboxes.ps1
-OrganizationalUnit <OrganizationalUnitString>]
[-MailboxNameMask <MailboxNameMaskString>]
[-AuthorizedUser <AuthorizedUserName>]
[-NoPrompt]

where:

Table 86. Exchange 2007 test mailbox parameters.
Parameter	Description
Organizational Unit	Indicates the location in the Active Directory where the created user is associated with a mailbox. If this parameter is not specified, you are prompted to enter the name of an Organizational Unit.
Mailbox Name Mask	Indicates the pattern of mailbox names that the script generates. This parameter is optional. If it is not specified, the default mask is SOM_<ServerName>_<StorageGroupName>_<StoreName>.
Authorized User	Indicates the user account that will be granted access to the created mailboxes. This should be the account specified for the Diagnostic Services component during install unless alternate credentials are specified for the test. If this parameter is not specified, you are prompted to enter the user account name.
No Prompt	Allows you to suppress confirmation to create each test mailbox. This parameter is optional. If it is not specified, confirmation is required before creating each test mailbox.

To run scripts, the account must have the following permissions:

Table 87. Exchange 2007 permissions required to run scripts

Exchange version

Permissions

Exchange 2007

•

Exchange Recipient Administrator role

•

Account Operator role for the applicable Active Directory containers

For example, to create test mailboxes on all servers with the default mailbox mask, use:

Get-mailboxserver|.\new-Exchange2007TestMailboxes.ps1
-OrganizationalUnit
"CN=Users,DC=mscs,DC=qc,DC=kan,DC=ca,DC=qsft"
-AuthorizedUser Administrator

Or, to create test mailboxes on the server AMER-MBX-01 with a non-default mailbox mask:

Get-mailboxserver amer-mbx-01|.\new-Exchange2007TestMailboxes.ps1
-OrganizationalUnit
"OU=TestAccounts,DC=mscs,DC=qc,DC=kan,DC=ca,DC=qsft"
-AuthorizedUser myAccount -MailboxNameMask
TestMailbox.<StorageGroupName>.<ServerName>.<StoreName>

Creating Exchange 2010 or Exchange 2013 test mailboxes

To simplify creating test mailboxes for Exchange 2010 or Exchange 2013 servers, UC Diagnostics ships with a PowerShell script called new-Exchange2010and2013TestMailboxes. This script creates one test mailbox per database per server, or one test mailbox per server, depending on the mask setting. The list of Exchange servers must be piped into the script.

If the test source mailbox is hosted on an Exchange 2010/2013 mailbox database, the Exchange organization must have at least one available Exchange CAS server that exists on the same site as the server that hosts the active mailbox database copy. Mailboxes must be named according to the server and database where they are located.

If you are creating a test mailbox for the Exchange 2010 OWA Health test, ensure all database copies for the mailbox database are in the same site as your CAS server. Because the PowerShell cmdlet used in the test requires a test mailbox for each site, this guarantees you always have a test mailbox in the site, even when databases fail over/switch over among member servers of the Database Availability Group (DAG).

Exchange 2010/2013 mailbox creation script syntax

You must run the script inside the Exchange 2010 or Exchange 2013 Management Shell from a computer in the same forest as the Exchange servers. The script has the following syntax:

.\new-Exchange2010and2013TestMailboxes.ps1

-OrganizationalUnit <OrganizationalUnitString>]
[-MailboxNameMask <MailboxNameMaskString>]
[-AuthorizedUser <AuthorizedUserName>]
[-NoPrompt]

Table 88. Exchange 2010/2013 test mailbox parameters.
Parameter	Description
Organizational Unit	Indicates the location in the Active Directory where the created user is associated with a mailbox. If this parameter is not specified, you are prompted to enter the name of an Organizational Unit.
Mailbox Name Mask	Indicates the pattern of mailbox names that the script generates. This must match the setting in the Internal Server Delivery Health test. This parameter is optional. If it is not specified, the default mask is SOM_<ServerName>_<DatabaseName>. <DatabaseName> is optional.
Authorized User	Indicates the user account that is granted access to the created mailboxes. This must be the account specified for the Diagnostic Services component during install unless alternate credentials are specified for the test.
No Prompt	Allows you to suppress confirmation to create each test mailbox. This parameter is optional. If it is not specified, confirmation is required before creating each test mailbox.