New-OrganizationRelationship

參考

模組:: ExchangePowerShell

適用於:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。有些參數和設定可能是某一個環境所專屬。

使用 New-OrganizationRelationship Cmdlet 來建立組織關聯性。組織關聯性會定義與外部 Exchange 組織搭配使用的設定，以存取行事曆空閒/忙碌資訊，或在內部部署 Exchange 伺服器與Exchange Online之間移動信箱，作為混合式部署的一部分。

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

Syntax

New-OrganizationRelationship
   [-Name] <String>
   -DomainNames <MultiValuedProperty>
   [-ArchiveAccessEnabled <Boolean>]
   [-Confirm]
   [-DeliveryReportEnabled <Boolean>]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-FreeBusyAccessEnabled <Boolean>]
   [-FreeBusyAccessLevel <FreeBusyAccessLevel>]
   [-FreeBusyAccessScope <GroupIdParameter>]
   [-MailboxMoveCapability <MailboxMoveCapability>]
   [-MailboxMoveEnabled <Boolean>]
   [-MailboxMovePublishedScopes <MultiValuedProperty>]
   [-MailTipsAccessEnabled <Boolean>]
   [-MailTipsAccessLevel <MailTipsAccessLevel>]
   [-MailTipsAccessScope <GroupIdParameter>]
   [-OAuthApplicationId <String>]
   [-OrganizationContact <SmtpAddress>]
   [-PhotosEnabled <Boolean>]
   [-TargetApplicationUri <Uri>]
   [-TargetAutodiscoverEpr <Uri>]
   [-TargetOwaURL <Uri>]
   [-TargetSharingEpr <Uri>]
   [-WhatIf]
   [<CommonParameters>]

Description

您必須先建立同盟信任，才能建立組織關係。如需詳細資訊，請參閱同盟。

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

範例

範例 1

Get-FederationInformation -DomainName Contoso.com | New-OrganizationRelationship -Name "Contoso" -FreeBusyAccessEnabled $true -FreeBusyAccessLevel LimitedDetails

此範例會建立與 Contoso 的組織關係。要連線的功能變數名稱 contoso.com。使用下列設定：

已啟用空閒/忙碌資訊存取。

要求的組織會接收來自目標群組織的時間、主旨和位置資訊。

此範例會嘗試使用 Get-FederationInformation 命令中提供的功能變數名稱，自動探索外部組織的組態資訊。如果您使用此方法來建立組織關聯性，您必須先確定您已使用 Set-FederationOrganizationIdentifier Cmdlet 建立組織識別碼。

範例 2

New-OrganizationRelationship -Name "Fourth Coffee" -DomainNames "mail.fourthcoffee.com" -FreeBusyAccessEnabled $true -FreeBusyAccessLevel AvailabilityOnly -TargetAutodiscoverEpr "https://mail.fourthcoffee.com/autodiscover/autodiscover.svc/wssecurity" -TargetApplicationUri "mail.fourthcoffee.com"

此範例會使用下列設定建立與 Fourth Coffee 的組織關係。在此範例中，會提供與外部組織的連線設定。

要連線的網域 mail.fourthcoffee.com。

Exchange Web 服務應用程式 URL 是 mail.fourthcoffee.com。

自動探索 URL 是 https://mail.fourthcoffee.com/autodiscover/autodiscover.svc/wssecurity。

已啟用空閒/忙碌資訊存取。

要求的組織只會收到空閒/忙碌資訊與時間。

參數

-ArchiveAccessEnabled

ArchiveAccessEnabled 參數會指定是否已設定組織關係以提供遠端封存存取。有效值為：

$true：外部組織提供信箱封存的遠端存取。
$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, Exchange Online, Exchange Online Protection

-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, Exchange Online, Exchange Online Protection

-DeliveryReportEnabled

DeliveryReportEnabled 參數會指定是否應透過組織關係共用傳遞報告。有效值為：

$true：傳遞報告應透過組織關聯性共用。此值表示組織已同意與外部組織共用所有「傳遞報表」，且組織關係應該用來擷取外部組織的「傳遞報表」資訊。
$false：傳遞報告不應透過組織關係共用。此為預設值。

若要讓訊息追蹤在跨單位 Exchange 案例中運作，此參數必須設定為$true組織關係的兩端。如果此參數的值設定為$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, Exchange Online, Exchange Online Protection

