Set-OrganizationRelationship
このコマンドレットは、オンプレミスの 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
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
ArchiveAccessEnabled パラメーターには、アーカイブへのリモート アクセスを提供するように組織の関係を構成しているかどうかを指定します。 有効な値は次のとおりです。
- $true: 外部organizationは、メールボックス アーカイブへのリモート アクセスを提供します。
- $false: 外部organizationは、メールボックス アーカイブへのリモート アクセスを提供しません。 これが既定値です
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Confirm
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DeliveryReportEnabled
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
DeliveryReportEnabled パラメーターには、組織の関係によって配信レポートを共有するかどうかを指定します。 有効な値は次のとおりです。
- $true: 配信レポートは、organizationリレーションシップで共有する必要があります。 この値は、organizationがすべての配信レポートを外部organizationと共有することに同意したことを意味し、organization関係を使用して外部organizationから配信レポート情報を取得する必要があります。
- $false: 配信レポートをorganizationリレーションシップで共有しないでください。 これが既定値です
クロスプレミス Exchange シナリオでメッセージ追跡を機能させるには、このパラメーターをorganizationリレーションシップの両側で$trueに設定する必要があります。 組織の関係の一方または両方の側でこのパラメーターの値を $false に設定すると、組織間のメッセージ追跡はいずれの方向にも動作しません。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DomainController
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
| 型: | Fqdn |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DomainNames
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
DomainNames パラメーターは、外部組織の SMTP ドメインを指定します。 複数のドメインをコンマで区切って指定できます (例： "contoso.com","northamerica.contoso.com")。
| 型: | MultiValuedProperty |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Enabled
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
Enabled パラメーターは、組織の関係を有効にするかどうかを指定します。 有効な値は次のとおりです。
- $true: organizationリレーションシップが有効になっています。 これは既定の値です。
- $false: organizationリレーションシップが無効になっています。 この値は、organizationリレーションシップの共有を完全に停止します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Force
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
[強制] スイッチは、警告メッセージまたは確認メッセージを非表示にします。 このスイッチで値を指定する必要はありません。
管理者の入力を求めることが不適切な場合に、このスイッチを使用してタスクをプログラムによって実行することができます。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-FreeBusyAccessEnabled
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
FreeBusyAccessEnabled パラメーターは、外部組織から空き時間情報を取得するのに、組織の関係を使用するべきかどうかを指定します。 有効な値は次のとおりです。
- $true: 空き時間情報は外部organizationから取得されます。
- $false: 空き時間情報は外部organizationから取得されません。 これは既定の値です。
FreeBusyAccessLevel と FreeBusyAccessScope のパラメーターを使用して、空き時間情報のアクセス レベルとスコープを制御します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-FreeBusyAccessLevel
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
FreeBusyAccessLevel パラメーターは、要求する組織に返す詳細の最大量を指定します。 有効な値は次のとおりです。
- なし: 空き時間情報へのアクセスはありません。
- AvailabilityOnly: 時間のみの空き時間アクセス。
- LimitedDetails: 時間、件名、場所を含む空き時間アクセス。
このパラメーターは、FreeBusyAccessEnabled パラメーター値が.$true の場合にのみ、意味があります。
| 型: | FreeBusyAccessLevel |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-FreeBusyAccessScope
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
FreeBusyAccessScope パラメーターは、外部組織から空き時間情報にアクセスできるユーザーが含まれる、内部組織のメールが有効なセキュリティ グループを指定します。 グループを一意に識別する任意の値を使用できます。 例:
- 名前
- 識別名 (DN)
- 正規 DN
- GUID
このパラメーターは、FreeBusyAccessEnabled パラメーター値が.$true の場合にのみ、意味があります。
| 型: | GroupIdParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Identity
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
Identity パラメーターは、変更する組織の関係を指定します。 組織の関係を一意に識別する任意の値を使用できます。 例:
- 名前
- 正規名
- GUID
| 型: | OrganizationRelationshipIdParameter |
| 配置: | 1 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-MailboxMoveCapability
適用対象: Exchange Online、Exchange Online Protection
このパラメーターは、クラウドベースのサービスでのみ使用できます。
MailboxMoveCapability パラメーターは、テナント間メールボックスの移行で使用されます。 有効な値は次のとおりです。
- 受信
- 送信
- RemoteInbound
- RemoteOutbound
詳細については、「 テナント間メールボックスの移行」を参照してください。
| 型: | MailboxMoveCapability |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-MailboxMoveEnabled
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
MailboxMoveEnabled パラメーターには、組織の関係によってメールボックスを外部組織との間で移動できるかどうかを指定します。 有効な値は次のとおりです。
- $true: メールボックスは外部organizationとの間で移動できます。
- $false: メールボックスが外部organizationから に移動することは許可されません。 これは既定の値です。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-MailboxMovePublishedScopes
適用対象: Exchange Online、Exchange Online Protection
このパラメーターは、クラウドベースのサービスでのみ使用できます。
MailboxMovePublishedScopes パラメーターは、テナント間メールボックスの移行で使用され、メンバーの移行が許可されているメールが有効なセキュリティ グループを指定します。 グループを一意に識別する任意の値を使用できます。 例:
- 名前
- 識別名 (DN)
- 正規 DN
- GUID
複数の値を入力して既存のエントリをすべて上書きするには、次の構文を使用します: Value1,Value2,...ValueN。 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"。
既存のエントリに影響を及ぼさずに、1 つまたは複数の値を追加または削除するには、次の構文を使用します: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
詳細については、「 テナント間メールボックスの移行」を参照してください。
| 型: | MultiValuedProperty |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-MailTipsAccessEnabled
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
MailTipsAccessEnabled パラメーターは、この組織の関係に対して、この組織内のユーザーのメールヒントを返すかどうかを指定します。 有効な値は次のとおりです。
- $true: このorganizationのユーザーのメール ヒントは、organizationリレーションシップに対して返されます。
- $false: このorganizationのユーザーのメール ヒントは、organization関係に対して返されません。 これは既定の値です。
MailTipsAccessLevel パラメーターを使用して、メール ヒント アクセス レベルを制御します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-MailTipsAccessLevel
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
MailTipsAccessLevel パラメーターは、この組織の関係に対して外部的に共有されているメールヒント データのレベルを指定します。 このパラメーターには、以下の値を指定できます。
- すべて: すべてのメール ヒントが返されますが、リモート organizationの受信者は外部と見なされます。 自動応答メール ヒントの場合は、外部の自動応答メッセージが返されます。
- 制限: 配信不能レポート (NDR) または自動応答を妨げる可能性があるメール ヒントのみが返されます。 カスタム メール ヒント、大規模な対象ユーザーのメール ヒント、およびモデレートされた受信者のメール ヒントは返されません。
- なし: リモート organizationにメール ヒントは返されません。 これは既定の値です。
このパラメーターは、MailTipsAccessEnabled パラメーター値が.$true の場合にのみ、意味があります。
| 型: | MailTipsAccessLevel |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-MailTipsAccessScope
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
MailTipsAccessScope パラメーターは、外部組織から空き時間情報にアクセスできるユーザーが含まれる、内部組織のメールが有効なセキュリティ グループを指定します。 グループを一意に識別する任意の値を使用できます。 例:
- 名前
- 識別名 (DN)
- 正規 DN
- GUID
既定値は空白 ($null) です。これは、グループを指定しないという意味です。
このパラメーターを使用すると、指定したグループのメンバーである受信者に対してのみ、指定したメールヒントが返されます。 受信者固有のメールヒントは、次のとおりです。
- 自動応答
- メールボックスがいっぱい
- カスタム
このパラメーターを使用しない場合、組織内のすべての受信者に対して受信者固有のメールヒントが返されます。
この制限はメールボックス、メール ユーザー、およびメール連絡先にのみ適用されます。 配布グループには適用されません。
| 型: | GroupIdParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
Name パラメーターは、組織の関係の一意の名前を指定します。 最大の長さは 64 文字です。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OAuthApplicationId
適用対象: Exchange Online、Exchange Online Protection
このパラメーターは、クラウドベースのサービスでのみ使用できます。
OAuthApplicationId は、テナント間メールボックスの移行で、同意したメールボックス移行アプリのアプリケーション ID を指定するために使用されます。 詳細については、「 テナント間メールボックスの移行」を参照してください。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OrganizationContact
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
OrganizationContact パラメーターは、外部organizationに接続するために使用できる電子メール アドレスを指定します (たとえば、administrator@fourthcoffee.com)。
| 型: | SmtpAddress |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PhotosEnabled
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
PhotosEnabled パラメーターは、組織の関係によって、内部組織のユーザーの写真を返すかどうかを指定します。 有効な値は次のとおりです。
- $true: このorganizationのユーザーの写真は、organization関係に対して返されます。
- $false: このorganizationのユーザーの写真は、organization関係では返されません。 これは既定の値です。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-TargetApplicationUri
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
TargetApplicationUri パラメーターは、外部組織の対象 URI (Uniform Resource Identifier) を指定します。 TargetApplicationUri パラメーターは、空き時間情報 (たとえば、mail.contoso.com) を取得するために委任されたトークンを要求するときに Exchange によって指定されます。
| 型: | Uri |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-TargetAutodiscoverEpr
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
TargetAutodiscoverEpr パラメーターは、外部organizationの Exchange Web サービスの自動検出 URL (たとえば、https://contoso.com/autodiscover/autodiscover.svc/wssecurity) を指定します。 Exchange では自動検出を使用して、外部要求に使用する正しい Exchange サーバー エンドポイントを自動的に検出します。
| 型: | Uri |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-TargetOwaURL
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
TargetOwaURL パラメーターは、organizationリレーションシップで定義されている外部organizationのOutlook on the web (以前のOutlook Web App) URL を指定します。 これは、クロスプレミス Exchange シナリオでのOutlook on the webリダイレクトに使用されます。 この属性を構成すると、organizationのユーザーは現在のOutlook on the web URL を使用して、外部organizationのOutlook on the webにアクセスできます。
| 型: | Uri |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-TargetSharingEpr
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
TargetSharingEpr パラメーターは、外部organizationのターゲット Exchange Web サービスの URL を指定します。
このパラメーターを使用する場合、この URL は常に外部 Exchange サーバーに到達するために使用されます。 TargetAutoDiscoverEpr パラメーターで指定された TheURL は、外部 Exchange サーバーの検索には使用されません。
| 型: | Uri |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。