Get-OutboundConnector
此指令程式只能在雲端式服務中使用。
使用 Get-OutboundConnector Cmdlet 來檢視雲端式組織中輸出連接器的設定資訊。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
Syntax
Get-OutboundConnector
[[-Identity] <OutboundConnectorIdParameter>]
[-IncludeTestModeConnectors <Boolean>]
[-IsTransportRuleScoped <Boolean>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Description
輸出連接器將電子郵件傳送至需要特定組態選項的遠端網域。
您必須已獲指派權限,才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數,不過,如果某些參數並未包含在指派給您的權限中,您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Get-OutboundConnector "Contoso Outbound Connector" | Format-List
此範例會顯示名為 Contoso Outbound Connector 之輸出連接器的詳細資訊。
參數
-Identity
Identity 參數會指定您想要檢視的輸出連接器。 您可以使用唯一識別連接器的任何值。 例如:
- 名稱
- 辨別名稱 (DN)
- GUID
Type: | OutboundConnectorIdParameter |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-IncludeTestModeConnectors
IncludeTestModeConnectors 參數會依處於測試模式的輸出連接器篩選結果。 有效值為:
- $true:結果中只會傳回處於測試模式的輸出連接器。
- $false:不在測試模式中的所有輸出連接器都會在結果中傳回。 這是預設值。
您可以使用 New-OutboundConnector 或 Set-OutboundConnector Cmdlet 上的 TestMode 參數,在測試模式中設定輸出連接器。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-IsTransportRuleScoped
IsTransportRuleScoped 參數會依輸出連接器篩選結果,這些連接器的範圍為傳輸規則 (也稱為郵件流程規則) 。 有效值為:
- $true:結果中只會傳回範圍為傳輸規則的輸出連接器。
- $false:所有未限定傳輸規則範圍的輸出連接器都會在結果中傳回。 這是預設值。
您可以在 New-TransportRule 或 Set-TransportRule Cmdlet 上使用 RouteMessageOutboundConnector 參數,將傳輸規則的範圍設定為特定的輸出連接器。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-ResultSize
ResultSize 參數會指定傳回的結果筆數上限。 若要傳回符合查詢的所有要求,請使用 unlimited 作為此參數的值。 預設值為 1000。
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
輸入
Input types
若要查看此指令程式可接受的輸入類型,請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的,表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。