Set-ForeignConnector

模組:: Exchange PowerShell

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

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

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 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

此範例會在名為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"...}。

參數屬性

類型:	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 參數會指定這個 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 目錄必須獲指派下列許可權：

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

參數屬性

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

參數集

(All)

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

-DropDirectoryQuota

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

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

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

非限定值通常會被視為位元組，但小型值可能會四捨五入到最接近的 KB。

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

參數屬性

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

參數集

(All)

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

-Enabled

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

參數屬性

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

參數集

(All)

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

-Force

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

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

參數屬性

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

參數集

(All)

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

-Identity

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

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 參數會指定可通過這個 Foreign 連接器的訊息大小上限。

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

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

非限定值通常會被視為位元組，但小型值可能會四捨五入到最接近的 KB。

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

參數屬性

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

參數集

(All)

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

-Name

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

參數屬性

類型:	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 的名稱。讓單一外部連接器位於執行傳輸服務的多部信箱伺服器上，可在其中一部伺服器失敗時提供容錯和高可用性。此參數的預設值是第一次安裝此 Foreign 連接器的信箱伺服器名稱。

若要輸入多個值並覆寫現有的項目，請使用下列語法: 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
別名:	無線

參數集

(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

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

意見反應

此頁面對您有幫助嗎？

共用方式為

Set-ForeignConnector

語法

Default (預設值)

Description

範例

範例 1

參數

-AddressSpaces

參數屬性

參數集

-Comment

參數屬性

參數集

-Confirm

參數屬性

參數集

-DomainController

參數屬性

參數集

-DropDirectory

參數屬性

參數集

-DropDirectoryQuota

參數屬性

參數集

-Enabled

參數屬性

參數集

-Force

參數屬性

參數集

-Identity

參數屬性

參數集

-IsScopedConnector

參數屬性

參數集

-MaxMessageSize

參數屬性

參數集

-Name

參數屬性

參數集

-RelayDsnRequired

參數屬性

參數集

-SourceTransportServers

參數屬性

參數集

-WhatIf

參數屬性

參數集

CommonParameters

輸入

Input types

輸出

Output types

意見反應