使用 PowerShell 或 Microsoft Graph API 來設定多租用戶組織

本文說明使用 Microsoft Graph PowerShell 或 Microsoft Graph API 設定多租用戶組織的重要步驟。 本文使用範例擁有者租戶名稱為開羅，以及兩個成員租戶名稱分別為柏林和雅典。

如果您想要改用 Microsoft 365 系統管理中心設定多租用戶組織，請參閱 在 Microsoft 365 中設定多租用戶組織，加入或離開 Microsoft 365 中的多租用戶組織。 若要了解如何為多租用戶組織設定 Microsoft Teams，請參閱 Microsoft Teams 桌面用戶端。

必要條件

擁有者租用戶

• 如需授權資訊，請參閱授權需求。
• 安全性系統管理員角色，設定多租用戶組織的跨租用戶存取設定和範本。
• 特權角色管理員 角色授予所需的許可權。

會員租戶

• 如需授權資訊，請參閱授權需求。
• 安全性系統管理員角色，設定多租用戶組織的跨租用戶存取設定和範本。
• 特權角色管理員 角色授予所需的許可權。

步驟 1：登入擁有者租戶

擁有者租用戶

PowerShell

1. 啟動 PowerShell。

2. 視需要安裝 Microsoft Graph PowerShell SDK。

3. 取得擁有者和成員租用戶的租用戶識別碼，並初始化變數。

   $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 瀏覽器工具。

2. 登入擁有者的租戶。

3. 選取您的個人資料，然後選取同意權限。

4. 同意下列必要權限。

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

步驟 2：建立多租用戶組織

擁有者租用戶

PowerShell

1. 在擁有者租戶中，使用 Update-MgTenantRelationshipMultiTenantOrganization 命令來建立您的多租戶組織。 此作業可能需要數分鐘。

   Update-MgTenantRelationshipMultiTenantOrganization -DisplayName "Cairo"
   

