Teilen ü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 mandantenfähige Organisation finden Sie unter Der Microsoft Teams-Desktopclient.

Diagramm: Eine mehrinstanzenfähige 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 mehrmandantenfähigen Organisation

Symbol für den Besitzermandanten
Besitzermandant

  1. Verwenden Sie im Besitzermandanten den Befehl Update-MgBetaTenantRelationshipMultiTenantOrganization, um Ihre mehrinstanzenfähige Organisation zu erstellen. Dieser Vorgang kann einige Minuten in Anspruch nehmen.

    Update-MgBetaTenantRelationshipMultiTenantOrganization -DisplayName "Cairo"
    
  2. Stellen Sie mithilfe des Befehls Get-MgBetaTenantRelationshipMultiTenantOrganization sicher, dass der Vorgang abgeschlossen ist, bevor Sie fortfahren.

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

Schritt 3: Hinzufügen von Mandanten

Symbol für den Besitzermandanten
Besitzermandant

  1. Verwenden Sie im Besitzermandanten den Befehl New-MgBetaTenantRelationshipMultiTenantOrganizationTenant, um Ihrer mehrinstanzenfähigen Organisation Mandanten hinzuzufügen.

    New-MgBetaTenantRelationshipMultiTenantOrganizationTenant -TenantID $MemberTenantIdB -DisplayName "Berlin" | Format-List
    
    New-MgBetaTenantRelationshipMultiTenantOrganizationTenant -TenantID $MemberTenantIdA -DisplayName "Athens" | Format-List
    
  2. Stellen Sie mithilfe des Befehls Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant sicher, dass der Vorgang abgeschlossen ist, bevor Sie fortfahren.

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

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

Symbol für den Besitzermandanten
Besitzermandant

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

  1. Verwenden Sie im Besitzermandanten den Befehl Update-MgBetaTenantRelationshipMultiTenantOrganizationTenant, um einen Mitgliedsmandanten in einen Besitzermandanten zu ändern.

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

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

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 Besitzermandanten den Befehl Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant, um einen Mitgliedsmandanten zu entfernen. Dieser Vorgang dauert einige Minuten.

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

    Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant -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 mehrmandantenfähigen Organisation entfernt wurde.

    Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant_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 mehrmandantenfähige 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 mehrinstanzenfähigen 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 Mitgliedsmandanten den Befehl Update-MgBetaTenantRelationshipMultiTenantOrganizationJoinRequest, um der mehrinstanzenfähigen Organisation beizutreten.

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

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

    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. Warten Sie bis zu 2 Stunden, bis der Beitritt zu einer mehrinstanzenfähigen Organisation abgeschlossen ist, um eine asynchrone Verarbeitung zu ermöglichen.

Schritt 8: (Optional) Verlassen der mehrinstanzenfähigen Organisation

Symbol für den Mitgliedsmandanten
Mitgliedsmandant

Sie können eine mehrmandantenfähige 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 mehrinstanzenfähigen 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.

Nächste Schritte