Applies to: Exchange Server 2007
Topic Last Modified: 2007-06-11

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>]

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.

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.

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.

Copy Code
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