2. 在繼續操作之前，使用 Get-MgTenantRelationshipMultiTenantOrganization 命令檢查作業是否已完成。

   Get-MgTenantRelationshipMultiTenantOrganization | Format-List
   

   CreatedDateTime      : 1/8/2024 7:47:45 PM
   Description          :
   DisplayName          : Cairo
   Id                   : <MtoIdC>
   JoinRequest          : Microsoft.Graph.PowerShell.Models.MicrosoftGraphMultiTenantOrganizationJoinRequestRecord
   State                : active
   Tenants              :
   AdditionalProperties : {[@odata.context, https://graph.microsoft.com/v1.0/$metadata#tenantRelationships/multiTenantOrganization/$entity]}
   

Microsoft Graph

1. 在主租戶中，使用 Create multiTenantOrganization API 來建立您的多租戶組織。 此作業可能需要數分鐘。

   要求

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

2. 使用取得 multiTenantOrganization API，檢查作業是否已完成後再繼續。

   要求

   GET https://graph.microsoft.com/v1.0/tenantRelationships/multiTenantOrganization
   

   回應

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

步驟 3：新增租用戶

擁有者租用戶

PowerShell

1. 在擁有者租戶中，使用 New-MgTenantRelationshipMultiTenantOrganizationTenant 命令，將租戶新增至您的多租戶組織。

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

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

2. 使用 Get-MgTenantRelationshipMultiTenantOrganizationTenant 命令，以在繼續作業之前確認其已完成。

   Get-MgTenantRelationshipMultiTenantOrganizationTenant | 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.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.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.PowerShell.Models.MicrosoftGraphMultiTenantOrganizationMemberTransitionDetails
   AdditionalProperties : {[multiTenantOrgLabelType, none]}
   

Microsoft Graph

1. 在擁有者租戶中，使用Add multiTenantOrganizationMember API，將租戶新增至多租戶組織。

   要求

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

   要求

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

2. 使用 List multiTenantOrganizationMembers API 來驗證作業是否已完成，然後再繼續。

   要求

   GET https://graph.microsoft.com/v1.0/tenantRelationships/multiTenantOrganization/tenants
   

   回應

   {
       "@odata.context": "https://graph.microsoft.com/v1.0/$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-MgTenantRelationshipMultiTenantOrganizationTenant 命令，將成員租用戶變更為擁有者租用戶。

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

2. 使用 Get-MgTenantRelationshipMultiTenantOrganizationTenant 命令來驗證變更。

   Get-MgTenantRelationshipMultiTenantOrganizationTenant -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.PowerShell.Models.MicrosoftGraphMultiTenantOrganizationMemberTransitionDetails
   AdditionalProperties : {[@odata.context, https://graph.microsoft.com/v1.0/$metadata#tenantRelationships/multiTenantOrganization/tenants/$entity],
                          [multiTenantOrgLabelType, none]}
   

Microsoft Graph

1. 在擁有者租用戶中，使用 Update multiTenantOrganizationMember API，將成員租用戶變更為擁有者租用戶。

   要求

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

2. 使用取得 multiTenantOrganizationMember API，驗證該變更。

   要求

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

   回應

   {
       "@odata.context": "https://graph.microsoft.com/v1.0/$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，將擁有者租用戶變更為成員租用戶。

   要求

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

步驟 5：(選擇性) 移除成員租用戶

擁有者租用戶

您可以移除包含您自己在內的任何成員租用戶。 您無法移除屋主租戶。 此外，即使原始建立者租戶已從擁有者變更為成員，您也無法移除它。

PowerShell

1. 在擁有者租戶中，使用 Remove-MgTenantRelationshipMultiTenantOrganizationTenant 命令來移除任何成員租戶。 此作業需要幾分鐘的時間。

   Remove-MgTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId <MemberTenantIdD>
   

2. 使用 Get-MgTenantRelationshipMultiTenantOrganizationTenant 命令來驗證變更。

   Get-MgTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId <MemberTenantIdD>
   

   完成移除命令之後，會出現類似於下列的輸出。 此為預期錯誤訊息。 此訊息表示租用戶已從多租用戶組織中移除。

   Get-MgTenantRelationshipMultiTenantOrganizationTenant_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 移除任何成員租用戶。 此作業需要幾分鐘的時間。

   要求

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

2. 使用取得 multiTenantOrganizationMember API，驗證該變更。

   要求

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

   如果您在呼叫移除 API 之後立即檢查，會顯示類似下列的回應。

   回應

   {
       "@odata.context": "https://graph.microsoft.com/v1.0/$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": "0000aaaa-11bb-cccc-dd22-eeeeee333333"
           }
       }
   }
   

步驟 6：登入成員租戶

會員租戶

開羅租用戶已建立多租用戶組織，並新增柏林和雅典租用戶。 在這些步驟中，您會登入柏林租用戶帳號，並加入由開羅所建立的多租用戶組織。

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 瀏覽器工具。

2. 登入成員租用戶。

3. 選取您的個人資料，然後選取同意權限。

4. 同意下列必要權限。

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

步驟 7：加入多租用戶組織

會員租戶

PowerShell

1. 在成員租戶中，使用 Update-MgTenantRelationshipMultiTenantOrganizationJoinRequest 命令來加入多承租組織。

   Update-MgTenantRelationshipMultiTenantOrganizationJoinRequest -AddedByTenantId $OwnerTenantId | Format-List
   

2. 使用 Get-MgTenantRelationshipMultiTenantOrganizationJoinRequest 命令來驗證加入。

   Get-MgTenantRelationshipMultiTenantOrganizationJoinRequest | Format-List
   

   AddedByTenantId      : <OwnerTenantId>
   Id                   : <MtoJoinRequestIdB>
   MemberState          : active
   Role                 : member
   TransitionDetails    : Microsoft.Graph.PowerShell.Models.MicrosoftGraphMultiTenantOrganizationJoinRequestTransitionDetails
   AdditionalProperties : {[@odata.context, https://graph.microsoft.com/v1.0/$metadata#tenantRelationships/multiTenantOrganization/joinRequest/$entity]}
   

3. 使用 Get-MgTenantRelationshipMultiTenantOrganizationTenant 命令來檢查多租用戶組織本身。 這樣應該能表示聯結操作。

   Get-MgTenantRelationshipMultiTenantOrganizationTenant | 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.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.PowerShell.Models.MicrosoftGraphMultiTenantOrganizationMemberTransitionDetails
   AdditionalProperties : {[multiTenantOrgLabelType, none]}
   

4. 若要允許非同步處理，在完成加入多租用戶組織之前，要等候最多 2 小時。

Microsoft Graph

1. 在成員租戶中，使用 Update multiTenantOrganizationJoinRequestRecord API，加入多重租戶組織。

   要求

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

2. 使用 Get multiTenantOrganizationJoinRequestRecord API，以驗證聯結。

   要求

   GET https://graph.microsoft.com/v1.0/tenantRelationships/multiTenantOrganization/joinRequest
   

   此作業需要幾分鐘的時間。 如果您在呼叫加入 API 之後立即檢查，會出現類似於下列的回應。

   回應

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

3. 使用 List multiTenantOrganizationMembers API，檢查該多租戶組織本身。 這樣應該能表示聯結操作。

   要求

   GET https://graph.microsoft.com/v1.0/tenantRelationships/multiTenantOrganization/tenants
   

   回應

   {
       "@odata.context": "https://graph.microsoft.com/v1.0/$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-MgTenantRelationshipMultiTenantOrganizationTenant 命令來移除租戶。 此作業需要幾分鐘的時間。

  Remove-MgTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId <MemberTenantId>
  

Microsoft Graph

• 在租用戶中，使用 Remove multiTenantOrganizationMember API，移除該租用戶。 此作業需要幾分鐘的時間。

  要求

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

步驟 9：(選擇性) 刪除多租用戶組織

擁有者租用戶

您可以透過移除所有租用戶來刪除多租戶組織。 移除最終擁有者租用戶的流程，與移除其餘所有成員租用戶的流程相同。

PowerShell

• 在最終的擁有者租戶中，使用 Remove-MgTenantRelationshipMultiTenantOrganizationTenant 命令來移除租戶。 此作業需要幾分鐘的時間。

  Remove-MgTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId $OwnerTenantId
  

Microsoft Graph

• 在最終租戶擁有者中，使用 Remove multiTenantOrganizationMember API 來移除該租戶。 此作業需要幾分鐘的時間。

  要求

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

下一步

• 在 Microsoft 365 中設定多重租戶組織
• 在 Microsoft 365 中，將多租戶組織內的使用者同步化
• 新的 Microsoft Teams 桌面用戶端
• 使用 Microsoft Graph API，設定多租用戶組織範本