共用方式為


New-OrganizationRelationship

內部部署 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

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