Set-UMIPGateway

 

适用于： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上一次修改主题： 2007-07-17

Set-UMIPGateway cmdlet 用于修改单个统一消息 (UM) IP 网关的配置设置，或返回可以为给定 UM IP 网关修改的配置设置列表。

语法

Set-UMIPGateway -Identity <UMIPGatewayIdParameter> [-Address <UMSmartHost>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Name <String>] [-OutcallsAllowed <$true | $false>] [-Port <Int32>] [-Simulator <$true | $false>] [-Status <Enabled | Disabled | NoNewCalls>] [-WhatIf [<SwitchParameter>]]

Set-UMIPGateway [-Address <UMSmartHost>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Instance <UMIPGateway>] [-Name <String>] [-OutcallsAllowed <$true | $false>] [-Port <Int32>] [-Simulator <$true | $false>] [-Status <Enabled | Disabled | NoNewCalls>] [-WhatIf [<SwitchParameter>]]

详细说明

Set-UMIPGateway cmdlet 修改给定 UM IP 网关的配置设置，例如，IP 网关的 IP 地址。这些修改包括允许传出呼叫以及控制与已启用会话初始协议 (SIP) 的 IP PBX 网关或 IP 网关的通信。

要点：
对 UM IP 网关设置的修改可能干扰统一消息服务器与启用 SIP 的 IP/PBX 或 IP 网关之间的通信。对 UM IP 网关对象的修改只应该由充分了解更改 UM IP 网关配置的含义的管理员执行。

若要运行 Set-UMIPGateway cmdlet，必须为您使用的帐户委派 Exchange 组织管理员角色。

有关管理 Microsoft Exchange Server 2007 所需的权限、角色委派以及权利的详细信息，请参阅权限注意事项。

参数

参数	必需	类型	说明
Identity	必需	Microsoft.Exchange.Configuration.Tasks.UMIPGatewayIdParameter	此参数指定所修改的 UM IP 网关的标识符。此参数是 UM IP 网关的目录对象 ID。
Address	可选	Microsoft.Exchange.Data.UMSmartHost	此参数指定在 IP 网关或启用 SIP 的 IP/专用交换机 (PBX) 上配置的 IP 地址。
Confirm	可选	System.Management.Automation.SwitchParameter	此参数将导致命令暂停处理，并且需要管理员在继续处理之前确认该命令将执行的操作。默认值为 $true。
DomainController	可选	Microsoft.Exchange.Data.Fqdn	此参数指定将此配置更改写入 Active Directory 目录服务域控制器的完全限定的域名 (FQDN)。
Instance	可选	Microsoft.Exchange.Data.Directory.SystemConfiguration.UMIPGateway	此参数指定代表新 IP 网关的输入参数。
Name	可选	System.String	此参数指定将用于 UM IP 网关的显示名。此显示名限制为 64 个字符。
OutcallsAllowed	可选	System.Boolean	此参数指定该 IP 网关对象是否可以用于传出呼叫。这不能决定呼叫转移。
Port	可选	System.Int32	此参数指定 IP 网关或 IP PBX 侦听的 IP 端口。默认情况下，该端口为 5060。此参数的范围是 0 至 65535。
Simulator	可选	System.Boolean	此参数指定将要用于正在查看的 UM IP 网关的模拟器。模拟器允许客户端连接到统一消息服务器。此连接通常用于 Exchange 测试电话应用程序。
Status	可选	Microsoft.Exchange.Data.Directory.SystemConfiguration.GatewayStatus	此参数指定是否启用 UM IP 网关。
WhatIf	可选	System.Management.Automation.SwitchParameter	此参数指示命令模拟针对对象执行的操作。通过使用 WhatIf 参数，管理员可以查看要发生的更改，而不必应用任何这些更改。默认值为 $true。

输入类型

返回类型

错误

错误	说明

异常

异常	说明

示例

第一个代码示例修改名为 MyUMIPGateway 的 UM IP 网关的 IP 地址。

第二个代码示例阻止 UM IP 网关接受传入呼叫并阻止传出呼叫。

第三个示例使 UM IP 网关可以充当 IP 网关模拟器并使其可以与 Test-UMConnectivity cmdlet 或 Exchange UM 测试电话应用程序一起使用。

Set-UMIPGateway -Identity MyUMIPGateway -Address 10.10.10.1

Set-UMIPGateway -Identity MyUMIPGateway -Address 10.10.10.1 -Status 2 -OutcallsAllowed $false

Set-UMIPGateway -Identity MyUMIPGateway -Simulator $true