Set-InboundConnector
此指令程式只能在雲端式服務中使用。
使用 Set-InboundConnector 指令程式以變更基於雲端組織的現有輸入連接器。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
Syntax
Set-InboundConnector
[-Identity] <InboundConnectorIdParameter>
[-AssociatedAcceptedDomains <MultiValuedProperty>]
[-CloudServicesMailEnabled <Boolean>]
[-Comment <String>]
[-Confirm]
[-ConnectorSource <TenantConnectorSource>]
[-ConnectorType <TenantConnectorType>]
[-EFSkipIPs <MultiValuedProperty>]
[-EFSkipLastIP <Boolean>]
[-EFSkipMailGateway <MultiValuedProperty>]
[-EFTestMode <Boolean>]
[-EFUsers <MultiValuedProperty>]
[-Enabled <Boolean>]
[-Name <String>]
[-RequireTls <Boolean>]
[-RestrictDomainsToCertificate <Boolean>]
[-RestrictDomainsToIPAddresses <Boolean>]
[-ScanAndDropRecipients <MultiValuedProperty>]
[-SenderDomains <MultiValuedProperty>]
[-SenderIPAddresses <MultiValuedProperty>]
[-TlsSenderCertificateName <TlsCertificate>]
[-TreatMessagesAsInternal <Boolean>]
[-TrustedOrganizations <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>] Description
輸入傳輸器接受來自需要特定設定選項的遠端網域的電子郵件訊息。
您必須已獲指派權限，才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Set-InboundConnector "Contoso Inbound Connector" -RequireTls $true -TlsSenderCertificateName contoso.com本範例進行下列設定變更至名為 Contoso.com 輸入連接器的現有連接器。
在連接器上的所有接收郵件需要 TLS 傳輸。
需要用於加密包含網域名成稱為 contoso.com 通訊 的TLS 憑證
參數
-AssociatedAcceptedDomains
AssociatedAcceptedDomains 參數會將使用連接器的來源網域限制為指定的已接受網域。 有效的值是已在 Microsoft 365 組織中設定為可接受網域的 SMTP 網域。
您可以指定多個以逗號分隔的值。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-CloudServicesMailEnabled
注意：建議您不要使用此參數，除非 Microsoft 客戶服務及支援服務或特定產品檔會指示您這麼做。 請改用混合式設定精靈來設定內部部署與雲端組織之間的郵件流程。 如需詳細資訊，請參閱 混合組態精靈。
CloudServicesMailEnabled 參數會指定連接器是否用於內部部署 Exchange 環境與 Microsoft 365 之間的混合式郵件流程。 具體而言，此參數會控制在內部部署和雲端組織中接受的網域之間傳送的訊息中，如何處理某些內部 X-MS-Exchange-Organization-* 訊息標頭。 這些標頭統稱為跨單位標頭。
有效值為：
- $true：連接器用於混合式組織中的郵件流程，因此跨單位標頭會在透過連接器流動的郵件中保留或升級。 這是混合式組態精靈所建立之連接器的預設值。 從混合式組織一端傳送到另一端的輸出訊息中，某些 X-MS-Exchange-Organization-* 標頭會轉換成 X-MS-Exchange-CrossPremises-* 標頭，因此會保留在訊息中。 混合式組織一端收到的輸入訊息中的 X-MS-Exchange-CrossPremises-* 標頭會升級為 X-MS-Exchange-Organization-* 標頭。 這些升級的標頭會取代訊息中已存在之相同 X-MS-Exchange-Organization-* 標頭的任何實例。
- $false：連接器不會用於混合式組織中的郵件流程，因此會從透過連接器流動的訊息中移除任何跨單位標頭。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Comment
Comment 參數會指定選擇性註解。 如果指定的值含有空格，則必須以雙引號 (") 括住值，例如︰"This is an admin note"。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Confirm
Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。
- 例如，具破壞性的 Cmdlet (例如 Remove-* Cmdlet) 內建暫停，可強制您在繼續之前確認命令。 對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：
-Confirm:$false。 - 其他大部分的 Cmdlet (例如，New-* 和 Set-* Cmdlet) 沒有內建暫停。 在使用這些 Cmdlet 時，指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-ConnectorSource
ConnectorSource 參數會指定連接器的建立方式。 此參數的有效輸入包括下列值：
- 預設值：手動建立連接器。 這是預設值。
- HybridWizard：混合式設定精靈會自動建立連接器。
- 已移轉：連接器最初是在 Microsoft Forefront Online Protection for Exchange 中建立。
建議您不要變更此值。
| Type: | TenantConnectorSource |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-ConnectorType
ConnectorType 參數為由連接器服務的網域指定類別。 此參數的有效輸入包括下列值：
- 合作夥伴：您組織外部的連接器服務網域。
- OnPremises：連接器服務內部部署組織所使用的網域。 針對雲端式組織中也由 SenderDomains 參數指定的已接受網域使用此值。
| Type: | TenantConnectorType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EFSkipIPs
EFSkipIPs 參數會指定當 EFSkipLastIP 參數值$false時，要在增強的連接器篩選中略過的來源 IP 位址。 有效值為：
- 單一 IP 位址：例如 192.168.1.1。
- IP 位址範圍：例如，192.168.0.1-192.168.0.254。
- 無類別網域路由 (CIDR) IP 位址範圍：例如 192.168.3.1/24。
您可以指定多個以逗號分隔的值。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EFSkipLastIP
EFSkipIPs 參數會指定連接器的增強篩選行為。 有效值為：
- $true：只略過最後一個訊息來源。
- $false：略過 EFSkipIPs 參數所指定的來源 IP 位址。 如果未指定任何 IP 位址，連接器上會停用連接器的增強式篩選。 這是預設值。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EFSkipMailGateway
將保留此參數供 Microsoft 內部使用。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EFTestMode
將保留此參數供 Microsoft 內部使用。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EFUsers
EFUsers 參數會指定適用于連接器的增強篩選套用的收件者。 預設值為空白 ($null) ，這表示連接器的增強篩選會套用至所有收件者。
您可以指定多個以逗號隔開的收件者電子郵件地址。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Enabled
Enabled 參數會啟用或停用連接器。 有效值為：
- $true：已啟用連接器。 這是預設值。
- $false：連接器已停用。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Identity
Identity 參數會指定您要變更的輸入連接器。
| Type: | InboundConnectorIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Name
Name 參數會指定連接器的描述性名稱。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-RequireTls
RequireTLS 參數會指定是否要求連接器接收的所有訊息進行 TLS 傳輸。 有效值為：
- $true：如果訊息不是透過 TLS 傳送，則拒絕訊息。 此為預設值。
- $false：如果訊息不是透過 TLS 傳送，則允許訊息。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-RestrictDomainsToCertificate
RestrictDomainsToCertificate 參數會指定是否在訊息可以使用連接器之前檢查 TLS 憑證的 Subject 值。 有效值為：
- $true：只有當來源電子郵件伺服器用來驗證之 TLS 憑證的 Subject 值符合 TlsSenderCertificateName 參數值時，才允許郵件使用連接器。
- $false：來源電子郵件伺服器用來驗證之 TLS 憑證的 Subject 值無法控制來自該來源的郵件是否使用連接器。 這是預設值。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-RestrictDomainsToIPAddresses
RestrictDomainsToIPAddresses 參數會指定是否拒絕來自未知來源 IP 位址的郵件。 有效值為：
- $true：如果 SenderIPAddress 參數也未指定來源 IP 位址，則自動拒絕 SenderDomains 參數所指定網域的郵件。
- $false：請勿根據來源 IP 位址自動拒絕 SenderDomains 參數所指定網域的郵件。 這是預設值。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-ScanAndDropRecipients
將保留此參數供 Microsoft 內部使用。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-SenderDomains
SenderDomains 參數會指定連接器接受訊息的來源網域。 有效的值是 SMTP 網域。 支援使用萬用字元來表示網域和所有子域 (例如 *.contoso.com) ，但您無法內嵌萬用字元 (例如 domain.*.contoso.com 無效) 。
您可以指定多個以逗號分隔的網域。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-SenderIPAddresses
SenderIPAddresses 參數會指定此連接器接受訊息的遠端 IPV4 IP 位址。 不支援 IPv6 位址。 有效值為：
- 單一 IP 位址：例如 192.168.1.1。
- 無類別網域路由 (CIDR) IP 位址範圍：例如 192.168.0.1/25。 有效的子網路遮罩值是 /24 到 /32。
您可以指定多個以逗號分隔的值。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-TlsSenderCertificateName
TlsSenderCertificateName 參數會指定當 $true RequireTls 參數的值時所使用的 TLS 憑證。 有效的值是 SMTP 網域。 支援使用萬用字元來表示網域和所有子域 (例如 *.contoso.com) ，但您無法內嵌萬用字元 (例如 domain.*.contoso.com 無效) 。
| Type: | TlsCertificate |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-TreatMessagesAsInternal
TreatMessagesAsInternal 參數會指定替代方法，將從內部部署組織傳送的訊息識別為內部訊息。 只有在內部部署組織未使用 Exchange 時，才應該考慮使用此參數。 有效值為：
- $true：如果寄件者的網域符合 Microsoft 365 中設定的網域，則會將訊息視為內部訊息。 此設定允許 Microsoft 365 與未安裝 Exchange Server 2010 或更新版本的內部部署組織之間的內部郵件流程。 不過，此設定有潛在的安全性風險 (例如，內部訊息會略過反垃圾郵件篩選) ，因此在設定此設定時請小心。
- $false：訊息不會視為內部訊息。 這是預設值。
在混合式環境中，您不需要使用此參數，因為混合式設定精靈會自動在 Microsoft 365 的輸入連接器上設定必要的設定，並在內部部署 Exchange 組織中傳送連接器， (CloudServicesMailEnabled 參數) 。
注意：如果下列任一條件成立，您就無法將此參數設定為$true值：
- CloudServicesMailEnabled 參數會設定為$true值。
- ConnectorType 參數值不是 OnPremises。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-TrustedOrganizations
TrustedOrganizations 參數會指定其他受信任郵件來源的 Microsoft 365 組織，例如，在) 收購和合併之後 (。 此參數僅適用于兩個 Microsoft 365 組織之間的郵件流程，因此不會使用其他參數。
若要輸入多個值並覆寫任何現有的專案，請使用下列語法： Value1,Value2,...ValueN 。 如果值包含空格或需要引號，請使用下列語法： "Value1","Value2",..."ValueN" 。
若要新增或移除一或多個值而不影響任何現有的專案，請使用下列語法： @{Add="Value1","Value2"...; Remove="Value3","Value4"...} 。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-WhatIf
WhatIf 參數會模擬命令的動作。 使用此參數時，您不需要實際套用變更即可檢視可能會發生的變更。 您不需要使用此參數指定值。
| Type: | SwitchParameter |
| Aliases: | wi |
| 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
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。