通过

Set-UMIPGateway

模块:
Exchange PowerShell

此 cmdlet 仅适用于本地 Exchange。

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

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

Default （默认值） 

Set-UMIPGateway
    [-Identity] <UMIPGatewayIdParameter>
    [-Address <UMSmartHost>]
    [-Confirm]
    [-DelayedSourcePartyInfoEnabled <Boolean>]
    [-DomainController <Fqdn>]
    [-ForceUpgrade]
    [-IPAddressFamily <IPAddressFamily>]
    [-MessageWaitingIndicatorAllowed <Boolean>]
    [-Name <String>]
    [-OutcallsAllowed <Boolean>]
    [-Port <Int32>]
    [-Simulator <Boolean>]
    [-Status <GatewayStatus>]
    [-WhatIf]
    [<CommonParameters>]

说明

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

对 UM IP 网关设置的修改可能会中断邮箱服务器与启用 SIP 的 IP PBX 或 IP 网关之间的通信。 对 UM IP 网关的修改只应该由充分了解更改 UM IP 网关配置所带来的影响的管理员执行。

完成此任务之后，即会为 UM IP 网关配置指定的参数和值。

您必须先获得权限，然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数，但如果某些参数未包含在分配给你的权限中，则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

Set-UMIPGateway -Identity MyUMIPGateway -Address 10.10.10.1

此示例修改名为 UM IP 网关 MyUMIPGateway 的 IP 地址。

示例 2

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

此示例禁止 UM IP 网关接受传入呼叫并禁止传出呼叫。

示例 3

Set-UMIPGateway -Identity MyUMIPGateway -Address fe80::39bd:88f7:6969:d223%11 -IPAddressFamily Any -Status Disabled -OutcallsAllowed $false

该示例可防止 UM IP 网关 MyUMIPGateway 接受传入呼叫和传出呼叫，可设置 IPv6 地址，并允许 UM IP 网关使用 IPv4 和 IPV6 地址。

示例 4

Set-UMIPGateway -Identity MyUMIPGateway -Simulator $true

此示例使 UM IP 网关可以充当 IP 网关模拟器并使其可与 Test-UMConnectivity cmdlet 一起使用。

参数

-Address

适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016

Address 参数指定在 UM IP 网关或启用 SIP 的 IP PBX 上配置的 IP 地址或完全限定域名 (FQDN)。 如果与 UM IP 网关相关联的 UM 拨号计划运行在“安全 SIP”或“安全”模式下，则必须使用 FQDN。 如果使用 FQDN，请验证是否正确配置了域名系统 (DNS) 。

参数属性

类型:UMSmartHost
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Confirm

适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016

Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

  • 破坏性 cmdlet（例如 Remove-* cmdlets）内置有暂停，可强制要求先确认命令，然后再继续操作。 对于这些 cmdlet，您可以使用此确切语法跳过确认提示：-Confirm:$false。
  • 其他大多数 cmdlet（例如 New-* 和 Set-* cmdlet）都没有内置暂停。 对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-DelayedSourcePartyInfoEnabled

适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016

DelayedSourcePartyInfoEnabled 参数指定如果呼叫相应的 SIP INVITE 不包含呼叫方和转换信息，统一消息是否应延迟接受来自语音 IP (VoIP) 网关的入站呼叫。

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-DomainController

适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如，dc01.contoso.com。

参数属性

类型:Fqdn
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ForceUpgrade

适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016

ForceUpgrade 开关禁止在 Exchange 的早期版本中创建对象时出现的确认消息。 不必为此开关指定值。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Identity

适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016

Identity 参数指定要修改的 UM IP 网关的标识符。 此参数是 UM IP 网关的目录对象 ID。

参数属性

类型:UMIPGatewayIdParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:1
必需:True
来自管道的值:True
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-IPAddressFamily

适用：2013 Exchange Server、Exchange Server 2016

IPAddressFamily 参数指定要使用的 Internet 协议 (IP) 版本。 有效值包含:

  • IPv4Only：UM IP 网关仅使用 IPv4 进行通信。 此值为默认值。
  • IPv6Only：UM IP 网关仅使用 IPv6。
  • 任何：首先使用 IPv6。 如果 IPv6 不可用，则使用 IPV4。

参数属性

类型:IPAddressFamily
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-MessageWaitingIndicatorAllowed

适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016

MessageWaitingIndicatorAllowed 参数指定是否要让 UM IP 网关能够允许向与 UM 拨号计划和 UM IP 网关相关联的用户发送 SIP 通知消息。 默认值为 $true。

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Name

适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016

Name 参数指定 UM IP 网关的显示名称。 此显示名限制为 64 个字符。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-OutcallsAllowed

适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016

OutcallsAllowed 参数指定是否允许将此 UM IP 网关用于传出呼叫。 此参数并不控制呼叫转移。

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Port

适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016

Port 参数指定 IP 网关或 IP PBX 侦听的 IP 端口。 默认情况下，该端口为 5060。 此参数的范围是 0 至 65535。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Simulator

适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016

Simulator 参数指定正在查看的 UM IP 网关所使用的模拟器。 模拟器允许客户端连接到邮箱服务器。

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Status

适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016

Status 参数指定启用还是禁用 UM IP 网关。 有效值包含:

  • 已启用
  • Disabled
  • NoNewCalls

参数属性

类型:GatewayStatus
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-WhatIf

适用：2010 Exchange Server、Exchange Server 2013、Exchange Server 2016

WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

输入

Input types

若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。