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

1. PowerShell を開始します。

2. 必要に応じて、Microsoft Graph PowerShell SDK をインストールします。

3. 所有者とメンバーのテナントのテナント ID を取得し、変数を初期化します。

   $OwnerTenantId = "<OwnerTenantId>"
   $MemberTenantIdB = "<MemberTenantIdB>"
   $MemberTenantIdA = "<MemberTenantIdA>"
   

4. 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"
   

Microsoft Graph

以下の手順では、Microsoft Graph Explorer を使用する方法について説明しますが、別の REST API クライアントを使用することもできます。

1. Microsoft Graph Explorer ツールを起動します。

2. 所有者テナントにサインインします。

3. プロファイルを選択し、[Consent to permissions] (アクセス許可に同意する) を選択します。

4. 次の必要なアクセス許可に同意します。

   • MultiTenantOrganization.ReadWrite.All
   • Policy.Read.All
   • Policy.ReadWrite.CrossTenantAccess
   • Application.ReadWrite.All
   • Directory.ReadWrite.All

手順 2: マルチテナント組織を作成する

所有者テナント

PowerShell

1. 所有者テナントで、Update-MgBetaTenantRelationshipMultiTenantOrganization コマンドを使用して、マルチテナント組織を作成します。 この操作には数分かかる場合があります。

   Update-MgBetaTenantRelationshipMultiTenantOrganization -DisplayName "Cairo"
   

2. 続行する前に操作が完了したことをチェックするには、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]}
   

Microsoft Graph

1. 所有者テナントで、create multiTenantOrganization API を使用してマルチテナント組織を作成します。 この操作には数分かかる場合があります。

   Request

   PUT https://graph.microsoft.com/beta/tenantRelationships/multiTenantOrganization
   {
       "displayName": "Cairo"
   }
   

2. 続行する前に操作が完了したことをチェックするには、Get multiTenantOrganization API を使用します。

   Request

   GET https://graph.microsoft.com/beta/tenantRelationships/multiTenantOrganization
   

   回答

   {
       "@odata.context": "https://graph.microsoft.com/beta/$metadata#tenantRelationships/multiTenantOrganization/$entity",
       "id": "{mtoId}",
       "createdDateTime": "2023-11-20T20:38:20Z",
       "state": "active",
       "displayName": "Cairo",
       "description": null
   }
   

手順 3: キーを追加する

所有者テナント

PowerShell

1. 所有者テナントで、New-MgBetaTenantRelationshipMultiTenantOrganizationTenant コマンドを使用して、マルチテナント組織にテナントを追加します。

   New-MgBetaTenantRelationshipMultiTenantOrganizationTenant -TenantID $MemberTenantIdB -DisplayName "Berlin" | Format-List
   

   New-MgBetaTenantRelationshipMultiTenantOrganizationTenant -TenantID $MemberTenantIdA -DisplayName "Athens" | Format-List
   

2. 続行する前に操作が完了したことを確認するには、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]}
   

Microsoft Graph

1. 所有者テナントで、add multiTenantOrganizationMember API を使用して、マルチテナント組織にテナントを追加します。

   Request

   POST https://graph.microsoft.com/beta/tenantRelationships/multiTenantOrganization/tenants
   {
       "tenantId": "{memberTenantIdB}",
       "displayName": "Berlin"
   }
   

   Request

   POST https://graph.microsoft.com/beta/tenantRelationships/multiTenantOrganization/tenants
   {
       "tenantId": "{memberTenantIdA}",
       "displayName": "Athens"
   }
   

