Get-OutboundConnector
此指令程式只能在雲端式服務中使用。
使用 Get-OutboundConnector cmdlet 查看雲端組織中外撥連接器的設定資訊。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
Get-OutboundConnector
[[-Identity] <OutboundConnectorIdParameter>]
[-IncludeTestModeConnectors <Boolean>]
[-IsTransportRuleScoped <Boolean>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Description
輸出連接器將電子郵件傳送至需要特定組態選項的遠端網域。
您必須已獲指派權限,才能執行此指令程式。 雖然這篇文章列出了 cmdlet 的所有參數,但如果某些參數未包含在你分配的權限中,你可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Get-OutboundConnector "Contoso Outbound Connector" | Format-List
此範例展示了名為 Contoso 外接連接器的詳細資訊。
參數
-Identity
適用:Exchange Online,內建本地信箱安全外掛
Identity 參數指定你想查看的 Outbound 連接器。 您可以使用唯一識別連接器的任何值。 例如:
- 名稱
- 辨別名稱 (DN)
- GUID
注意:Identity 參數的值$null或不存在的值,會回傳 所有 物件,就像你執行 Get- 指令時沒有 Identity 參數一樣。 請確認 Identity 參數的值清單是否準確,且不包含不存在的 $null 值。
參數屬性
| 類型: | OutboundConnectorIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-IncludeTestModeConnectors
適用:Exchange Online,內建本地信箱安全外掛
IncludeTestModeConnectors 參數會依照處於測試模式的外站連接器來篩選結果。 有效值為:
- $true:結果中僅返回處於測試模式的出站連接器。
- $false:所有未進入測試模式的出站連接器都會在結果中回傳。 這個值是預設值。
你可以在測試模式下使用 New-OutboundConnector 或 Set-OutboundConnector 指令碼上的 TestMode 參數來設定 Outbound 連接器。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-IsTransportRuleScoped
適用:Exchange Online,內建本地信箱安全外掛
IsTransportRuleScoped 參數會依照輸出連接器過濾結果,這些連接器的作用範圍為傳輸規則 (,也稱為郵件流規則) 。 有效值為:
- $true:結果中僅回傳符合傳輸規則範圍的出站連接器。
- $false:所有未被規範為傳輸規則的出站連接器都會在結果中回傳。 這個值是預設值。
你可以透過 New-TransportRule 或 Set-TransportRule cmdlet 上的 RouteMessageOutboundConnector 參數,將傳輸規則範圍設定到特定的 Outbound 連接器。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ResultSize
適用:Exchange Online,內建本地信箱安全外掛
ResultSize 參數會指定傳回的結果筆數上限。 若要傳回符合查詢的所有要求,請使用 unlimited 作為此參數的值。 預設值為 1000。
參數屬性
| 類型: | Unlimited |
| 預設值: | 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
若要查看此指令程式可接受的輸入類型,請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的,表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。