-DomainController

此參數僅適用於內部部署 Exchange。

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

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

-DomainNames

DomainNames 參數會指定外部組織的 SMTP 網域。您可以指定多個以逗號分隔的網域 (例如「contoso.com」，「northamerica.contoso.com」) ，一個要求中限制為 238 個網域。

Type:	MultiValuedProperty
Position:	Named
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, Exchange Online, Exchange Online Protection

-Enabled

Enabled 參數會指定是否要啟用組織關係。有效值為：

$true：已啟用組織關聯性。這是預設值。
$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, Exchange Online, Exchange Online Protection

-FreeBusyAccessEnabled

FreeBusyAccessEnabled 參數會指定是否應該使用組織關係從外部組織擷取空閒/忙碌資訊。有效值為：

$true：從外部組織擷取空閒/忙碌資訊。
$false：不會從外部組織擷取空閒/忙碌資訊。這是預設值。

您可以使用 FreeBusyAccessLevel 和 FreeBusyAccessScope 參數來控制空閒/忙碌的存取層級和範圍。

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, Exchange Online, Exchange Online Protection

-FreeBusyAccessLevel

FreeBusyAccessLevel 參數可指定傳回給要求方組織的詳細資料數量上限。有效值為：

無：沒有空閒/忙碌存取。
AvailabilityOnly：僅限空閒/忙碌存取時間。
LimitedDetails：使用時間、主旨和位置的空閒/忙碌存取。

只有在$true FreeBusyAccessEnabled 參數值時，這個參數才有意義。

Type:	FreeBusyAccessLevel
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, Exchange Online, Exchange Online Protection

-FreeBusyAccessScope

FreeBusyAccessScope 參數會在內部組織中指定擁有郵件功能的安全性群組，其中包含外部組織可存取其空閒/忙碌資訊的使用者。您可以使用唯一識別群組的任何值。例如：

名稱
辨別名稱 (DN)
辨別名稱 (DN)
GUID

只有在$true FreeBusyAccessEnabled 參數值時，這個參數才有意義。

Type:	GroupIdParameter
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, Exchange Online, Exchange Online Protection

-MailboxMoveCapability

此參數只能在雲端式服務中使用。

MailboxMoveCapability 參數用於跨租使用者信箱移轉。有效值為：

入境
出埠
RemoteInbound
RemoteOutbound

如需詳細資訊，請參閱跨租使用者信箱移轉。

Type:	MailboxMoveCapability
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-MailboxMoveEnabled

MailboxMoveEnabled 參數會指定組織關聯性是否允許將信箱移入或移出外部組織。有效值為：

$true：允許信箱移入或移出外部組織。
$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, Exchange Online, Exchange Online Protection

-MailboxMovePublishedScopes

此參數只能在雲端式服務中使用。

MailboxMovePublishedScopes 參數用於跨租使用者信箱移轉，以指定允許其成員移轉的擁有郵件功能的安全性群組。您可以使用唯一識別群組的任何值。例如：

名稱
辨別名稱 (DN)
辨別名稱 (DN)
GUID

若要輸入多個值，請使用下列語法： <value1>,<value2>,...<valueX> 。如果值包含空格或需要引號，請使用下列語法： "<value1>","<value2>",..."<valueX>" 。

如需詳細資訊，請參閱跨租使用者信箱移轉。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-MailTipsAccessEnabled

MailTipsAccessEnabled 參數會指定是否透過此組織關係傳回此組織中使用者的 MailTips。有效值為：

$true：此組織中使用者的郵件提示會透過組織關聯性傳回。
$false：此組織中使用者的郵件提示不會透過組織關係傳回。這是預設值。

您可以使用 MailTipsAccessLevel 參數來控制 MailTips 存取層級。

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, Exchange Online, Exchange Online Protection

-MailTipsAccessLevel

MailTipsAccessLevel 參數會指定透過此組織關聯性外部共用的 MailTips 資料層級。此參數可接受下列值：

