Set-UmServer

参考

模块:: ExchangePowerShell

适用于:: Exchange Server 2010

此 cmdlet 仅在 2010 Exchange Server可用。

使用 Set-UMServer cmdlet 修改与统一消息 (UM) 服务器角色关联的设置。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

Set-UmServer
   [-Identity] <UMServerIdParameter>
   [-Confirm]
   [-DialPlans <MultiValuedProperty>]
   [-DomainController <Fqdn>]
   [-ExternalServiceFqdn <UMSmartHost>]
   [-GrammarGenerationSchedule <ScheduleInterval[]>]
   [-IrmLogEnabled <Boolean>]
   [-IrmLogMaxAge <EnhancedTimeSpan>]
   [-IrmLogMaxDirectorySize <Unlimited>]
   [-IrmLogMaxFileSize <ByteQuantifiedSize>]
   [-IrmLogPath <LocalLongFullPath>]
   [-MaxCallsAllowed <Int32>]
   [-SIPAccessService <ProtocolConnectionSettings>]
   [-SipTcpListeningPort <Int32>]
   [-SipTlsListeningPort <Int32>]
   [-Status <ServerStatus>]
   [-UMStartupMode <UMStartupMode>]
   [-WhatIf]
   [<CommonParameters>]

说明

Set-UMServer cmdlet 设置统一消息服务器上的特定属性。此 cmdlet 可用于为指定的统一消息服务器设置单个统一消息参数。

此任务完成后，使用此 cmdlet 设置参数和指定的值。

您必须先获得权限，然后才能运行此 cmdlet。虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

Set-UMServer -Identity MyUMServer -Status NoNewCalls

此示例阻止统一消息服务器 MyUMServer 接受新调用。

示例 2

Set-UMServer -Identity MyUMServer -DialPlans $null

此示例从所有 UM 拨号计划中删除统一消息服务器 MyUMServer。

示例 3

Set-UMServer -Identity MyUMServer -DialPlans MyUMDialPlanName -MaxCallsAllowed 50

本示例将统一消息服务器 MyUMServer 添加到 UM 拨号计划 MyUMDialPlanName，并将最大传入语音呼叫数设置为 50。

示例 4

Set-UMServer -Identity MyUMServer -GrammarGenerationSchedule 0.02:30-1.03:00,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

本示例将统一消息服务器 MyUMServer 上的语法生成计划更改为每天 02：30-03：00。

参数

-Confirm

Confirm 开关指定是否显示确认提示。此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

破坏性 cmdlet (例如，Remove-* cmdlet) 具有内置的暂停，该暂停会强制你在继续操作之前确认命令。对于这些 cmdlet，您可以使用此确切语法跳过确认提示：-Confirm:$false。
大多数其他 cmdlet (例如，New-* 和 Set-* cmdlet) 没有内置暂停。对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-DialPlans

DialPlans 参数指定此服务器将处理 UM 呼叫的所有拨号计划。如果未定义拨号计划，统一消息服务器将不会处理 UM 呼叫。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-DomainController

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。可以使用完全限定的域名 (FQDN) 来标识域控制器。例如，dc01.contoso.com。

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-ExternalServiceFqdn

ExternalServiceFqdn 参数是为统一消息服务器提供服务的负载均衡器的 FQDN 或主机名。将统一消息服务器从组织内部迁移到 Microsoft Exchange Server 2010 托管环境时，此参数非常有用。外部服务主机 FQDN 最多可以包含 2，048 个字符。

Type:	UMSmartHost
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-GrammarGenerationSchedule

GrammarGenerationSchedule 参数指定启动语音语法生成过程的计划次数。此参数只允许每天启动一次。语法生成的默认计划时间是当地时间每天 02:00－02:30。

此参数的语法为： StartDay.Hour:Minute [AM | PM]-EndDay.Hour:Minute [AM | PM]。可以指定用逗号分隔的多个计划： "Schedule1","Schedule2",..."ScheduleN"。

可使用以下天数值：

当天的全名。
当天的缩写名称。
介于 0 到 6 的整数，其中 0 = 星期日。

可以输入 24 小时格式的时间，并省略 AM/PM 值。如果以 12 小时格式输入时间，请在时间与 AM/PM 值之间添加一个空格。

可以混合和匹配日期/时间格式。

开始时间和结束时间必须至少间隔 15 分钟。分钟数将四舍五入到 0、15、30 或 45。如果指定多个间隔，则每个间隔之间必须至少有 15 分钟。

下面是一些示例：

"Sun.11:30 PM-Mon.1:30 AM"
“6.22：00-6.22：15” (从周六晚上 10：00 运行到周六晚上 10：15.)
“星期日 1：15 AM-monday.23：00”
“Monday.4：30 AM-monday.5：30 AM”，“wednesday.4：30 AM-wednesday.5：30 AM” (从周一和周三早上的 4：30 运行到 5：30.)