2. 続行する前に操作が完了したことを確認するには、List multiTenantOrganizationMembers API を使用します。

   Request

   GET https://graph.microsoft.com/beta/tenantRelationships/multiTenantOrganization/tenants
   

   回答

   {
       "@odata.context": "https://graph.microsoft.com/beta/$metadata#tenantRelationships/multiTenantOrganization/tenants"
       "value": [
           {
               "tenantId": "{ownerTenantId}",
               "displayName": "Cairo",
               "addedDateTime": "2023-11-20T20:38:20Z",
               "joinedDateTime": null,
               "addedByTenantId": "{ownerTenantId}",
               "role": "owner",
               "state": "active",
               "transitionDetails": null
           },
           {
               "tenantId": "{memberTenantIdB}",
               "displayName": "Berlin",
               "addedDateTime": "2023-11-20T21:22:35Z",
               "joinedDateTime": null,
               "addedByTenantId": "{ownerTenantId}",
               "role": "member",
               "state": "pending",
               "transitionDetails": {
                   "desiredState": "active",
                   "desiredRole": "member",
                   "status": "notStarted",
                   "details": null
               }
           },
           {
               "tenantId": "{memberTenantIdA}",
               "displayName": "Athens",
               "addedDateTime": "2023-11-20T21:24:59Z",
               "joinedDateTime": null,
               "addedByTenantId": "{ownerTenantId}",
               "role": "member",
               "state": "pending",
               "transitionDetails": {
                   "desiredState": "active",
                   "desiredRole": "member",
                   "status": "notStarted",
                   "details": null
               }
           }
       ]
   }
   

手順 4: (省略可能) テナントのロールを変更する

所有者テナント

既定では、マルチテナント組織に追加されたテナントはメンバー テナントです。 必要に応じて、所有者テナントに変更できます。これにより、マルチテナント組織に他のテナントを追加できます。 所有者テナントをメンバー テナントに変更することもできます。

PowerShell

1. 所有者テナントで、Update-MgBetaTenantRelationshipMultiTenantOrganizationTenant コマンドを使用して、メンバー テナントを所有者テナントに変更します。

   Update-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId $MemberTenantIdB -Role "Owner" | Format-List
   

2. 変更を確認するには、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]}
   

Microsoft Graph

1. 所有者テナントで、update multiTenantOrganizationMember API を使用して、メンバー テナントを所有者テナントに変更します。

   Request

   PATCH https://graph.microsoft.com/beta/tenantRelationships/multiTenantOrganization/tenants/{memberTenantIdB}
   {
       "role": "owner"
   }
   

2. Get MultiTenantOrganizationMember API を使用して、変更を確認します。

   Request

   GET https://graph.microsoft.com/beta/tenantRelationships/multiTenantOrganization/tenants/{memberTenantIdB}
   

   回答

   {
       "@odata.context": "https://graph.microsoft.com/beta/$metadata#tenantRelationships/multiTenantOrganization/tenants/$entity",
       "tenantId": "{memberTenantIdB}",
       "displayName": "Berlin",
       "addedDateTime": "2023-11-20T21:22:35Z",
       "joinedDateTime": null,
       "addedByTenantId": "{ownerTenantId}",
       "role": "member",
       "state": "pending",
       "transitionDetails": {
           "desiredState": "active",
           "desiredRole": "owner",
           "status": "notStarted",
           "details": null
       } 
   }
   

3. Update multiTenantOrganizationMember API を使用して、所有者テナントを所有者テナントに変更します。

   Request

   PATCH https://graph.microsoft.com/beta/tenantRelationships/multiTenantOrganization/tenants/{memberTenantIdB}
   {
       "role": "member"
   }
   

手順 5: (省略可能) メンバー テナントを削除する

所有者テナント

自身のメンバー テナントを含め、任意のメンバー テナントを削除できます。 所有者テナントを削除することはできません。 また、所有者からメンバーに変更された場合でも、元の作成者テナントを削除することはできません。

PowerShell

1. 所有者テナントで、Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant コマンドを使用して、メンバー テナントを削除します。 この操作は、数分かかります。

   Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId <MemberTenantIdD>
   

2. 変更を確認するには、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
   
   ...
   

Microsoft Graph

1. 所有者テナントで、Remove multiTenantOrganizationMember API を使用して、メンバー テナントを削除します。 この操作は、数分かかります。

   Request

   DELETE https://graph.microsoft.com/beta/tenantRelationships/multiTenantOrganization/tenants/{memberTenantIdD}
   

