Konfigurera en organisation med flera klientorganisationer med Hjälp av PowerShell eller Microsoft Graph API

I den här artikeln beskrivs de viktigaste stegen för att konfigurera en organisation med flera klientorganisationer med hjälp av Microsoft Graph PowerShell eller Microsoft Graph API. Den här artikeln använder en exempelägare med namnet Kairo och två medlemsklientorganisationer med namnet Berlin och Aten.

Om du i stället vill använda Microsoft 365 centar administracije för att konfigurera en organisation med flera klientorganisationer läser du Konfigurera en organisation för flera klientorganisationer i Microsoft 365 och Anslut eller lämna en organisation för flera klientorganisationer i Microsoft 365. Information om hur du konfigurerar Microsoft Teams för din organisation med flera klienter finns i Microsoft Teams skrivbordsklient.

Diagram som visar en organisation med flera klienter med en ägarklientorganisation och två medlemsklientorganisationer.

Förutsättningar

Ikon för ägarklientorganisationen.
Ägarklientorganisation

Ikon för medlemsklientorganisationen.
Medlemsklientorganisation

Steg 1: Logga in på ägarklientorganisationen

Ikon för ägarklientorganisationen.
Ägarklientorganisation

  1. Starta PowerShell.

  2. Installera Microsoft Graph PowerShell SDK om det behövs.

  3. Hämta klientorganisations-ID för ägare och medlemsklientorganisationer och initiera variabler.

    $OwnerTenantId = "<OwnerTenantId>"
    $MemberTenantIdB = "<MemberTenantIdB>"
    $MemberTenantIdA = "<MemberTenantIdA>"
    
  4. Använd kommandot Connect-MgGraph för att logga in på ägarklientorganisationen och godkänna följande nödvändiga behörigheter.

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

Steg 2: Skapa en organisation med flera klientorganisationer

Ikon för ägarklientorganisationen.
Ägarklientorganisation

  1. I ägarklientorganisationen använder du kommandot Update-MgBetaTenantRelationshipMultiTenantOrganization för att skapa din organisation för flera klienter. Den här åtgärden kan ta några minuter.

    Update-MgBetaTenantRelationshipMultiTenantOrganization -DisplayName "Cairo"
    
  2. Använd kommandot Get-MgBetaTenantRelationshipMultiTenantOrganization för att kontrollera att åtgärden har slutförts innan du fortsätter.

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

Steg 3: Lägg till klienter

Ikon för ägarklientorganisationen.
Ägarklientorganisation

  1. I ägarklientorganisationen använder du kommandot New-MgBetaTenantRelationshipMultiTenantOrganizationTenant för att lägga till klienter i din organisation för flera klienter.

    New-MgBetaTenantRelationshipMultiTenantOrganizationTenant -TenantID $MemberTenantIdB -DisplayName "Berlin" | Format-List
    
    New-MgBetaTenantRelationshipMultiTenantOrganizationTenant -TenantID $MemberTenantIdA -DisplayName "Athens" | Format-List
    
  2. Använd kommandot Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant för att kontrollera att åtgärden har slutförts innan du fortsätter.

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

Steg 4: (Valfritt) Ändra rollen för en klientorganisation

Ikon för ägarklientorganisationen.
Ägarklientorganisation

Som standard är klientorganisationer som läggs till i organisationen med flera klienter medlemsklientorganisationer. Du kan också ändra dem till ägarklienter, vilket gör att de kan lägga till andra klienter i organisationen med flera klienter. Du kan också ändra en ägarklientorganisation till en medlemsklientorganisation.

  1. I ägarklientorganisationen använder du kommandot Update-MgBetaTenantRelationshipMultiTenantOrganizationTenant för att ändra en medlemsklientorganisation till en ägarklientorganisation.

    Update-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId $MemberTenantIdB -Role "Owner" | Format-List
    
  2. Använd kommandot Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant för att verifiera ändringen.

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

Steg 5: (Valfritt) Ta bort en medlemsklientorganisation

Ikon för ägarklientorganisationen.
Ägarklientorganisation

Du kan ta bort alla medlemsklientorganisationer, inklusive dina egna. Du kan inte ta bort ägarklientorganisationer. Du kan inte heller ta bort den ursprungliga skaparklientorganisationen, även om den har ändrats från ägare till medlem.

  1. I ägarklientorganisationen använder du kommandot Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant för att ta bort alla medlemsklientorganisationer. Den här åtgärden tar några minuter.

    Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId <MemberTenantIdD>
    
  2. Använd kommandot Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant för att verifiera ändringen.

    Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId <MemberTenantIdD>
    

    När borttagningskommandot har slutförts liknar utdata följande. Det här är ett förväntat felmeddelande. Det anger att klientorganisationen har tagits bort från organisationen för flera klienter.

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

Steg 6: Logga in på en medlemsklientorganisation

Ikon för medlemsklientorganisationen.
Medlemsklientorganisation

Kairo-hyresgästen skapade en organisation med flera klienter och lade till berlin- och Atenklienterna. I de här stegen loggar du in på Berlin-klientorganisationen och ansluter till den flertenantorganisation som skapats av Kairo.

  1. Starta PowerShell.

  2. Använd kommandot Connect-MgGraph för att logga in på medlemsklientorganisationen och godkänna följande behörigheter.

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

Steg 7: Gå med i organisationen för flera klientorganisationer

Ikon för medlemsklientorganisationen.
Medlemsklientorganisation

  1. I medlemsklientorganisationen använder du kommandot Update-MgBetaTenantRelationshipMultiTenantOrganizationJoinRequest för att ansluta till multitenantorganisationen.

    Update-MgBetaTenantRelationshipMultiTenantOrganizationJoinRequest -AddedByTenantId $OwnerTenantId | Format-List
    
  2. Använd kommandot Get-MgBetaTenantRelationshipMultiTenantOrganizationJoinRequest för att verifiera kopplingen.

    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. Använd kommandot Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant för att kontrollera själva multitenantorganisationen. Den bör återspegla kopplingsåtgärden.

    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. Om du vill tillåta asynkron bearbetning väntar du upp till 2 timmar innan anslutningen till en organisation med flera klientorganisationer har slutförts.

Steg 8: (Valfritt) Lämna organisationen för flera klientorganisationer

Ikon för medlemsklientorganisationen.
Medlemsklientorganisation

Du kan lämna en organisation med flera klientorganisationer som du har anslutit till. Processen för att ta bort din egen klientorganisation från organisationen med flera klienter är densamma som processen för att ta bort en annan klientorganisation från organisationen för flera klienter.

Om din klientorganisation är den enda organisationsägaren för flera klienter måste du ange en ny klientorganisation som organisationsägare för flera klienter. Anvisningar finns i Steg 4: (Valfritt) Ändra rollen för en klientorganisation.

Steg 9: (Valfritt) Ta bort organisationen för flera klientorganisationer

Ikon för ägarklientorganisationen.
Ägarklientorganisation

Du tar bort en organisation med flera klienter genom att ta bort alla klienter. Processen för att ta bort den slutliga ägarklientorganisationen är densamma som processen för att ta bort alla andra medlemsklientorganisationer.

Nästa steg