Get-UMIPGateway

參考

模組:: ExchangePowerShell

適用於:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

內部部署 Exchange 才有提供此 Cmdlet。

使用 Get-UMIPGateway Cmdlet 可傳回指定的整合通訊 (UM) IP 閘道或 UM IP 閘道清單的屬性和值清單。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

Get-UMIPGateway
   [[-Identity] <UMIPGatewayIdParameter>]
   [-DomainController <Fqdn>]
   [-IncludeSimulator]
   [<CommonParameters>]

Description

Get-UMIPGateway Cmdlet 會顯示指定之 UM IP 閘道的屬性和值，例如顯示名稱、IP 位址、狀態和撥出電話設定。如果未指定任何參數，則會傳回 Active Directory 樹系中的所有 UM IP 閘道。

當您使用 Get-UMIPGateway Cmdlet 時，您無法輸入 UM IP 閘道上設定的 IP 位址。您必須使用 UM IP 閘道的名稱。使用 Get-UMIPGateway Cmdlet 的 Identity 參數指定的名稱可以與 UM IP 閘道的主機名稱相同或不同，例如 Get-UMIPGatewayMyUMIPGateway。

完成這項工作之後，您可以檢視特定 UM IP 閘道的屬性和值清單。或者，如果未使用 Identity 參數，Cmdlet 會傳回樹系中所有 UM IP 閘道的清單。

您必須已獲指派權限，才能執行此指令程式。雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

Get-UMIPGateway | Format-List

此範例會顯示 Active Directory 樹系中所有 UM IP 閘道的格式化清單。

範例 2

Get-UMIPGateway -Identity MyUMIPGateway

此範例會顯示 UM IP 閘道 MyUMIPGateway 的屬性。

範例 3

Get-UMIPGateway -IncludeSimulator $true

此範例會顯示所有 UM IP 閘道，包括 Active Directory 樹系中的 IP 閘道模擬器。

參數

-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 2010, Exchange Server 2013, Exchange Server 2016

-Identity

Identity 參數會指定要檢視之 UM IP 閘道的識別碼。此參數是 UM IP 閘道的目錄物件識別碼。

Type:	UMIPGatewayIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-IncludeSimulator

IncludeSimulator 參數會擷取所檢視之 UM IP 閘道的模擬器。您不需要使用此參數指定值。

模擬器允許用戶端連接 Mailbox Server。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

輸入

Input types

若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。

輸出

Output types

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。