2. Get MultiTenantOrganizationMember API を使用して、変更を確認します。

   Request

   GET https://graph.microsoft.com/beta/tenantRelationships/multiTenantOrganization/tenants/{memberTenantIdD}
   

   remove API を呼び出した直後にチェックすると、次と同様の応答が表示されます。

   回答

   {
       "@odata.context": "https://graph.microsoft.com/beta/$metadata#tenantRelationships/multiTenantOrganization/tenants/$entity",
       "tenantId": "{memberTenantIdD}",
       "displayName": "Denver",
       "addedDateTime": "2023-11-20T20:56:05Z",
       "joinedDateTime": null,
       "addedByTenantId": "{ownerTenantId}",
       "role": "member",
       "state": "pending",
       "transitionDetails": {
           "desiredState": "removed",
           "desiredRole": "member",
           "status": "notStarted",
           "details": null
       }
   }
   

   削除操作の完了後、応答は次と同様のものになります。 これは予期されるエラー メッセージです。 これは、テナントがマルチテナント組織から削除されたことを示します。

   回答

   {
       "error": {
           "code": "Directory_ObjectNotFound",
           "message": "Unable to read the company information from the directory.",
           "innerError": {
               "date": "2023-11-20T21:09:53",
               "request-id": "75216961-c21d-49ed-8c1f-2cfe51f920f1",
               "client-request-id": "30129b19-51e8-41ed-8ba0-1501bac03802"
           }
       }
   }
   

手順 6: メンバー テナントにサインインする

メンバー テナント

Cairo テナントは、マルチテナント組織を作成し、Berlin テナントと Athens テナントを追加しました。 これらの手順では、Berlin テナントにサインインし、Cairo によって作成されたマルチテナント組織に参加します。

PowerShell

1. PowerShell を開始します。

2. 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"
   

Microsoft Graph

1. Microsoft Graph Explorer ツールを起動します。

2. メンバー テナントにサインインします。

3. プロファイルを選択し、[Consent to permissions] (アクセス許可に同意する) を選択します。

4. 次の必要なアクセス許可に同意します。

   • MultiTenantOrganization.ReadWrite.All
   • Policy.Read.All
   • Policy.ReadWrite.CrossTenantAccess
   • Application.ReadWrite.All
   • Directory.ReadWrite.All

手順 7: マルチテナント組織に参加する

メンバー テナント

PowerShell

1. メンバー テナントで、Update-MgBetaTenantRelationshipMultiTenantOrganizationJoinRequest コマンドを使用して、マルチテナント組織に参加します。

   Update-MgBetaTenantRelationshipMultiTenantOrganizationJoinRequest -AddedByTenantId $OwnerTenantId | Format-List
   

2. 参加を確認するには、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]}
   

3. マルチテナント組織自体をチェックするには、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]}
   

4. 非同期処理を許可するには、マルチテナント組織への参加が完了するまで最大 2 時間待機します。

Microsoft Graph

1. メンバー テナントで、Update multiTenantOrganizationJoinRequestRecord API を使用してマルチテナント組織に参加します。

   Request

   PATCH https://graph.microsoft.com/beta/tenantRelationships/multiTenantOrganization/joinRequest
   {
       "addedByTenantId": "{ownerTenantId}"
   }
   

2. Get multiTenantOrganizationJoinRequestRecord API を使用して、参加を確認します。

   Request

   GET https://graph.microsoft.com/beta/tenantRelationships/multiTenantOrganization/joinRequest
   

   この操作は、数分かかります。 参加する API を呼び出した直後にチェックした場合、応答は次と同様のものになります。

   回答

   {
       "@odata.context": "https://graph.microsoft.com/beta/$metadata#tenantRelationships/multiTenantOrganization/joinRequest/$entity",
       "id": "aa87e8a4-9c88-4e67-971d-79c9e43319a3",
       "addedByTenantId": "{ownerTenantId}",
       "memberState": "pending",
       "role": null,
       "transitionDetails": {
           "desiredMemberState": "active",
           "status": "notStarted",
           "details": ""
       }
   }
   

   参加操作の完了後、応答は次と同様のものになります。

   回答

   {
       "@odata.context": "https://graph.microsoft.com/beta/$metadata#tenantRelationships/multiTenantOrganization/joinRequest/$entity",
       "id": "aa87e8a4-9c88-4e67-971d-79c9e43319a3",
       "addedByTenantId": "{ownerTenantId}",
       "memberState": "active",
       "role": "member",
       "transitionDetails": null
   }
   