Type:	ScheduleInterval[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Identity

Identity 参数指定要修改的统一消息服务器。可以使用唯一标识该服务器的任何值。例如：

名称
GUID
可分辨名称 (DN)
ExchangeLegacyDN

Type:	UMServerIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-IrmLogEnabled

IrmLogEnabled 参数指定是否启用信息权限管理 (IRM) 事务的日志记录。默认情况下会启用 IRM 日志记录。值包括：

$true启用 IRM 日志记录
$false禁用 IRM 日志记录

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-IrmLogMaxAge

IrmLogMaxAge 参数指定 IRM 日志文件的最长期限。早于指定值的日志文件将被删除。默认值为 30 天。若要指定值，请输入时间跨度值：dd.hh：mm：ss，其中 d = 天，h = 小时，m = 分钟，s = 秒。此参数的有效输入范围是 00:00:00 到 24855.03:14:07。将 IrmLogMaxAge 参数的值设置为 00:00:00，可以防止由于期限问题而自动删除 IRM 日志文件。

Type:	EnhancedTimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-IrmLogMaxDirectorySize

IrmLogMaxDirectorySize 参数指定连接日志目录中的所有 IRM 日志的最大大小。当目录达到其最大文件大小时，服务器会首先删除最早的日志文件。默认值为 250 MB。有效值是一个数字，最大可为 1.999999999 TB（即 2199023254528 B）或值 unlimited。默认值为 6 GB（即 6442450944 B）。

B（字节）
KB（千字节）
MB（兆字节）
GB（千兆字节）
TB (TB)

未限定的值被视为以字节为单位。 IrmLogMaxFileSize 参数的值必须小于或等于 IrmLogMaxDirectorySize 参数的值。这两个参数的有效输入范围都是从 1 到 9223372036854775807 字节。如果输入值 unlimited，则对连接日志目录没有大小限制。

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-IrmLogMaxFileSize

IrmLogMaxFileSize 参数指定每个 IRM 日志文件的最大大小。当日志文件达到其最大文件大小时，将创建新的日志文件。默认值为 10 MB。有效值是一个数字，最大可为 1.999999999 TB（即 2199023254528 B）或值 unlimited。默认值为 6 GB（即 6442450944 B）。

B（字节）
KB（千字节）
MB（兆字节）
GB（千兆字节）
TB (TB)

未限定的值被视为以字节为单位。 IrmLogMaxFileSize 参数的值必须小于或等于 IrmLogMaxDirectorySize 参数的值。这两个参数的有效输入范围都是从 1 到 9223372036854775807 字节。如果输入值 unlimited，则对 IRM 日志文件没有大小限制。

Type:	ByteQuantifiedSize
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-IrmLogPath

IrmLogPath 参数指定默认的 IRM 日志目录位置。默认值为 C：\Program Files\Microsoft\Exchange Server\V14。如果将 IrmLogPath 参数的值设置为 $null，将有效地禁用 IRM 日志记录。但是，如果将 IrmLogPath 参数的值设置为在 IrmLogEnabled 属性值$true时$null，Exchange 将在应用程序事件日志中记录错误。禁用 IRM 日志记录的首选方法是将 IrmLogEnabled 参数设置为 $false。

Type:	LocalLongFullPath
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MaxCallsAllowed

MaxCallsAllowed 参数指定统一消息服务器允许的最大并发语音呼叫数。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-SIPAccessService

SIPAccessService 参数指定最近的 Lync Server Edge 池的 FQDN 和 TCP 端口或Skype for Business Server Edge 池位置，以便从远程 Lync 或网络外部Skype for Business用户进行入站和出站呼叫。

建议始终在 Lync Server 或跨多个地理区域的Skype for Business Server部署中使用此参数;否则，统一消息服务器可能会选择一个池来Real-Time传输协议 (RTP) 媒体流量，该流量在地理上不是最靠近远程用户的媒体流量。

您为每个统一消息服务器配置此参数，以便该值标识离 Exchange 服务器最近的 Lync Server Edge 池或Skype for Business Server边缘池。

Type:	ProtocolConnectionSettings
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-SipTcpListeningPort

SipTcpListeningPort 参数指定统一消息服务器用于接收传入呼叫的 TCP 端口。此 TCP 端口由添加到未配置为使用 SIP 安全模式或安全模式的 UM 拨号计划的统一消息服务器使用。默认是端口 5060。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-SipTlsListeningPort

SipTlsListeningPort 参数指定统一消息服务器用于接收传入呼叫的传输层安全性 (TLS) 端口。此 TLS 端口由添加到配置为使用 SIP 安全模式或安全模式的 UM 拨号计划的统一消息服务器使用。默认是端口 5061。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Status

Status 参数指定统一消息服务器状态。可用选项包括 Enabled、Disabled 和 NoNewCalls。

Type:	ServerStatus
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-UMStartupMode

UMStartupMode 参数指定统一消息服务器上的Microsoft Exchange 统一消息服务是否以 TCP、TLS 或双模式启动。如果将统一消息服务器添加到具有不同安全设置的 UM 拨号计划，则应选择“双模式”。在双模式下，统一消息服务器可以同时侦听端口 5060 和 5061。如果启动模式已更改，则必须重启Microsoft Exchange 统一消息服务。

Type:	UMStartupMode
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-WhatIf

WhatIf 开关模拟命令操作。可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。不必为此开关指定值。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

输入

Input types

若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。