Delen via


Een multitenant-organisatie configureren met Behulp van PowerShell of Microsoft Graph API

In dit artikel worden de belangrijkste stappen beschreven voor het configureren van een multitenant-organisatie met behulp van Microsoft Graph PowerShell of Microsoft Graph API. In dit artikel wordt een voorbeeld van een eigenaartenant genaamd Cairo en twee lidtenants met de naam Berlijn en Athene gebruikt.

Als u in plaats daarvan de Microsoft 365-beheercentrum wilt gebruiken om een multitenant-organisatie te configureren, raadpleegt u Een organisatie met meerdere tenants instellen in Microsoft 365 en lid worden of een multitenant-organisatie verlaten in Microsoft 365. Zie de nieuwe Bureaubladclient van Microsoft Teams voor meer informatie over het configureren van Microsoft Teams voor uw multitenant-organisatie.

Diagram met een multitenant-organisatie met één eigenaartenant en twee lidtenanttenants.

Vereisten

Pictogram voor de eigenaartenant.
Tenant eigenaar

Pictogram voor de lidtenant.
Lidtenant

Stap 1: Aanmelden bij de tenant van de eigenaar

Pictogram voor de eigenaartenant.
Tenant eigenaar

  1. Start PowerShell.

  2. Installeer zo nodig de Microsoft Graph PowerShell SDK.

  3. Haal de tenant-id op van de tenants van de eigenaar en leden en initialiseer variabelen.

    $OwnerTenantId = "<OwnerTenantId>"
    $MemberTenantIdB = "<MemberTenantIdB>"
    $MemberTenantIdA = "<MemberTenantIdA>"
    
  4. Gebruik de opdracht Verbinding maken-MgGraph om u aan te melden bij de tenant van de eigenaar en toestemming te geven voor de volgende vereiste machtigingen.

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

Stap 2: Een multitenant-organisatie maken

Pictogram voor de eigenaartenant.
Tenant eigenaar

  1. Gebruik in de tenant van de eigenaar de opdracht Update-MgBetaTenantRelationshipMultiTenantOrganization om uw multitenant-organisatie te maken. Deze bewerking kan enkele minuten duren.

    Update-MgBetaTenantRelationshipMultiTenantOrganization -DisplayName "Cairo"
    
  2. Gebruik de opdracht Get-MgBetaTenantRelationshipMultiTenantOrganization om te controleren of de bewerking is voltooid voordat u doorgaat.

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

Stap 3: Tenants toevoegen

Pictogram voor de eigenaartenant.
Tenant eigenaar

  1. Gebruik in de tenant van de eigenaar de opdracht New-MgBetaTenantRelationshipMultiTenantOrganizationTenant om tenants toe te voegen aan uw multitenant-organisatie.

    New-MgBetaTenantRelationshipMultiTenantOrganizationTenant -TenantID $MemberTenantIdB -DisplayName "Berlin" | Format-List
    
    New-MgBetaTenantRelationshipMultiTenantOrganizationTenant -TenantID $MemberTenantIdA -DisplayName "Athens" | Format-List
    
  2. Gebruik de opdracht Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant om te controleren of de bewerking is voltooid voordat u doorgaat.

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

Stap 4: (Optioneel) De rol van een tenant wijzigen

Pictogram voor de eigenaartenant.
Tenant eigenaar

Tenants die zijn toegevoegd aan de multitenant-organisatie zijn standaard lidtenants. U kunt ze desgewenst wijzigen in tenants van eigenaars, zodat ze andere tenants kunnen toevoegen aan de multitenant-organisatie. U kunt een eigenaartenant ook wijzigen in een lidtenant.

  1. Gebruik in de tenant van de eigenaar de opdracht Update-MgBetaTenantRelationshipMultiTenantOrganizationTenant om een lidtenant te wijzigen in een eigenaartenant.

    Update-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId $MemberTenantIdB -Role "Owner" | Format-List
    
  2. Gebruik de opdracht Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant om de wijziging te controleren.

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

Stap 5: (Optioneel) Een lidtenant verwijderen

Pictogram voor de eigenaartenant.
Tenant eigenaar

U kunt elke lidtenant verwijderen, inclusief uw eigen tenant. U kunt eigenaartenants niet verwijderen. U kunt ook de oorspronkelijke makertenant niet verwijderen, zelfs niet als deze is gewijzigd van eigenaar in lid.

  1. Gebruik in de tenant van de eigenaar de opdracht Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant om een lidtenant te verwijderen. Deze bewerking duurt enkele minuten.

    Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId <MemberTenantIdD>
    
  2. Gebruik de opdracht Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant om de wijziging te controleren.

    Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId <MemberTenantIdD>
    

    Nadat de opdracht verwijderen is voltooid, ziet de uitvoer er ongeveer als volgt uit. Dit is een verwacht foutbericht. Hiermee wordt aangegeven dat de tenant is verwijderd uit de multitenant-organisatie.

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

Stap 6: Aanmelden bij een lidtenant

Pictogram voor de lidtenant.
Lidtenant

De tenant van Cairo heeft een multitenant organisatie gecreëerd en de huurders van Berlijn en Athene toegevoegd. In deze stappen meldt u zich aan bij de tenant van Berlijn en neemt u deel aan de multitenant-organisatie die door Cairo is gemaakt.

  1. Start PowerShell.

  2. Gebruik de opdracht Verbinding maken-MgGraph om u aan te melden bij de lidtenant en toestemming te geven voor de volgende vereiste machtigingen.

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

Stap 7: Deelnemen aan de multitenant-organisatie

Pictogram voor de lidtenant.
Lidtenant

  1. Gebruik in de lidtenant de opdracht Update-MgBetaTenantRelationshipMultiTenantOrganizationJoinRequest om lid te worden van de multitenant-organisatie.

    Update-MgBetaTenantRelationshipMultiTenantOrganizationJoinRequest -AddedByTenantId $OwnerTenantId | Format-List
    
  2. Gebruik de opdracht Get-MgBetaTenantRelationshipMultiTenantOrganizationJoinRequest om de join te verifiëren.

    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. Gebruik de opdracht Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant om de multitenant-organisatie zelf te controleren. Dit moet de join-bewerking weerspiegelen.

    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. Als u asynchrone verwerking wilt toestaan, wacht u maximaal 2 uur voordat u deelneemt aan een multitenant-organisatie.

Stap 8: (Optioneel) Laat de multitenant-organisatie staan

Pictogram voor de lidtenant.
Lidtenant

U kunt een organisatie met meerdere tenants die u hebt toegevoegd verlaten. Het proces voor het verwijderen van uw eigen tenant uit de multitenant-organisatie is hetzelfde als het proces voor het verwijderen van een andere tenant uit de multitenant-organisatie.

Als uw tenant de enige eigenaar van een multitenant-organisatie is, moet u een nieuwe tenant aanwijzen als eigenaar van de multitenant-organisatie. Zie stap 4 voor stappen : (optioneel) Wijzig de rol van een tenant.

Stap 9: (Optioneel) De multitenant-organisatie verwijderen

Pictogram voor de eigenaartenant.
Tenant eigenaar

U verwijdert een organisatie met meerdere tenants door alle tenants te verwijderen. Het proces voor het verwijderen van de uiteindelijke tenant van de eigenaar is hetzelfde als het proces voor het verwijderen van alle andere lidtenants.

Volgende stappen