Set-UMCallRouterSettings
此 cmdlet 仅适用于本地 Exchange。
使用 Set-UMCallRouterSettings cmdlet 修改 Microsoft Exchange 统一消息呼叫路由器服务的配置。 此服务存在于安装了客户端访问服务器角色的 Exchange 服务器上,电话客户端使用该服务连接到 Exchange。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Set-UMCallRouterSettings
[[-Server] <ServerIdParameter>]
[-Confirm]
[-DialPlans <MultiValuedProperty>]
[-DomainController <Fqdn>]
[-IPAddressFamily <IPAddressFamily>]
[-IPAddressFamilyConfigurable <Boolean>]
[-MaxCallsAllowed <Int32>]
[-SipTcpListeningPort <Int32>]
[-SipTlsListeningPort <Int32>]
[-UMStartupMode <UMStartupMode>]
[-WhatIf]
[<CommonParameters>]
说明
您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Set-UMCallRouterSettings -DialPlans MySIPDialPlan -IPAddressFamily Any -Server MyUMCallRouter.northwindtraders.com -UMStartupMode TLS
本示例在名为 MyUMCallRouter 的 Exchange 服务器上创建以下配置:
- 将服务器添加到 UM SIP 拨号计划 MySIPDialPlan。
- 启用 Microsoft Exchange 统一消息呼叫路由器服务以接受 IPv4 和 IPv6 数据包。
- 将传入语音、传真、自动助理和 Outlook Voice Access 呼叫的最大数目设置为 150。
- 启用 Microsoft Exchange 统一消息呼叫路由器服务以便使用 TLS 模式启动。
示例 2
Set-UMCallRouterSettings -DialPlans $null -Server UMCallRouter001.contoso.com
此示例从所有 UM SIP 拨号计划中删除名为 UMCallRouter001 的 Exchange 服务器。
参数
-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 参数指定 Microsoft Exchange 统一消息呼叫路由器服务使用的拨号计划。 仅当组织使用 Lync Server 2010、Lync Server 2013 或 Skype for Business Server 2015 时,Exchange 服务器才需要与 UM 拨号计划相关联。 若要从拨号计划中删除 Exchange 服务器,请使用 $null。 默认情况下不分配拨号计划。
若要输入多个值并覆盖任何现有条目,请使用以下语法: 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 |
-IPAddressFamily
IPAddressFamily 参数指定 UM IP 网关是否使用 IPv4 和/或 IPv6 进行通信。 如果设置为 IPv4Only,UM IP 网关只使用 IPv4 进行通信。 如果设置为 IPv6Only,UM IP 网关只使用 IPv6。 如果设置为 Any,则先使用 IPv6,然后在必要时恢复使用 IPv4。 默认值为 Any。
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 |
-MaxCallsAllowed
此参数已被弃用,将不再使用。
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 |
-Server
服务器参数指定要运行此命令的Exchange服务器。 可以使用唯一标识该服务器的任何值。 例如:
- 名称
- FQDN
- 可分辨名称 (DN)
- Exchange 旧版 DN
Exchange 旧版 DN
Type: | ServerIdParameter |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016 |
-SipTcpListeningPort
SipTcpListeningPort 参数指定Microsoft Exchange 统一消息呼叫路由器服务用于接收传入呼叫的 TCP 端口。 当 UM 拨号计划未配置为使用“SIP 安全”或“安全”模式时,将使用 TCP 端口。 默认是端口 5060。
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 |
-SipTlsListeningPort
SipTlsListeningPort 参数指定传输层安全性 (TLS) 端口,Microsoft Exchange 统一消息呼叫路由器服务用于接收传入呼叫。 当 UM 拨号计划配置为使用“SIP 安全”或“安全”模式时,将使用 TLS 端口。 默认是端口 5061。
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 |
-UMStartupMode
UMStartupMode 参数指定Microsoft Exchange 统一消息呼叫路由器服务是在 TCP、TLS 还是双模式下启动。 如果 Exchange 服务器未与任何 UM 拨号计划相关联,或者正在添加到具有不同安全设置的 UM 拨号计划,则应选择“双模式”。 在双模式下,Microsoft服务器可以同时侦听端口 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 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 不返回任何数据。