Set-ForeignConnector

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

使用 Set-ForeignConnector Cmdlet 來修改信箱伺服器的傳輸服務中現有的 Foreign 連接器。

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

Syntax

Set-ForeignConnector
   [-Identity] <ForeignConnectorIdParameter>
   [-AddressSpaces <MultiValuedProperty>]
   [-Comment <String>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-DropDirectory <String>]
   [-DropDirectoryQuota <Unlimited>]
   [-Enabled <Boolean>]
   [-Force]
   [-IsScopedConnector <Boolean>]
   [-MaxMessageSize <Unlimited>]
   [-Name <String>]
   [-RelayDsnRequired <Boolean>]
   [-SourceTransportServers <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

Description

外部連接器會使用在信箱伺服器中傳輸伺服器上的放置目錄,將郵件傳送至未使用 SMTP 作為其主要傳輸機制的本機郵件伺服器。 這些郵件伺服器稱為外部閘道伺服器。 協力廠商傳真閘道伺服器是外部閘道伺服器的範例。 指派給外部連接器的位址空間可為 SMTP 或非 SMTP。

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

範例

範例 1

Set-ForeignConnector "Fax Connector" -MaxMessageSize 10MB

此範例會在名為 Fax Connector 的現有外部連接器上設定 10 MB 的訊息大小限制。

參數

-AddressSpaces

AddressSpaces 參數會指定外部連接器傳送郵件的目標網域名稱。 輸入每個位址空間的完整語法為: AddressSpaceType:AddressSpace;AddressSpaceCost

  • AddressSpaceType:此位址空間類型可能是 SMTP、X400 或任何其他文字字串。 如果略過位址空間類型,則會假設使用 SMTP 位址空間類型。
  • AddressSpace:若是 SMTP 位址空間類型,則輸入的位址空間必須符合 RFC 1035。 例如,允許使用 *、*.com 和 *.contoso.com,但不允許使用 *contoso.com。 如果是 X.400 位址空間類型,則輸入的位址空間必須符合 RFC 1685,如 o=MySite;p=MyOrg;a=adatum;c=us。 針對網址類別型的所有其他值,您可以輸入位址空間的任何文字。
  • AddressSpaceCost :成本的有效輸入範圍從 1 到 100。 成本愈低表示路由愈好。 如果略過位址空間成本,則會假設使用成本 1。 如果您輸入的非 SMTP 位址空間包含分號 (;) ,則必須指定位址空間成本。

若指定位址空間類型或位址空間成本,則必須將位址空間以引號 (") 括住。 例如,下列位址空間項目是同等項目:

  • 「SMTP:contoso.com;1」
  • 「contoso.com;1」
  • 「SMTP:contoso.com」
  • contoso.com

您可以使用逗號分隔位址空間來指定多個位址空間,例如: contoso.com,fabrikam.com 。 如果您指定位址空間類型或位址空間成本,則必須以引號括住位址空間 (「) ,例如:。 "contoso.com;2","fabrikam.com;3"

若要新增或移除一或多個位址空間值,而不影響任何現有的專案,請使用下列語法: @{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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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

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

-DomainController

DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如,dc01.contoso.com。

Edge Transport Server 不支援 DomainController 參數。 Edge Transport Server 會使用 Active Directory 輕量型目錄服務 (AD LDS) 的本機執行個體來讀寫資料。

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, Exchange Server 2019

-DropDirectory

DropDirectory 參數會指定這個 Foreign 連接器所使用的 Drop 目錄名稱。 傳送至此外部連接器所定義位址空間的所有輸出訊息都會放在指定的 Drop 目錄中。 每個 Foreign 連接器的 Drop 目錄位置是由下列兩個專案所控制:

  • Set-TransportService Cmdlet 中的 RootDropDirectoryPath 參數:此選項適用于信箱伺服器上的所有外部連接器。 RootDropDirectoryPath 參數的值可以是本機路徑或通用命名慣例 (UNC) 遠端伺服器的路徑。
  • Set-ForeignConnector Cmdlet 中的 DropDirectory 參數:此值會針對伺服器上存在的每個外部連接器設定。

根據預設,RootDropDirectoryPath 參數是空白的。 這表示 RootDropDirectoryPath 的值是 Exchange 2010 安裝資料夾。 預設的 Exchange 2010 安裝資料夾是 C:\Program Files\Microsoft\Exchange Server\。 根據預設,DropDirectory 參數的值是 Foreign 連接器的名稱。

如果 DropDirectory 參數的值不包含絕對路徑資訊,Drop 目錄的位置會由 DropDirectory 參數和 RootDropDirectoryPath 參數的組合來定義。 如果 DropDirectory 參數的值包含絕對路徑資訊,則必須未指定 RootDropDirectoryPath 的值。 Drop 目錄的位置只會由 DropDirectory 參數的值定義。

不會為您建立 Drop 目錄。 因此,您必須手動建立每個 Drop 目錄資料夾。

Drop 目錄必須獲指派下列許可權:

  • 網路服務:完全控制
  • 系統:完全控制
  • 系統管理員:完全控制
Type:String
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, Exchange Server 2019

-DropDirectoryQuota

DropDirectoryQuota 參數會指定 Drop 目錄中所有訊息檔案的大小上限。 達到指定的值時,在傳遞和刪除現有的訊息之前,無法將任何新的訊息檔案複製到 Drop 目錄中。

有效值是最高 1.999999999 TB (2199023254528 個位元組) 的數值或 unlimited 值。預設值是 6 GB (6442450944 個位元組)。

  • B (位元組)
  • KB (千位元組)
  • MB (百萬位元組)
  • GB (十億位元組)
  • TB (TB)

TB (TB)

此參數的有效輸入範圍是從 1 到 2147483647 個位元組。 如果您輸入無限制的值,Drop 目錄上就不會有訊息大小限制。 預設值為無限制。

Type:Unlimited
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, Exchange Server 2019

-Enabled

Enabled 參數會指定是否要啟用 Foreign 連接器。 有效值是$true或$false。 預設值為 $true。

Type:Boolean
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, Exchange Server 2019

-Force

Force 參數會隱藏警告或確認訊息。 您不需要使用此參數指定值。

在不適合提示系統管理員輸入的場合中,您可以使用此參數來利用程式設計方式執行工作。

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, Exchange Server 2019

-Identity

Identity 參數會指定您要修改的 Foreign 連接器。 Identity 參數可以接受 Foreign 連接器物件的下列任何值:

  • GUID
  • 連接器名稱
  • ServerName\ConnectorName
Type:ForeignConnectorIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-IsScopedConnector

IsScopedConnector 參數會指定其他 Mailbox server 之連接器的可用性。 當此參數的值$false時,Exchange 組織中的所有信箱伺服器都可以使用連接器。 當此參數的值$true時,連接器只能由相同 Active Directory 網站中的信箱伺服器使用。 預設值為 $false。

Type:Boolean
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, Exchange Server 2019

-MaxMessageSize

MaxMessageSize 參數會指定可通過這個 Foreign 連接器的訊息大小上限。

有效值是最高 1.999999999 TB (2199023254528 個位元組) 的數值或 unlimited 值。預設值是 6 GB (6442450944 個位元組)。

  • B (位元組)
  • KB (千位元組)
  • MB (百萬位元組)
  • GB (十億位元組)
  • TB (TB)

TB (TB)

如果您輸入無限制的值,則此外部連接器不會加權任何訊息大小限制。 預設值為無限制。 此參數的有效輸入範圍是從 0 到 2147483647 KB。 如果您將 MaxMessageSize 參數的值設定為 0,則可以有效地停用 Foreign 連接器。 不過,如果您在已$true Enabled 屬性的值時,將 MaxMessageSize 參數的值設定為 0,則會產生事件記錄檔錯誤。 停用 Foreign 連接器的慣用方法是使用 Enabled 參數。

Type:Unlimited
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, Exchange Server 2019

-Name

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

Type:String
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, Exchange Server 2019

-RelayDsnRequired

RelayDsnRequired 參數會指定當訊息寫入 Drop 目錄時,外部連接器是否需要轉送傳遞狀態通知 (DSN) 。 此參數的有效輸入值$true或$false。 預設值為 $false。

Type:Boolean
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, Exchange Server 2019

-SourceTransportServers

SourceTransportServers 參數會指定使用此外部連接器之 Mailbox server 的名稱。 讓單一外部連接器位於執行傳輸服務的多部信箱伺服器上,可在其中一部伺服器失敗時提供容錯和高可用性。 此參數的預設值是第一次安裝此 Foreign 連接器的信箱伺服器名稱。

若要輸入多個值並覆寫任何現有的專案,請使用下列語法: 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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

WhatIf 參數會模擬命令的動作。 使用此參數時,您不需要實際套用變更即可檢視可能會發生的變更。 您不需要使用此參數指定值。

Type:SwitchParameter
Aliases:wi
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, Exchange Server 2019

輸入

Input types

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

輸出

Output types

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