PowerShell または Microsoft Graph API を使用してマルチテナント組織を構成する
この記事では、Microsoft Graph PowerShell または Microsoft Graph API を使用してマルチテナント組織を構成する主要な手順について説明します。 この記事では、Cairo という名前の所有者テナントと Berlin と Athens という名前の 2 つのメンバー テナントの例を使用します。
代わりに、Microsoft 365 管理センターを使用してマルチテナント組織を構成する場合は、「Microsoft 365 でマルチテナント組織を設定する」および「Microsoft 365 でマルチテナント組織に参加または脱退する」を参照してください。 マルチテナント組織用に Microsoft Teams を構成する方法については、Microsoft Teams デスクトップ クライアントに関する記事を参照してください。
前提条件
所有者テナント
- 詳細については、「ライセンスの要件」を参照してください。
- マルチテナント組織のテナント間アクセス設定とテンプレートを構成するためのセキュリティ管理者ロール。
- 必要なアクセス許可に同意するためのグローバル管理者ロール。
メンバー テナント
- 詳細については、「ライセンスの要件」を参照してください。
- マルチテナント組織のテナント間アクセス設定とテンプレートを構成するためのセキュリティ管理者ロール。
- 必要なアクセス許可に同意するためのグローバル管理者ロール。
手順 1: 所有者テナントにサインインする
所有者テナント
PowerShell を開始します。
必要に応じて、Microsoft Graph PowerShell SDK をインストールします。
所有者とメンバーのテナントのテナント ID を取得し、変数を初期化します。
$OwnerTenantId = "<OwnerTenantId>" $MemberTenantIdB = "<MemberTenantIdB>" $MemberTenantIdA = "<MemberTenantIdA>"
Connect-MgGraph コマンドを使用して所有者テナントにサインインし、次の必要なアクセス許可に同意します。
MultiTenantOrganization.ReadWrite.All
Policy.Read.All
Policy.ReadWrite.CrossTenantAccess
Application.ReadWrite.All
Directory.ReadWrite.All
Connect-MgGraph -TenantId $OwnerTenantId -Scopes "MultiTenantOrganization.ReadWrite.All","Policy.Read.All","Policy.ReadWrite.CrossTenantAccess","Application.ReadWrite.All","Directory.ReadWrite.All"
手順 2: マルチテナント組織を作成する
所有者テナント
所有者テナントで、Update-MgBetaTenantRelationshipMultiTenantOrganization コマンドを使用して、マルチテナント組織を作成します。 この操作には数分かかる場合があります。
Update-MgBetaTenantRelationshipMultiTenantOrganization -DisplayName "Cairo"
続行する前に操作が完了したことをチェックするには、Get-MgBetaTenantRelationshipMultiTenantOrganization コマンドを使用します。
Get-MgBetaTenantRelationshipMultiTenantOrganization | Format-List
CreatedDateTime : 1/8/2024 7:47:45 PM Description : DisplayName : Cairo Id : <MtoIdC> JoinRequest : Microsoft.Graph.Beta.PowerShell.Models.MicrosoftGraphMultiTenantOrganizationJoinRequestRecord State : active Tenants : AdditionalProperties : {[@odata.context, https://graph.microsoft.com/beta/$metadata#tenantRelationships/multiTenantOrganization/$entity]}
手順 3: キーを追加する
所有者テナント
所有者テナントで、New-MgBetaTenantRelationshipMultiTenantOrganizationTenant コマンドを使用して、マルチテナント組織にテナントを追加します。
New-MgBetaTenantRelationshipMultiTenantOrganizationTenant -TenantID $MemberTenantIdB -DisplayName "Berlin" | Format-List
New-MgBetaTenantRelationshipMultiTenantOrganizationTenant -TenantID $MemberTenantIdA -DisplayName "Athens" | Format-List
続行する前に操作が完了したことを確認するには、Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant コマンドを使用します。
Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant | Format-List
AddedByTenantId : <OwnerTenantId> AddedDateTime : 1/8/2024 7:47:45 PM DeletedDateTime : DisplayName : Cairo Id : <MtoIdC> JoinedDateTime : Role : owner State : active TenantId : <OwnerTenantId> TransitionDetails : Microsoft.Graph.Beta.PowerShell.Models.MicrosoftGraphMultiTenantOrganizationMemberTransitionDetails AdditionalProperties : {[multiTenantOrgLabelType, none]} AddedByTenantId : <OwnerTenantId> AddedDateTime : 1/8/2024 8:05:25 PM DeletedDateTime : DisplayName : Berlin Id : <MtoIdB> JoinedDateTime : Role : member State : pending TenantId : <MemberTenantIdB> TransitionDetails : Microsoft.Graph.Beta.PowerShell.Models.MicrosoftGraphMultiTenantOrganizationMemberTransitionDetails AdditionalProperties : {[multiTenantOrgLabelType, none]} AddedByTenantId : <OwnerTenantId> AddedDateTime : 1/8/2024 8:08:47 PM DeletedDateTime : DisplayName : Athens Id : <MtoIdA> JoinedDateTime : Role : member State : pending TenantId : <MemberTenantIdA> TransitionDetails : Microsoft.Graph.Beta.PowerShell.Models.MicrosoftGraphMultiTenantOrganizationMemberTransitionDetails AdditionalProperties : {[multiTenantOrgLabelType, none]}
手順 4: (省略可能) テナントのロールを変更する
所有者テナント
既定では、マルチテナント組織に追加されたテナントはメンバー テナントです。 必要に応じて、所有者テナントに変更できます。これにより、マルチテナント組織に他のテナントを追加できます。 所有者テナントをメンバー テナントに変更することもできます。
所有者テナントで、Update-MgBetaTenantRelationshipMultiTenantOrganizationTenant コマンドを使用して、メンバー テナントを所有者テナントに変更します。
Update-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId $MemberTenantIdB -Role "Owner" | Format-List
変更を確認するには、Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant コマンドを使用します。
Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId $MemberTenantIdB | Format-List
AddedByTenantId : <OwnerTenantId> AddedDateTime : 1/8/2024 8:05:25 PM DeletedDateTime : DisplayName : Berlin Id : <MtoIdB> JoinedDateTime : Role : owner State : pending TenantId : <MemberTenantIdB> TransitionDetails : Microsoft.Graph.Beta.PowerShell.Models.MicrosoftGraphMultiTenantOrganizationMemberTransitionDetails AdditionalProperties : {[@odata.context, https://graph.microsoft.com/beta/$metadata#tenantRelationships/multiTenantOrganization/tenants/$entity], [multiTenantOrgLabelType, none]}
手順 5: (省略可能) メンバー テナントを削除する
所有者テナント
自身のメンバー テナントを含め、任意のメンバー テナントを削除できます。 所有者テナントを削除することはできません。 また、所有者からメンバーに変更された場合でも、元の作成者テナントを削除することはできません。
所有者テナントで、Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant コマンドを使用して、メンバー テナントを削除します。 この操作は、数分かかります。
Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId <MemberTenantIdD>
変更を確認するには、Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant コマンドを使用します。
Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId <MemberTenantIdD>
削除コマンドが完了すると、出力は次のようになります。 これは予期されるエラー メッセージです。 これは、テナントがマルチテナント組織から削除されたことを示します。
Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant_Get: Unable to read the company information from the directory. Status: 404 (NotFound) ErrorCode: Directory_ObjectNotFound Date: 2024-01-08T20:35:11 ...
手順 6: メンバー テナントにサインインする
メンバー テナント
Cairo テナントは、マルチテナント組織を作成し、Berlin テナントと Athens テナントを追加しました。 これらの手順では、Berlin テナントにサインインし、Cairo によって作成されたマルチテナント組織に参加します。
PowerShell を開始します。
Connect-MgGraph コマンドを使用してメンバー テナントにサインインし、次の必要なアクセス許可に同意します。
MultiTenantOrganization.ReadWrite.All
Policy.Read.All
Policy.ReadWrite.CrossTenantAccess
Application.ReadWrite.All
Directory.ReadWrite.All
Connect-MgGraph -TenantId $MemberTenantIdB -Scopes "MultiTenantOrganization.ReadWrite.All","Policy.Read.All","Policy.ReadWrite.CrossTenantAccess","Application.ReadWrite.All","Directory.ReadWrite.All"
手順 7: マルチテナント組織に参加する
メンバー テナント
メンバー テナントで、Update-MgBetaTenantRelationshipMultiTenantOrganizationJoinRequest コマンドを使用して、マルチテナント組織に参加します。
Update-MgBetaTenantRelationshipMultiTenantOrganizationJoinRequest -AddedByTenantId $OwnerTenantId | Format-List
参加を確認するには、Get-MgBetaTenantRelationshipMultiTenantOrganizationJoinRequest コマンドを使用します。
Get-MgBetaTenantRelationshipMultiTenantOrganizationJoinRequest | Format-List
AddedByTenantId : <OwnerTenantId> Id : <MtoJoinRequestIdB> MemberState : active Role : member TransitionDetails : Microsoft.Graph.Beta.PowerShell.Models.MicrosoftGraphMultiTenantOrganizationJoinRequestTransitionDetails AdditionalProperties : {[@odata.context, https://graph.microsoft.com/beta/$metadata#tenantRelationships/multiTenantOrganization/joinRequest/$entity]}
マルチテナント組織自体をチェックするには、Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant コマンドを使用します。 参加操作が反映されている必要があります。
Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant | Format-List
AddedByTenantId : <OwnerTenantId> AddedDateTime : 1/8/2024 8:05:25 PM DeletedDateTime : DisplayName : Berlin Id : <MtoJoinRequestIdB> JoinedDateTime : 1/8/2024 9:53:55 PM Role : member State : active TenantId : <MemberTenantIdB> TransitionDetails : Microsoft.Graph.Beta.PowerShell.Models.MicrosoftGraphMultiTenantOrganizationMemberTransitionDetails AdditionalProperties : {[multiTenantOrgLabelType, none]} AddedByTenantId : <OwnerTenantId> AddedDateTime : 1/8/2024 7:47:45 PM DeletedDateTime : DisplayName : Cairo Id : <Id> JoinedDateTime : Role : owner State : active TenantId : <OwnerTenantId> TransitionDetails : Microsoft.Graph.Beta.PowerShell.Models.MicrosoftGraphMultiTenantOrganizationMemberTransitionDetails AdditionalProperties : {[multiTenantOrgLabelType, none]}
非同期処理を許可するには、マルチテナント組織への参加が完了するまで最大 2 時間待機します。
手順 8: (省略可能) マルチテナント組織を離脱する
メンバー テナント
参加したマルチテナント組織を離脱することができます。 マルチテナント組織から自身のテナントを削除するプロセスは、マルチテナント組織から別のテナントを削除するプロセスと同じです。
テナントが唯一のマルチテナント組織所有者である場合は、新しいテナントをマルチテナント組織所有者に指定する必要があります。 手順については、「手順 4: (省略可能) テナントのロールを変更する」を参照してください
テナントで、Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant コマンドを使用して、テナントを削除します。 この操作は、数分かかります。
Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId <MemberTenantId>
手順 9: (省略可能) マルチテナント組織を削除する
所有者テナント
すべてのテナントを削除することで、マルチテナント組織を削除します。 最終的な所有者テナントを削除するプロセスは、他のすべてのメンバー テナントを削除するプロセスと同じです。
最後の所有者テナントで、Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant コマンドを使用して、テナントを削除します。 この操作は、数分かかります。
Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId $OwnerTenantId