共用方式為


Set-InboundConnector

此指令程式只能在雲端式服務中使用。

使用 Set-InboundConnector 指令程式以變更基於雲端組織的現有輸入連接器。

如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法

語法

Default (預設值)

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 的所有參數,但如果某些參數未包含在指派給您的許可權中,您可能無法存取這些參數。 若要尋找在組織中執行任何 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

適用:Exchange Online、Exchange Online Protection

AssociatedAcceptedDomains 參數會將使用連接器的來源網域限制為指定的已接受網域。 有效的值是 SMTP 網域,其設定為您Microsoft 365 組織中接受的網域。

您可以指定多個以逗號分隔的值。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-CloudServicesMailEnabled

適用:Exchange Online、Exchange Online Protection

注意:建議您不要使用此參數,除非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:連接器不會用於混合式組織中的郵件流程,因此會從透過連接器流動的訊息中移除任何跨單位標頭。

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Comment

適用:Exchange Online、Exchange Online Protection

Comment 參數會指定選擇性註解。 如果指定的值含有空格,則必須以雙引號 (") 括住值,例如︰"This is an admin note"。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Confirm

適用:Exchange Online、Exchange Online Protection

Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。

  • 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停,它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet,您可以使用以下確切語法來略過確認提示:-Confirm:$false
  • 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 在使用這些 Cmdlet 時,指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:cf

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ConnectorSource

適用:Exchange Online、Exchange Online Protection

ConnectorSource 參數會指定連接器的建立方式。 此參數的有效輸入包括下列值:

  • 預設值:手動建立連接器。 此值為預設值。
  • HybridWizard:混合式設定精靈會自動建立連接器。
  • 已移轉:連接器最初是在 Microsoft Forefront Online Protection for Exchange 中建立的。

建議您不要變更此值。

參數屬性

類型:TenantConnectorSource
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ConnectorType

適用:Exchange Online、Exchange Online Protection

ConnectorType 參數為由連接器服務的網域指定類別。 此參數的有效輸入包括下列值:

  • 合作夥伴:您組織外部的連接器服務網域。
  • OnPremises:連接器服務內部部署組織所使用的網域。 OnPremises 連接器會將特殊許可權授與符合連接器和其他需求的電子郵件。 例如:允許透過租用戶轉送至因特網目的地、將來自內部部署或其他環境的電子郵件升級為混合式設定) 中的內部 (,或啟用其他更複雜的郵件流程。

參數屬性

類型:TenantConnectorType
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-EFSkipIPs

適用:Exchange Online、Exchange Online Protection

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。

您可以指定多個以逗號分隔的值。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-EFSkipLastIP

適用:Exchange Online、Exchange Online Protection

EFSkipIPs 參數會指定連接器的增強篩選行為。 有效值為:

  • $true:只略過最後一個訊息來源。
  • $false:略過 EFSkipIPs 參數所指定的來源IP位址。 如果未指定任何IP位址,連接器上會停用連接器的增強式篩選。 此值為預設值。

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-EFSkipMailGateway

適用:Exchange Online、Exchange Online Protection

將保留此參數供 Microsoft 內部使用。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-EFTestMode

適用:Exchange Online、Exchange Online Protection

將保留此參數供 Microsoft 內部使用。

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-EFUsers

適用:Exchange Online、Exchange Online Protection

EFUsers 參數會指定適用於連接器的增強篩選套用的收件者。 默認值為空白 ($null) ,這表示連接器的增強篩選會套用至所有收件者。

您可以指定多個以逗號隔開的收件者電子郵件地址。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Enabled

適用:Exchange Online、Exchange Online Protection

Enabled 參數會啟用或停用連接器。 有效值為:

  • $true:已啟用連接器。 此值為預設值。
  • $false:連接器已停用。

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Identity

適用:Exchange Online、Exchange Online Protection

Identity 參數會指定您要變更的輸入連接器。

參數屬性

類型:InboundConnectorIdParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:1
必要:True
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Name

適用:Exchange Online、Exchange Online Protection

Name 參數會指定連接器的描述性名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-RequireTls

適用:Exchange Online、Exchange Online Protection

RequireTLS 參數會指定是否要針對合作夥伴類型連接器所接收的所有訊息要求 TLS 傳輸。 有效值為:

  • $true:如果訊息不是透過 TLS 傳送,則拒絕訊息。 此值為預設值
  • $false:如果訊息不是透過 TLS 傳送,則允許訊息。

注意:此參數僅適用於合作夥伴類型連接器。

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-RestrictDomainsToCertificate

適用:Exchange Online、Exchange Online Protection

RestrictDomainsToCertificate 參數會指定是否在訊息可以使用合作夥伴類型連接器之前檢查 TLS 憑證的 Subject 值。 有效值為:

  • $true:只有當來源電子郵件伺服器用來驗證之 TLS 憑證的 Subject 值符合 TlsSenderCertificateName 參數值時,才允許郵件使用連接器。
  • $false:來源電子郵件伺服器用來驗證之 TLS 憑證的 Subject 值無法控制來自該來源的郵件是否使用連接器。 此值為預設值。

注意:此參數僅適用於合作夥伴類型連接器。

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-RestrictDomainsToIPAddresses

適用:Exchange Online、Exchange Online Protection

RestrictDomainsToIPAddresses 參數會指定是否拒絕來自合作夥伴類型連接器之未知來源 IP 位址的郵件。 有效值為:

  • $true:如果 SenderIPAddress 參數也未指定來源 IP 位址,則自動拒絕 SenderDomains 參數所指定網域的郵件。
  • $false:請勿根據來源 IP 位址自動拒絕 SenderDomains 參數所指定網域的郵件。 此值為預設值。

注意:此參數僅適用於合作夥伴類型連接器。

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ScanAndDropRecipients

適用:Exchange Online、Exchange Online Protection

將保留此參數供 Microsoft 內部使用。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SenderDomains

適用:Exchange Online、Exchange Online Protection

SenderDomains 參數會指定合作夥伴類型連接器接受訊息的來源網域, (限制合作夥伴類型連接器) 的範圍。 有效的值是 SMTP 網域。 支援通配符來表示網域和所有子域 (例如, *.contoso.com) 。 不過,您無法內嵌通配符 (例如, domain.*.contoso.com 無效) 。

您可以指定多個以逗號分隔的網域。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SenderIPAddresses

適用:Exchange Online、Exchange Online Protection

SenderIPAddresses 參數會指定當 RestrictDomainsToIPAddresses 參數的值$true時,合作夥伴類型連接器接受訊息的來源 IPV4 IP 位址。 有效值為:

  • 單一 IP 位址: 例如,192.168.1.1。
  • 無類別網域間路由 (CIDR) IP 位址範圍: 例如,192.168.0.1/25。 有效的子網掩碼值是 /24 到 /32。 @@ -435,6 +441,8 @@ 您可以指定多個以逗號分隔的 IP 位址。

不支援 IPv6 位址。

注意:只有在$true RestrictDomainsToIPAddresses 參數的值時,此參數才會套用至合作夥伴類型連接器。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-TlsSenderCertificateName

適用:Exchange Online、Exchange Online Protection

TlsSenderCertificateName 參數會指定當 $true RequireTls 參數的值時所使用的 TLS 憑證。 有效的值是 SMTP 網域。 支援使用通配符來表示網域和所有子域 (例如 *.contoso.com) ,但您無法內嵌通配符 (例如 domain.*.contoso.com 無效) 。

參數屬性

類型:TlsCertificate
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-TreatMessagesAsInternal

適用:Exchange Online、Exchange Online Protection

TreatMessagesAsInternal 參數會指定替代方法,將從內部部署組織傳送的訊息識別為內部訊息。 只有在內部部署組織未使用 Exchange 時,才應該考慮使用此參數。 有效值為:

  • $true:如果發件人的網域符合在 Microsoft 365 中設定的網域,則會將訊息視為內部訊息。 此設定允許Microsoft 365 與未安裝 Exchange Server 2010 或更新版本的內部部署組織之間的內部郵件流程。 不過,此設定有潛在的安全性風險 (例如,內部訊息會略過反垃圾郵件篩選) ,因此在設定此設定時請小心。
  • $false:訊息不會視為內部訊息。 此值為預設值。

在混合式環境中,您不需要使用此參數,因為混合式設定精靈會在 Microsoft 365 的輸入連接器上自動設定必要的設定,並在內部部署 Exchange 組織中傳送連接器, (CloudServicesMailEnabled 參數) 。

注意:如果下列任一條件成立,您就無法將此參數設定為$true值:

  • CloudServicesMailEnabled 參數會設定為$true值。
  • ConnectorType 參數值不是 OnPremises。

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-TrustedOrganizations

適用:Exchange Online、Exchange Online Protection

TrustedOrganizations 參數會指定其他Microsoft 365 組織,例如,在取得和合併) 之後, (信任的郵件來源。 此參數僅適用於兩個Microsoft 365 組織之間的郵件流程,因此不會使用其他參數。

若要輸入多個值並覆寫現有的項目,請使用下列語法: Value1,Value2,...ValueN。 如果這些值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"

若要新稱或移除一個或多個值,而不影響任何現有的項目,請使用以下語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-WhatIf

適用:Exchange Online、Exchange Online Protection

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

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

輸出

Output types

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