Set-UMServer
此 cmdlet 仅在 2010 Exchange Server可用。
使用 Set-UMServer cmdlet 修改与统一消息 (UM) 服务器角色关联的设置。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Default （默认值）
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
适用：Exchange Server 2010
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。
- 破坏性 cmdlet（例如 Remove-* cmdlets）内置有暂停，可强制要求先确认命令，然后再继续操作。 对于这些 cmdlet，您可以使用此确切语法跳过确认提示：
-Confirm:$false。 - 其他大多数 cmdlet（例如 New-* 和 Set-* cmdlet）都没有内置暂停。 对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DialPlans
适用：Exchange Server 2010
DialPlans 参数指定服务器处理 UM 呼叫的拨号计划。 可以指定用逗号分隔的多个值。
如果未指定拨号计划，统一消息服务器不会处理 UM 呼叫。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DomainController
适用：Exchange Server 2010
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如，dc01.contoso.com。
参数属性
| 类型: | Fqdn |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ExternalServiceFqdn
适用：Exchange Server 2010
ExternalServiceFqdn 参数是为统一消息服务器提供服务的负载均衡器的 FQDN 或主机名。 将统一消息服务器从组织内部迁移到 Microsoft Exchange Server 2010 托管环境时，此参数非常有用。 外部服务主机 FQDN 最多可以包含 2,048 个字符。
参数属性
| 类型: | UMSmartHost |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-GrammarGenerationSchedule
适用：Exchange Server 2010
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.)
参数属性
| 类型: | ScheduleInterval[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Identity
适用：Exchange Server 2010
Identity 参数指定要修改的统一消息服务器。 可以使用唯一标识该服务器的任何值。 例如：
- 名称
- GUID
- 可分辨名称 (DN)
- ExchangeLegacyDN
参数属性
| 类型: | UMServerIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-IrmLogEnabled
适用：Exchange Server 2010
IrmLogEnabled 参数指定是否启用信息权限管理 (IRM) 事务的日志记录。 默认情况下会启用 IRM 日志记录。 值包括：
- $true启用 IRM 日志记录
- $false禁用 IRM 日志记录
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-IrmLogMaxAge
适用：Exchange Server 2010
IrmLogMaxAge 参数指定 IRM 日志文件的最长期限。 早于指定值的日志文件将被删除。 默认值为 30 天。 若要指定值，请输入时间跨度值：dd.hh：mm：ss，其中 d = 天，h = 小时，m = 分钟，s = 秒。 此参数的有效输入范围是 00:00:00 到 24855.03:14:07。 将 IrmLogMaxAge 参数的值设置为 00:00:00，可以防止由于期限问题而自动删除 IRM 日志文件。
参数属性
| 类型: | EnhancedTimeSpan |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-IrmLogMaxDirectorySize
适用：Exchange Server 2010
IrmLogMaxDirectorySize 参数指定连接日志目录中的所有 IRM 日志的最大大小。 当目录达到其最大文件大小时，服务器会首先删除最早的日志文件。 默认值为 250 MB。 有效值是一个数字，最大可为 1.999999999 TB（即 2199023254528 B）或值 unlimited。默认值为 6 GB（即 6442450944 B）。
- B（字节）
- KB（千字节）
- MB（兆字节）
- GB（千兆字节）
- TB（兆兆字节）
未限定的值被视为以字节为单位。 IrmLogMaxFileSize 参数的值必须小于或等于 IrmLogMaxDirectorySize 参数的值。 这两个参数的有效输入范围都是从 1 到 9223372036854775807 字节。 如果输入值 unlimited，则对连接日志目录没有大小限制。
参数属性
| 类型: | Unlimited |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-IrmLogMaxFileSize
适用：Exchange Server 2010
IrmLogMaxFileSize 参数指定每个 IRM 日志文件的最大大小。 当日志文件达到其最大文件大小时，将创建新的日志文件。 默认值为 10 MB。 有效值是一个数字，最大可为 1.999999999 TB（即 2199023254528 B）或值 unlimited。默认值为 6 GB（即 6442450944 B）。
- B（字节）
- KB（千字节）
- MB（兆字节）
- GB（千兆字节）
- TB（兆兆字节）
未限定的值被视为以字节为单位。 IrmLogMaxFileSize 参数的值必须小于或等于 IrmLogMaxDirectorySize 参数的值。 这两个参数的有效输入范围都是从 1 到 9223372036854775807 字节。 如果输入值 unlimited，则对 IRM 日志文件没有大小限制。
参数属性
| 类型: | ByteQuantifiedSize |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-IrmLogPath
适用：Exchange Server 2010
IrmLogPath 参数指定默认的 IRM 日志目录位置。 默认值为 %ExchangeInstallPath%IRMLogs。
如果将此参数值设置为 $null，将有效地禁用 IRM 日志记录。 但是，如果 IrmLogEnabled 参数的值$true，则 Exchange 会将错误添加到应用程序事件日志。 禁用 IRM 日志记录的首选方法是将 IrmLogEnabled 参数设置为 $false。
参数属性
| 类型: | LocalLongFullPath |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-MaxCallsAllowed
适用：Exchange Server 2010
MaxCallsAllowed 参数指定统一消息服务器允许的最大并发语音呼叫数。
参数属性
| 类型: | Int32 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SIPAccessService
适用：Exchange Server 2010
SIPAccessService 参数指定最近的 Lync Server Edge 池或Skype for Business Server Edge 池位置的 FQDN 和 TCP 端口，以便从远程 Lync 或网络外部Skype for Business用户进行入站和出站呼叫。
建议始终在 Lync Server 或跨多个地理区域的Skype for Business Server部署中使用此参数;否则，统一消息服务器可能会选择一个池来 Real-Time 传输协议 (RTP) 媒体流量，该流量在地理上不是最靠近远程用户的媒体流量。
您为每个统一消息服务器配置此参数，以便该值标识离 Exchange 服务器最近的 Lync Server Edge 池或Skype for Business Server边缘池。
参数属性
| 类型: | ProtocolConnectionSettings |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SipTcpListeningPort
适用：Exchange Server 2010
SipTcpListeningPort 参数指定统一消息服务器用于接收传入呼叫的 TCP 端口。 此 TCP 端口由添加到未配置为使用 SIP 安全模式或安全模式的 UM 拨号计划的统一消息服务器使用。 默认是端口 5060。
参数属性
| 类型: | Int32 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SipTlsListeningPort
适用：Exchange Server 2010
SipTlsListeningPort 参数指定统一消息服务器用于接收传入呼叫的传输层安全性 (TLS) 端口。 此 TLS 端口由添加到配置为使用 SIP 安全模式或安全模式的 UM 拨号计划的统一消息服务器使用。 默认是端口 5061。
参数属性
| 类型: | Int32 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Status
适用：Exchange Server 2010
Status 参数指定统一消息服务器状态。 可用选项包括 Enabled、Disabled 和 NoNewCalls。
参数属性
| 类型: | ServerStatus |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-UMStartupMode
适用：Exchange Server 2010
UMStartupMode 参数指定 Exchange 服务器上Microsoft Exchange 统一消息服务的启动模式。 有效值包含:
- TCP
- TLS
- 双：使用此值将统一消息服务器添加到具有不同安全设置的 UM 拨号计划。 统一消息服务器可以同时侦听端口 5060 和 5061。
如果更改启动模式，则需要重启 Microsoft Exchange 统一消息服务。
参数属性
| 类型: | UMStartupMode |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WhatIf
适用：Exchange Server 2010
WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
输入
Input types
若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。