New-ForeignConnector
內部部署 Exchange 才有提供此 Cmdlet。
使用 New-ForeignConnector Cmdlet 可以在信箱伺服器的傳輸服務中建立新的外部連接器。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
Syntax
New-ForeignConnector
[-Name] <String>
-AddressSpaces <MultiValuedProperty>
[-Confirm]
[-DomainController <Fqdn>]
[-IsScopedConnector <Boolean>]
[-SourceTransportServers <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>]
Description
外部連接器會使用在信箱伺服器中傳輸伺服器上的放置目錄,將郵件傳送至未使用 SMTP 作為其主要傳輸機制的本機郵件伺服器。 這些郵件伺服器稱為外部閘道伺服器。 協力廠商傳真閘道伺服器是外部閘道伺服器的範例。 指派給外部連接器的位址空間可為 SMTP 或非 SMTP。
您必須已獲指派權限,才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數,不過,如果某些參數並未包含在指派給您的權限中,您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
New-ForeignConnector -Name "Contoso Foreign Connector" -AddressSpaces "X400:c=US;a=Fabrikam;P=Contoso;5" -SourceTransportServers Hub01,Hub02
此範例會建立具有下列內容的外部連接器:
- 連接器名稱:Contoso 外部連接器
- 位址空間:"c=US;a=Fabrikam;P=Contoso"
- 位址空間類型:X.400
- 位址空間成本:5
- 來源傳輸伺服器:Hub01 和 Hub02
參數
-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"
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | True |
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 |
-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 |
-Name
Name 參數會指定外部連接器的名稱。
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
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 的名稱。 將單一外部連接器置於多個伺服器上,可以在其中一個 Mailbox server 失敗時,提供容錯及高可用性。 此參數的預設值是第一個安裝這個外部連接器之伺服器的名稱。
您可以輸入多個以逗號分隔的值。 如果值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"
。
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
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。