Set-UMService
此 cmdlet 仅适用于本地 Exchange。
使用 Set-UMService cmdlet 修改 Exchange 2013 或 Exchange 2016 邮箱服务器上的 Microsoft Exchange 统一消息服务的属性。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Set-UMService
[-Identity] <UMServerIdParameter>
[-Confirm]
[-DialPlans <MultiValuedProperty>]
[-DomainController <Fqdn>]
[-GrammarGenerationSchedule <ScheduleInterval[]>]
[-IPAddressFamily <IPAddressFamily>]
[-IPAddressFamilyConfigurable <Boolean>]
[-IrmLogEnabled <Boolean>]
[-IrmLogMaxAge <EnhancedTimeSpan>]
[-IrmLogMaxDirectorySize <Unlimited>]
[-IrmLogMaxFileSize <ByteQuantifiedSize>]
[-IrmLogPath <LocalLongFullPath>]
[-MaxCallsAllowed <Int32>]
[-SIPAccessService <ProtocolConnectionSettings>]
[-Status <ServerStatus>]
[-UMStartupMode <UMStartupMode>]
[-WhatIf]
[<CommonParameters>]
说明
您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Set-UMService -Identity MyUMServer -IPAddressFamily Any -UMStartupMode Dual
本示例执行以下操作:
- 在邮箱服务器 MyUMServer 上启用 Microsoft Exchange 统一消息服务以接受 IPv4 和 IPv6 数据包。
- 在邮箱服务器 MyUMServer 上启用 Microsoft Exchange 统一消息服务以便使用 TCP 和 TLS 模式启动。
示例 2
Set-UMService -Identity MyUMServer -DialPlans $null
此示例从所有 UM 拨号计划中删除了邮箱服务器 MyUMServer。
示例 3
Set-UMService -Identity MyUMServer -DialPlans MySIPDialPlan -MaxCallsAllowed 50 -SipAccessService northamerica.lyncpoolna.contoso.com:5061 -UMStartupMode TLS
本示例执行以下操作:
- 将邮箱服务器 MyUMServer 添加到 UM 拨号计划 MySIPDialPlan。
- 将最大传入呼叫数设置为 50。
- 将 northamerica.lyncpoolna.contoso.com:5061 设置为 SIP 访问服务的 FQDN 和端口,Microsoft Lync Server 或 Skype for Business Server用于从远程 Lync 或 Skype for Business 客户端进行入站和出站呼叫。
- 在邮箱服务器 MyUMServer 上启用 Microsoft Exchange 统一消息服务以便使用 TLS 模式启动。
参数
-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 2013, Exchange Server 2016 |
-DialPlans
DialPlans 参数指定统一消息服务处理传入呼叫的所有拨号计划。
Exchange 2016 和 Exchange 2013 服务器不能与 TelExt 或 E.164 UM 拨号计划相关联,但可以关联或添加到 SIP 拨号计划。 如果要将统一消息与 Lync Server 2010、Lync Server 2013 或 Skype for Business Server 2015 集成,则需要将所有 Exchange 2016 和 Exchange 2013 服务器关联或添加到 SIP 拨号计划。
还可以使用此参数将 Exchange 2010 统一消息服务器关联到 UM 拨号计划。
若要输入多个值并覆盖任何现有条目,请使用以下语法: Value1,Value2,...ValueN
。 如果值包含空格或需要引号,请使用以下语法: "Value1","Value2",..."ValueN"
。
若要在不影响任何现有条目的情况下添加或删除一个或多个值,请使用以下语法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016 |
-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 2013, Exchange Server 2016 |
-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 2013, Exchange Server 2016 |
-Identity
Identity 参数指定托管要修改的统一消息服务配置的邮箱服务器。 可以使用唯一标识该服务器的任何值。 例如:
- 名称
- 可分辨名称 (DN)
- ExchangeLegacyDN
- GUID
Type: | UMServerIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016 |
-IPAddressFamily
IPAddressFamily 参数指定 UM IP 网关是否使用 IPv4 和/或 IPv6 进行通信。 有效值包含:
- IPv4
- IPv6
- 任何:首先使用 IPv6,如有必要,UM IP 网关回退到 IPv4。 此值为默认值。
Type: | IPAddressFamily |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016 |
-IPAddressFamilyConfigurable
IPAddressFamilyConfigurable 参数指定您是否能够设置 IPAddressFamily 参数为 IPv6Only 或 Any。 默认值为 True。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016 |
-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 2013, Exchange Server 2016 |
-IrmLogMaxAge
IrmLogMaxAge 参数指定 IRM 日志文件的最长期限。 早于指定值的日志文件将被删除。 默认值为 30 天。
若要指定值,请以时间跨度格式 dd.hh:mm:ss 输入值(其中 dd = 天,hh = 小时,mm = 分钟,ss = 秒)。
此参数的有效输入范围是 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 2013, Exchange Server 2016 |
-IrmLogMaxDirectorySize
IrmLogMaxDirectorySize 参数指定连接日志目录中的所有 IRM 日志的最大大小。 当目录达到其最大文件大小时,服务器会首先删除最早的日志文件。 默认值为 250 MB。
有效值是一个数字,最大可为 1.999999999 TB(即 2199023254528 B)或值 unlimited。默认值为 6 GB(即 6442450944 B)。
- B(字节)
- KB(千字节)
- MB(兆字节)
- GB(千兆字节)
- TB (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 2013, Exchange Server 2016 |
-IrmLogMaxFileSize
IrmLogMaxFileSize 参数指定每个 IRM 日志文件的最大大小。 当日志文件达到其最大文件大小时,将创建新的日志文件。 默认值为 10 MB。
有效值是一个数字,最大可为 1.999999999 TB(即 2199023254528 B)或值 unlimited。默认值为 6 GB(即 6442450944 B)。
- B(字节)
- KB(千字节)
- MB(兆字节)
- GB(千兆字节)
- TB (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 2013, Exchange Server 2016 |
-IrmLogPath
IrmLogPath 参数指定默认的 IRM 日志目录位置。 默认位置为 %ExchangeInstallPath%IRMLogs。
如果将此参数值设置为 $null,将有效地禁用 IRM 日志记录。 但是,当 IrmLogEnabled 参数的值$true时,将此参数设置为$null,则会在应用程序事件日志中生成错误。 禁用 IRM 日志记录的首选方法是将 IrmLogEnabled 参数设置为 $false。
Type: | LocalLongFullPath |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016 |
-MaxCallsAllowed
MaxCallsAllowed 参数指定统一消息服务允许的最大并发语音呼叫数。 默认值为 100。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016 |
-SIPAccessService
SIPAccessService 参数指定最近的 Lync Server 前端池的 FQDN 和 TCP 端口,或者Skype for Business Server前端池位置,以便从远程 Lync 或网络外部Skype for Business用户进行入站和出站呼叫。
建议始终在 Lync Server 或跨多个地理区域的Skype for Business Server部署中使用此参数;否则,Microsoft Exchange 统一消息服务可能会为Real-Time传输协议选择一个池, (RTP) 不是最接近远程用户的媒体流量。
为统一消息服务的每个实例配置此参数, (每个 Exchange 服务器) 以便该值标识离 Exchange 服务器最近的 Lync Server 前端池或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 2013, Exchange Server 2016 |
-Status
此参数已被弃用,将不再使用。
Type: | ServerStatus |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016 |
-UMStartupMode
UMStartupMode 参数指定统一消息服务的启动模式。 有效值包含:
- TCP (这是默认值)
- TLS
- 双重:服务可以同时侦听端口 5060 和 5061。 如果将 Exchange 服务器添加到具有不同安全设置的 UM 拨号计划,则应使用此值。
如果更改此参数的值,您需要重启统一消息服务。
Type: | UMStartupMode |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016 |
-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 2013, Exchange Server 2016 |
输入
Input types
若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。