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.
Voraussetzungen
Besitzermandant
- Informationen zur Lizenz finden Sie unter Lizenzanforderungen.
- Die Rolle Sicherheitsadministrator zum Konfigurieren mandantenübergreifender Zugriffseinstellungen und Vorlagen für die mehrmandantenfähige Organisation.
- Die Rolle Globaler Administratorzum Zustimmen zu den erforderlichen Berechtigungen.
Mitgliedsmandant
- Informationen zur Lizenz finden Sie unter Lizenzanforderungen.
- Die Rolle Sicherheitsadministrator zum Konfigurieren mandantenübergreifender Zugriffseinstellungen und Vorlagen für die mehrmandantenfähige Organisation.
- Die Rolle Globaler Administratorzum Zustimmen zu den erforderlichen Berechtigungen.
Schritt 1: Anmelden beim Besitzermandanten
Besitzermandant
Starten Sie PowerShell.
Installieren Sie bei Bedarf das Microsoft Graph PowerShell SDK.
Rufen Sie die Mandanten-ID der Besitzer- und Zielmandanten ab, und initialisieren Sie Variablen.
$OwnerTenantId = "<OwnerTenantId>" $MemberTenantIdB = "<MemberTenantIdB>" $MemberTenantIdA = "<MemberTenantIdA>"
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
Besitzermandant
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"
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
Besitzermandant
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
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
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.
Verwenden Sie im Besitzermandanten den Befehl Update-MgBetaTenantRelationshipMultiTenantOrganizationTenant, um einen Mitgliedsmandanten in einen Besitzermandanten zu ändern.
Update-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId $MemberTenantIdB -Role "Owner" | Format-List
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
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.
Verwenden Sie im Besitzermandanten den Befehl Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant, um einen Mitgliedsmandanten zu entfernen. Dieser Vorgang dauert einige Minuten.
Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId <MemberTenantIdD>
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
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.
Starten Sie PowerShell.
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
Mitgliedsmandant
Verwenden Sie im Mitgliedsmandanten den Befehl Update-MgBetaTenantRelationshipMultiTenantOrganizationJoinRequest, um der mehrinstanzenfähigen Organisation beizutreten.
Update-MgBetaTenantRelationshipMultiTenantOrganizationJoinRequest -AddedByTenantId $OwnerTenantId | Format-List
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]}
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]}
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
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.
Verwenden Sie im betreffenden Mandanten den Befehl Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant, um den Mandanten zu entfernen. Dieser Vorgang dauert einige Minuten.
Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId <MemberTenantId>
Schritt 9: (Optional) Löschen der mehrinstanzenfähigen Organisation
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.
Verwenden Sie im finalen Besitzermandanten den Befehl Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant, um den Mandanten zu entfernen. Dieser Vorgang dauert einige Minuten.
Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId $OwnerTenantId