全部：所有郵件提示都會傳回，但遠端組織中的收件者會被視為外部。針對自動回復郵件提示，會傳回外部自動回復訊息。
有限：只會傳回可防止 NDR) 或自動回復 (未傳遞報表的郵件提示。不會傳回自訂郵件提示、大型物件郵件提示和仲裁收件者郵件提示。
無：不會將任何郵件提示傳回至遠端組織。這是預設值。

只有在 $true MailTipsAccessEnabled 參數值時，這個參數才有意義。

Type:	MailTipsAccessLevel
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, Exchange Online, Exchange Online Protection

-MailTipsAccessScope

MailTipsAccessScope 參數會在內部組織中指定擁有郵件功能的安全性群組，其中包含外部組織可存取其空閒/忙碌資訊的使用者。您可以使用唯一識別群組的任何值。例如：

名稱
辨別名稱 (DN)
辨別名稱 (DN)
GUID

預設值為空白 ($null) ，這表示未指定任何群組。

如果您使用此參數，則只會針對屬於指定群組成員的收件者傳回收件者特定的 MailTips。收件者特定的郵件提示如下：

自動回覆
信箱已滿
自訂

如果您未使用此參數，則會針對組織中的所有收件者傳回收件者特定的 MailTips。

這項限制只套用至信箱、郵件使用者和郵件連絡人。不會套用至通訊群組。

Type:	GroupIdParameter
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, Exchange Online, Exchange Online Protection

-Name

Name 參數會指定組織關係的唯一名稱。最大長度為 64 個字元。

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, Exchange Online, Exchange Online Protection

-OAuthApplicationId

此參數只能在雲端式服務中使用。

OAuthApplicationId 用於跨租使用者信箱移轉，以指定您同意的信箱移轉應用程式的應用程式識別碼。如需詳細資訊，請參閱跨租使用者信箱移轉。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-OrganizationContact

OrganizationContact 參數會指定可用來連絡外部組織的電子郵件地址 (例如 administrator@fourthcoffee.com ，) 。

Type:	SmtpAddress
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, Exchange Online, Exchange Online Protection

-PhotosEnabled

PhotosEnabled 參數會指定是否透過組織關係傳回內部組織中使用者的相片。有效值為：

$true：此組織中使用者的相片會透過組織關聯性傳回。
$false：此組織中使用者的相片不會透過組織關係傳回。這是預設值。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-TargetApplicationUri

TargetApplicationUri 參數會指定外部組織的目標統一資源識別碼 (URI)。向外部組織要求委派權杖以擷取空閒和忙碌資訊時，Exchange 會指定 TargetApplicationUri 參數，例如，mail.contoso.com。

Type:	Uri
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-TargetAutodiscoverEpr

TargetAutodiscoverEpr 參數會指定外部組織 Exchange Web 服務的自動探索 URL，例如 https://contoso.com/autodiscover/autodiscover.svc/wssecurity 。 Exchange 會使用自動探索服務來自動偵測要用於外部要求的正確 Exchange 伺服器端點。

Type:	Uri
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-TargetOwaURL

TargetOwaURL 參數會指定Outlook 網頁版 (先前Outlook Web App) 組織關聯性中定義之外部組織的 URL。它用於跨單位 Exchange 案例中的Outlook 網頁版重新導向。設定此屬性可讓組織中的使用者使用其目前的Outlook 網頁版 URL 來存取外部組織中的Outlook 網頁版。

Type:	Uri
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-TargetSharingEpr

TargetSharingEpr 參數會指定外部組織之目標 Exchange Web 服務的 URL。

如果您使用此參數，此 URL 一律會用來連線到外部 Exchange 伺服器。 TargetAutodiscoverEpr 參數所指定的 URL 不會用來尋找外部 Exchange 伺服器。

Type:	Uri
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, Exchange Online, Exchange Online Protection

-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, Exchange Online, Exchange Online Protection

輸入

Input types

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

輸出

Output types

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

共用方式為

New-OrganizationRelationship

Syntax

Description

範例

範例 1

範例 2

參數

-ArchiveAccessEnabled

-Confirm

-DeliveryReportEnabled

-DomainController

-DomainNames

-Enabled

-FreeBusyAccessEnabled

-FreeBusyAccessLevel

-FreeBusyAccessScope

-MailboxMoveCapability

-MailboxMoveEnabled

-MailboxMovePublishedScopes

-MailTipsAccessEnabled

-MailTipsAccessLevel

-MailTipsAccessScope

-Name

-OAuthApplicationId

-OrganizationContact

-PhotosEnabled

-TargetApplicationUri

-TargetAutodiscoverEpr

-TargetOwaURL

-TargetSharingEpr

-WhatIf

輸入

輸出

意見反應

其他資源