Set-OrganizationRelationship

モジュール:

ExchangePowerShell

適用対象:

Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。

Set-OrganizationRelationship コマンドレットを使用して、既存の組織の関係を変更します。 組織の関係は、予定表の空き時間情報にアクセスしたり、ハイブリッド展開の一環としてオンプレミスの Exchange サーバーとExchange Online間でメールボックスを移動したりするために、外部の Exchange 組織で使用される設定を定義します。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

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

説明

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例

例 1

Set-OrganizationRelationship -Identity "Fourth Coffee" -FreeBusyAccessLevel LimitedDetails

この例では、空き時間アクセス レベルを時刻、件名、場所を含む LimitedDetails に変更します。

例 2

Set-OrganizationRelationship -Identity "Contoso" -Enabled $false

この例は、組織の Contoso との関係を無効にします。

パラメーター

-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 スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。

• 破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
• 他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。 これらのコマンドレットの場合、値なしで 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 パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは 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")。

Type:	MultiValuedProperty
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

-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

-Force

[強制] スイッチは、警告メッセージまたは確認メッセージを非表示にします。 このスイッチで値を指定する必要はありません。

管理者の入力を求めることが不適切な場合に、このスイッチを使用してタスクをプログラムによって実行することができます。

Type:	SwitchParameter
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: 時間、件名、場所を含む空き時間アクセス。

このパラメーターは、FreeBusyAccessEnabled パラメーター値が.$true の場合にのみ、意味があります。

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

このパラメーターは、FreeBusyAccessEnabled パラメーター値が.$true の場合にのみ、意味があります。

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

-Identity

Identity パラメーターは、変更する組織の関係を指定します。 組織の関係を一意に識別する任意の値を使用できます。 例:

• 名前
• 正規名
• GUID

Type:	OrganizationRelationshipIdParameter
Position:	1
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

-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,...ValueN 値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value1","Value2",..."ValueN"

既存のエントリに影響を与えずに 1 つ以上の値を追加または削除するには、次の構文を使用します。 @{Add="Value1","Value2"...; Remove="Value3","Value4"...}

詳細については、「 テナント間メールボックスの移行」を参照してください。

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 パラメーターは、この組織の関係に対して、この組織内のユーザーのメールヒントを返すかどうかを指定します。 有効な値は次のとおりです。

• $true: この組織内のユーザーのメール ヒントは、組織の関係を介して返されます。
• $false: この組織内のユーザーのメール ヒントは、組織の関係に対して返されません。 これは既定の値です。

MailTipsAccessLevel パラメーターを使用して、メール ヒント アクセス レベルを制御します。

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 パラメーターは、この組織の関係に対して外部的に共有されているメールヒント データのレベルを指定します。 このパラメーターには、以下の値を指定できます。

• すべて: すべてのメール ヒントが返されますが、リモート組織の受信者は外部と見なされます。 自動応答メール ヒントの場合は、外部の自動応答メッセージが返されます。
• 制限: 配信不能レポート (NDR) または自動応答を妨げる可能性があるメール ヒントのみが返されます。 カスタム メール ヒント、大規模な対象ユーザーのメール ヒント、およびモデレートされた受信者のメール ヒントは返されません。
• なし: リモート組織にメール ヒントは返されません。 これは既定の値です。

このパラメーターは、MailTipsAccessEnabled パラメーター値が.$true の場合にのみ、意味があります。

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) です。これは、グループを指定しないという意味です。

このパラメーターを使用すると、指定したグループのメンバーである受信者に対してのみ、指定したメールヒントが返されます。 受信者固有のメールヒントは、次のとおりです。

• 自動応答
• メールボックスがいっぱい
• Custom

このパラメーターを使用しない場合、組織内のすべての受信者に対して受信者固有のメールヒントが返されます。

この制限はメールボックス、メール ユーザー、およびメール連絡先にのみ適用されます。 配布グループには適用されません。

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:	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

-OAuthApplicationId

このパラメーターは、クラウドベースのサービスでのみ使用できます。

OAuthApplicationId は、テナント間メールボックスの移行で、同意したメールボックス移行アプリのアプリケーション ID を指定するために使用されます。 詳細については、「 テナント間メールボックスの移行」を参照してください。

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 (Uniform Resource Identifier) を指定します。 TargetApplicationUri パラメーターは、空き時間情報 (たとえば、mail.contoso.com) を取得するために委任されたトークンを要求するときに 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

-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 on the web (以前のOutlook Web App) URL を指定します。 これは、クロスプレミス Exchange シナリオでのOutlook on the webリダイレクトに使用されます。 この属性を構成すると、組織内のユーザーは現在のOutlook on the web URL を使用して、外部組織のOutlook on the webにアクセスできます。

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 パラメーターで指定された TheURL は、外部 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

このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。