3. List multiTenantOrganizationMembers API を使用して、マルチテナント組織自体をチェックします。 参加操作が反映されている必要があります。

   Request

   GET https://graph.microsoft.com/beta/tenantRelationships/multiTenantOrganization/tenants
   

   回答

   {
       "@odata.context": "https://graph.microsoft.com/beta/$metadata#tenantRelationships/multiTenantOrganization/tenants",
       "value": [
           {
               "tenantId": "{memberTenantIdA}",
               "displayName": "Athens",
               "addedDateTime": "2023-11-20T21:24:59Z",
               "joinedDateTime": "2023-11-21T22:09:18Z",
               "addedByTenantId": "{ownerTenantId}",
               "role": "member",
               "state": "active",
               "transitionDetails": null
           },
           {
               "tenantId": "{memberTenantIdB}",
               "displayName": "Berlin",
               "addedDateTime": "2023-11-20T21:22:35Z",
               "joinedDateTime": "2023-11-21T21:55:34Z",
               "addedByTenantId": "{ownerTenantId}",
               "role": "member",
               "state": "active",
               "transitionDetails": null
           },
           {
               "tenantId": "{ownerTenantId}",
               "displayName": "Cairo",
               "addedDateTime": "2023-11-20T20:38:20Z",
               "joinedDateTime": null,
               "addedByTenantId": "{ownerTenantId}",
               "role": "owner",
               "state": "active",
               "transitionDetails": null
           }
       ]
   }
   

4. 非同期処理を許可するには、マルチテナント組織への参加が完了するまで最大 2 時間待機します。

手順 8: (省略可能) マルチテナント組織を離脱する

メンバー テナント

参加したマルチテナント組織を離脱することができます。 マルチテナント組織から自身のテナントを削除するプロセスは、マルチテナント組織から別のテナントを削除するプロセスと同じです。

テナントが唯一のマルチテナント組織所有者である場合は、新しいテナントをマルチテナント組織所有者に指定する必要があります。 手順については、「手順 4: (省略可能) テナントのロールを変更する」を参照してください

PowerShell

• テナントで、Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant コマンドを使用して、テナントを削除します。 この操作は、数分かかります。

  Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId <MemberTenantId>
  

Microsoft Graph

• テナントで、Remove multiTenantOrganizationMember API を使用して、メンバー テナントを削除します。 この操作は、数分かかります。

  Request

  DELETE https://graph.microsoft.com/beta/tenantRelationships/multiTenantOrganization/tenants/{memberTenantId}
  

手順 9: (省略可能) マルチテナント組織を削除する

所有者テナント

すべてのテナントを削除することで、マルチテナント組織を削除します。 最終的な所有者テナントを削除するプロセスは、他のすべてのメンバー テナントを削除するプロセスと同じです。

PowerShell

• 最後の所有者テナントで、Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant コマンドを使用して、テナントを削除します。 この操作は、数分かかります。

  Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId $OwnerTenantId
  

Microsoft Graph

• 所有者テナントで、Remove multiTenantOrganizationMember API を使用して、テナントを削除します。 この操作は、数分かかります。

  Request

  DELETE https://graph.microsoft.com/beta/tenantRelationships/multiTenantOrganization/tenants/{ownerTenantId}
  

次のステップ

• Microsoft 365 でマルチテナント組織を設定する
• Microsoft 365 のマルチテナント組織のユーザーを同期する
• 新しい Microsoft Teams デスクトップ クライアント
• Microsoft Graph API を使用してマルチテナント組織テンプレートを構成する