New-OrganizationRelationship
このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。
New-OrganizationRelationship コマンドレットを使用して、組織の関係を作成します。 組織の関係は、予定表の空き時間情報にアクセスしたり、ハイブリッド展開の一環としてオンプレミスの Exchange サーバーとExchange Online間でメールボックスを移動したりするために、外部の Exchange 組織で使用される設定を定義します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
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>] 説明
組織の関係を作成する前に、まずフェデレーションの信頼を作成する必要があります。 詳細については、「 フェデレーション」を参照してください。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 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 コマンドレットを使用して組織 ID を作成していることを最初に確認する必要があります。
例 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 スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- 破壊的なコマンドレット (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")。1 回の要求で 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: 時間、件名、場所を含む空き時間アクセス。
このパラメーターは、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 |
-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 パラメーターは、この組織の関係に対して、この組織内のユーザーのメールヒントを返すかどうかを指定します。 有効な値は次のとおりです。
- $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: | 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 は、テナント間メールボックスの移行で、同意したメールボックス移行アプリのアプリケーション 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 パラメーターで指定された 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
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。