Freigeben über


Konfigurieren einer mehrinstanzenfähigen Organisation mithilfe von PowerShell oder der Microsoft Graph-API

In diesem Artikel werden die wichtigsten Schritte zum Konfigurieren einer mehrinstanzenfähigen Organisation mithilfe von Microsoft Graph PowerShell oder der Microsoft Graph-API beschrieben. In diesem Artikel werden ein Beispielmandant mit der Rolle „Besitzer“ namens Cairo und zwei Mandanten mit der Rolle „Mitglied“ namens Berlin und Athens verwendet.

Wenn Sie stattdessen das Microsoft 365 Admin Center zum Konfigurieren einer mehrinstanzenfähigen Organisation verwenden möchten, lesen Sie die Artikel Einrichten einer mehrinstanzenfähigen Organisation in Microsoft 365 und Beitritt zu oder Verlassen einer mehrinstanzenfähigen Organisation in Microsoft 365. Informationen zum Konfigurieren von Microsoft Teams für Ihre Mehrmandanten-Organisation finden Sie unter Microsoft Teams-Desktopclient.

Diagramm: Eine Mehrmandanten-Organisation mit einem Besitzermandanten und zwei Mitgliedsmandanten

Voraussetzungen

Symbol für den Besitzermandanten
Besitzermandant

Symbol für den Mitgliedsmandanten
Mitgliedsmandant

Schritt 1: Anmelden beim Besitzermandanten

Symbol für den Besitzermandanten
Besitzermandant

  1. Starten Sie PowerShell.

  2. Installieren Sie bei Bedarf das Microsoft Graph PowerShell SDK.

  3. Rufen Sie die Mandanten-ID der Besitzer- und Zielmandanten ab, und initialisieren Sie Variablen.

    $OwnerTenantId = "<OwnerTenantId>"
    $MemberTenantIdB = "<MemberTenantIdB>"
    $MemberTenantIdA = "<MemberTenantIdA>"
    
  4. Verwenden Sie den Befehl Connect-MgGraph, um sich beim Besitzermandanten anzumelden und den folgenden erforderlichen Berechtigungen zuzustimmen.

    • 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"
    

Schritt 2: Erstellen einer Mehrmandanten-Organisation

Symbol für den Besitzermandanten
Besitzermandant

  1. Verwenden Sie im Besitzer-Mandanten den Befehl Update-MgTenantRelationshipMultiTenantOrganization, um Ihre mandantenfähige Organisation zu erstellen. Dieser Vorgang kann einige Minuten in Anspruch nehmen.

    Update-MgTenantRelationshipMultiTenantOrganization -DisplayName "Cairo"
    
  2. Verwenden Sie den Befehl "Get-MgTenantRelationshipMultiTenantOrganization ", um zu überprüfen, ob der Vorgang abgeschlossen wurde, bevor Sie fortfahren.

    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]}
    

Schritt 3: Hinzufügen von Mandanten

Symbol für den Besitzermandanten
Besitzermandant

  1. Verwenden Sie im Besitzer-Mandanten den Befehl New-MgTenantRelationshipMultiTenantOrganizationTenant, um Ihrer mandantenfähigen Organisation Mandanten hinzuzufügen.

    New-MgTenantRelationshipMultiTenantOrganizationTenant -TenantID $MemberTenantIdB -DisplayName "Berlin" | Format-List
    
    New-MgTenantRelationshipMultiTenantOrganizationTenant -TenantID $MemberTenantIdA -DisplayName "Athens" | Format-List
    
  2. Verwenden Sie den Befehl "Get-MgTenantRelationshipMultiTenantOrganizationTenant" , um zu überprüfen, ob der Vorgang abgeschlossen wurde, bevor Sie fortfahren.

    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]}
    

Schritt 4: (Optional) Ändern der Rolle eines Mandanten

Symbol für den Besitzermandanten
Besitzermandant

Standardmäßig sind Mandanten, die der Mehrmandanten-Organisation hinzugefügt werden, Mitgliedsmandanten. Optional können Sie sie in Besitzermandanten ändern, sodass sie der Mehrmandanten-Organisation weitere Mandanten hinzufügen können. Sie können einen Besitzermandanten auch in einen Mitgliedsmandanten ändern.

  1. Verwenden Sie im Eigentümer-Mandanten den Befehl Update-MgTenantRelationshipMultiTenantOrganizationTenant, um einen Member-Mandanten in einen Besitzer-Mandanten zu ändern.

    Update-MgTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId $MemberTenantIdB -Role "Owner" | Format-List
    
  2. Verwenden Sie den Befehl Get-MgTenantRelationshipMultiTenantOrganizationTenant, um die Änderung zu überprüfen.

    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]}
    

Schritt 5: (Optional) Entfernen eines Mitgliedsmandanten

