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 网关的通信。
.gif "important") 要点： |
|---|
| 对 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