Set-UMServer (RTM)
Microsoft Exchange Server 2007 will reach end of support on April 11, 2017. To stay supported, you will need to upgrade. For more information, see Resources to help you upgrade your Office 2007 servers and clients.
Applies to: Exchange Server 2007
The Set-UMServer cmdlet lets you set the properties on a Unified Messaging (UM) server.
Syntax
Set-UMServer -Identity <UMServerIdParameter> [-DialPlans <MultiValuedProperty>] [-DomainController <Fqdn>] [-GrammarGenerationSchedule <ScheduleInterval[]>] [-MaxASRSessionsAllowed <Nullable>] [-MaxCallsAllowed <Nullable>] [-MaxFaxCallsAllowed <Nullable>] [-MaxTTSSessionsAllowed <Nullable>] [-Status <Enabled | Disabled | NoNewCalls>]
Set-UMServer [-DialPlans <MultiValuedProperty>] [-DomainController <Fqdn>] [-GrammarGenerationSchedule <ScheduleInterval[]>] [-Instance <UMServer>] [-MaxASRSessionsAllowed <Nullable>] [-MaxCallsAllowed <Nullable>] [-MaxFaxCallsAllowed <Nullable>] [-MaxTTSSessionsAllowed <Nullable>] [-Status <Enabled | Disabled | NoNewCalls>]
Detailed Description
The Set-UMServer cmdlet is used to set specific properties on a Unified Messaging server. This cmdlet can be used to set individual Unified Messaging parameters for a specified Unified Messaging server.
To run the Set-UMServer cmdlet, the account you use must be delegated the following:
- Exchange Server Administrator role and local Administrators group for the target server
For more information about permissions, delegating roles, and the rights that are required to administer Exchange Server 2007, see Permission Considerations.
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
Identity |
Required |
Microsoft.Exchange.Configuration.Tasks.UMServerIdParameter |
This parameter specifies the ID for the Unified Messaging server object that is to be configured. This parameter specifies the directory object ID for the UM server. This parameter is required if the Instance parameter is not used. |
DialPlans |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
This parameter specifies all the dial plans for which this server will handle UM calls. If no dial plans are defined, the Unified Messaging server will not handle UM calls. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
To specify the fully qualified domain name of the domain controller that writes this configuration change to the Active Directory directory service, include the DomainController parameter on the cmdlet. |
GrammarGenerationSchedule |
Optional |
Microsoft.Exchange.Common.ScheduleInterval[] |
This parameter specifies the scheduled times to start speech grammar re-generation. This parameter allows only one start time per day. |
Instance |
Optional |
Microsoft.Exchange.Data.Directory.Management.UMServer |
This parameter specifies the object input parameter. This parameter is required if the Identity parameter is not used. |
MaxASRSessionsAllowed |
Optional |
System.Nullable |
This parameter specifies the maximum number of concurrent Automatic Speech Recognition (ASR) sessions. |
MaxCallsAllowed |
Optional |
System.Nullable |
This parameter specifies the maximum number of concurrent calls that the Unified Messaging server will allow. |
MaxFaxCallsAllowed |
Optional |
System.Nullable |
This parameter specifies the maximum number of concurrent fax calls that the Unified Messaging server will allow. |
MaxTTSSessionsAllowed |
Optional |
System.Nullable |
This parameter specifies the maximum number of concurrent Text-to-Speech (TTS) sessions that the Unified Messaging server will allow. |
Status |
Optional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ServerStatus |
This parameter lets the administrator manipulate the Unified Messaging server status. Enabled, Disabled, and NoNewCalls are the available options. |
Input Types
Return Types
Errors
| Error | Description |
|---|---|
|
|
Example
The first code example prevents a Unified Messaging server named MyUMServer from accepting new calls.
The second code example removes a Unified Messaging server named MyUMServer from all UM dial plans.
The third code example adds the Unified Messaging server named MyUMServer to a UM dial plan named MyUMDialPlanName and also sets the maximum number of incoming voice and fax calls.
The fourth code example changes the grammar generation schedule to 2:30-3:00 every day on a Unified Messaging server named MyUMServer.
Set-UMServer -Identity MyUMServer -Status NoNewCalls
Set-UMServer -Identity MyUMServer -DialPlans $null
Set-UMServer -Identity MyUMServer -DialPlans MyUMDialPlanName -MaxCalls 50 -MaxFaxCalls 15
Set-UMServer -Identity MyUMServer -GrammarGenerationSchedule 1.02:30-1.03:00, 2.02:30-2.03:00, 3.02:30-3.03:00, 4.02:30-4.03:00, 5.02:30-5.03:00, 6.02:30-6.03:00