Set-UMIPGateway (RTM)
适用于： Exchange Server 2007
上一次修改主题： 2007-07-12
Set-UMIPGateway cmdlet 用于修改单个统一消息 (UM) IP 网关的配置设置，或返回可以为给定 UM IP 网关修改的配置设置列表。
语法
Set-UMIPGateway -Identity <UMIPGatewayIdParameter> [-Address <UMSmartHost>] [-DomainController <Fqdn>] [-Name <String>] [-OutcallsAllowed <$true | $false>] [-Port <Int32>] [-Simulator <$true | $false>] [-Status <Enabled | Disabled | NoNewCalls>]
Set-UMIPGateway [-Address <UMSmartHost>] [-DomainController <Fqdn>] [-Instance <UMIPGateway>] [-Name <String>] [-OutcallsAllowed <$true | $false>] [-Port <Int32>] [-Simulator <$true | $false>] [-Status <Enabled | Disabled | NoNewCalls>]
详细说明
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 地址。 |
DomainController |
可选 |
Microsoft.Exchange.Data.Fqdn |
若要指定将此配置更改写入 Active Directory 目录服务域控制器的完全限定的域名，请在 cmdlet 中包含 DomainController 参数。 |
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 网关。 |
输入类型
返回类型
错误
| 错误 | 说明 |
|---|---|
|
|
异常
| 异常 | 说明 |
|---|---|
|
|
示例
第一个代码示例修改名为 MyUMIPGateway 的 UM IP 网关的 IP 地址。
第二个代码示例阻止 UM IP 网关接受传入呼叫并阻止传出呼叫。
第三个示例使 UM IP 网关充当 IP/VoIP 模拟器。
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