Symbol für den Besitzermandanten
Besitzermandant

Sie können jeden Mitgliedsmandanten entfernen, einschließlich Ihres eigenen. Besitzermandanten können nicht entfernt werden. Zudem ist zu beachten, dass Sie den ursprünglichen Erstellermandanten nicht entfernen können, auch wenn seine Rolle von „Besitzer“ in „Mitglied“ geändert wurde.

  1. Verwenden Sie im Besitzer-Mandanten den Befehl Remove-MgTenantRelationshipMultiTenantOrganizationTenant, um einen Member-Mandanten zu entfernen. Dieser Vorgang dauert einige Minuten.

    Remove-MgTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId <MemberTenantIdD>
    
  2. Verwenden Sie den Befehl Get-MgTenantRelationshipMultiTenantOrganizationTenant, um die Änderung zu überprüfen.

    Get-MgTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId <MemberTenantIdD>
    

    Wenn der Entfernungsbefehl fertig ausgeführt wurde, sollten Sie eine Ausgabe ähnlich der folgenden erhalten. Diese Fehlermeldung wird erwartet. Sie gibt an, dass der Mandant aus der Mehrmandanten-Organisation entfernt wurde.

    Get-MgTenantRelationshipMultiTenantOrganizationTenant_Get: Unable to read the company information from the directory.
    
    Status: 404 (NotFound)
    ErrorCode: Directory_ObjectNotFound
    Date: 2024-01-08T20:35:11
    
    ...
    

Schritt 6: Anmelden bei einem Mitgliedsmandanten

Symbol für den Mitgliedsmandanten
Mitgliedsmandant

Der Mandant „Cairo“ erstellte eine Mehrmandanten-Organisation und fügte die Mandanten „Berlin“ und „Athens“ hinzu. In diesen Schritten melden Sie sich beim Mandanten „Berlin“ an und treten der von Cairo erstellten Mehrmandanten-Organisation bei.

  1. Starten Sie PowerShell.

  2. Verwenden Sie den Befehl Connect-MgGraph, um sich beim Mitgliedsmandanten anzumelden und den folgenden erforderlichen Berechtigungen zuzustimmen.

    • 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"
    

Schritt 7: Beitritt zur mehrinstanzenfähigen Organisation

Symbol für den Mitgliedsmandanten
Mitgliedsmandant

  1. Verwenden Sie im Mitglieds-Mandanten den Befehl Update-MgTenantRelationshipMultiTenantOrganizationJoinRequest, um der mandantenfähigen Organisation beizutreten.

    Update-MgTenantRelationshipMultiTenantOrganizationJoinRequest -AddedByTenantId $OwnerTenantId | Format-List
    
  2. Verwenden Sie den Befehl Get-MgTenantRelationshipMultiTenantOrganizationJoinRequest, um den Beitritt zu überprüfen.

    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. Verwenden Sie den Befehl Get-MgTenantRelationshipMultiTenantOrganizationTenant, um die mandantenfähige Organisation selbst zu überprüfen. Sie sollte den Beitrittsvorgang widerspiegeln.

    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. Um die asynchrone Verarbeitung zu ermöglichen, warten Sie bis zu 2 Stunden, bis der Beitritt zu einer mehrmandantenfähigen Organisation abgeschlossen ist.

Schritt 8: (Optional) Verlassen der Mehrmandanten-Organisation

Symbol für den Mitgliedsmandanten
Mitgliedsmandant

Sie können eine Mehrmandanten-Organisation, der Sie beigetreten sind, verlassen. Der Prozess zum Entfernen Ihres eigenen Mandanten aus der mehrmandantenfähigen Organisation ist mit dem Prozess zum Entfernen eines anderen Mandanten aus der mehrmandantenfähigen Organisation identisch.

Wenn Ihr Mandant der einzige Besitzer der mehrmandantenfähigen Organisation ist, müssen Sie einen neuen Mandanten als Besitzer der mehrmandantenfähigen Organisation festlegen. Anleitungsschritte finden Sie unter Schritt 4: (Optional) Ändern der Rolle eines Mandanten.

Schritt 9: (Optional) Löschen der Mehrmandanten-Organisation

Symbol für den Besitzermandanten
Besitzermandant

Sie löschen eine mehrmandantenfähige Organisation, indem Sie alle Mandanten entfernen. Der Prozess zum Entfernen des letzten Besitzermandanten ist identisch mit dem zum Entfernen aller anderen Mitgliedsmandanten.

  • Im endgültigen Besitzer-Mandanten verwenden Sie den Befehl Remove-MgTenantRelationshipMultiTenantOrganizationTenant, um den Mandanten zu entfernen. Dieser Vorgang dauert einige Minuten.

    Remove-MgTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId $OwnerTenantId
    

Nächste Schritte