Export (0) Print
Expand All

Set-UMServer

 

Applies to: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Topic Last Modified: 2007-06-28

The Set-UMServer cmdlet lets you set the properties on a Unified Messaging (UM) server.


Set-UMServer -Identity <UMServerIdParameter> [-Confirm [<SwitchParameter>]] [-DialPlans <MultiValuedProperty>] [-DomainController <Fqdn>] [-GrammarGenerationSchedule <ScheduleInterval[]>] [-MaxASRSessionsAllowed <Nullable>] [-MaxCallsAllowed <Nullable>] [-MaxFaxCallsAllowed <Nullable>] [-MaxTTSSessionsAllowed <Nullable>] [-Status <Enabled | Disabled | NoNewCalls>] [-WhatIf [<SwitchParameter>]]


Set-UMServer [-Confirm [<SwitchParameter>]] [-DialPlans <MultiValuedProperty>] [-DomainController <Fqdn>] [-GrammarGenerationSchedule <ScheduleInterval[]>] [-Instance <UMServer>] [-MaxASRSessionsAllowed <Nullable>] [-MaxCallsAllowed <Nullable>] [-MaxFaxCallsAllowed <Nullable>] [-MaxTTSSessionsAllowed <Nullable>] [-Status <Enabled | Disabled | NoNewCalls>] [-WhatIf [<SwitchParameter>]]

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 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 Microsoft Exchange Server 2007, see Permission Considerations.

 

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.

Confirm

Optional

System.Management.Automation.SwitchParameter

This parameter causes the command to pause processing and requires that you acknowledge what the command will do before processing continues. The default value is $true.

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

This parameter specifies the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to the Active Directory directory service.

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.

WhatIf

Optional

System.Management.Automation.SwitchParameter

This parameter instructs the command to simulate the actions that it would take on the object. By using the WhatIf parameter, you can view what changes would occur without having to apply any of those changes. The default value is $true.

 

Error Description

 

 

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
To ensure that you are reading the most up-to-date information and to find additional Exchange Server 2007 documentation, visit the Exchange Server TechCenter.
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft