Set-ForeignConnector

模組:: Exchange PowerShell

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

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

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

語法

Default (預設值)

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 作為其主要傳輸機制的本機郵件伺服器。這些郵件伺服器稱為外部閘道伺服器。非 Microsoft 傳真閘道伺服器是外部閘道伺服器的範例。指派給外部連接器的位址空間可為 SMTP 或非 SMTP。

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

範例

範例 1

Set-ForeignConnector "Fax Connector" -MaxMessageSize 10MB

此範例會在名為「傳真連接器」的現有外部連接器上設定 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"...}。

參數屬性

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

參數集

(All)

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

-Comment

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

參數屬性

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

參數集

(All)

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

-Confirm

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

-DomainController

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

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

參數屬性

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

參數集

(All)

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

-DropDirectory

DropDirectory 參數會指定此外部連接器所使用的放置目錄名稱。傳送至此外部連接器所定義之位址空間的所有出站郵件，都會放在指定的 Drop 目錄中。每個外部連接器的放置目錄位置由下列兩個項目所控制：

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

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

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

系統不會為您建立放置目錄。因此，您必須手動建立每個 Drop 目錄資料夾。

放置目錄必須具備下列指派的權限：

網路服務：完全控制
系統：完全控制
系統管理員：完全控制

參數屬性

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

參數集

(All)

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

-DropDirectoryQuota

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

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

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

不完整的值通常被視為位元組，但較小的值可能會進位到最接近的千位元組。

此參數的有效輸入範圍是從 1 到 2147483647 位元組。如果您輸入 unlimited 值，則不會在 Drop 目錄上強制執行郵件大小限制。預設值為無限制。

參數屬性

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

參數集

(All)

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

-Enabled

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

參數屬性

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

參數集

(All)

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

-Force

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

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

參數屬性

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

參數集

(All)

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

-Identity

Identity 參數會指定您要修改的外部連接器。 Identity 參數可以採用外部連接器物件的以下任何值：

GUID
連接器名稱
ServerName\ConnectorName

參數屬性

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

參數集

(All)

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

-IsScopedConnector

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

參數屬性

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

參數集

(All)

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

-MaxMessageSize

MaxMessageSize 參數會指定可通過此外部連接器的訊息大小上限。

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

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

不完整的值通常被視為位元組，但較小的值可能會進位到最接近的千位元組。

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

參數屬性

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

參數集

(All)

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

-Name

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

參數屬性

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

參數集

(All)

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

-RelayDsnRequired

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

參數屬性

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

參數集

(All)

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

-SourceTransportServers

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

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

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

參數屬性

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

參數集

(All)

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

-WhatIf

WhatIf 參數會顯示命令在不進行任何變更的情況下執行的動作。您不需要使用此參數指定值。

參數屬性

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

參數集

(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

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

意見反應

此頁面對您有幫助嗎？