Dela via


Konfigurera en flervalorganisation med 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 exempelhyresvärd vid namn Kairo och två medlemsorganisationer vid namn Berlin och Aten.

Om du i stället vill använda Administrationscenter för Microsoft 365 för att konfigurera en organisation för 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 ägarhyresgästen.
Ägarhyresgäst

Ikon för medlemshyresgäst.
Medlemshyresgäst

Steg 1: Logga in på ägarklienten

Ikon för ägarklientorganisationen.
Ägarlägenhet

  1. Starta PowerShell.

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

  3. Hämta hyresgäst-ID för ägare och medlemsorganisationer och initiera variabler.

    $OwnerTenantId = "<OwnerTenantId>"
    $MemberTenantIdB = "<MemberTenantIdB>"
    $MemberTenantIdA = "<MemberTenantIdA>"
    
  4. Använd kommandot Connect-MgGraph för att logga in på ägarklienten 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 fleranvändarorganisation

Ikon för ägarehyresgästen.
Ägarehyresgäst

  1. I ägarens tenant använder du kommandot Update-MgBetaTenantRelationshipMultiTenantOrganization för att skapa din multitenantorganisation. 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 ägande hyresgäst.
Ägarhyresgäst

  1. I ägarklientens miljö använder du kommandot New-MgBetaTenantRelationshipMultiTenantOrganizationTenant för att lägga till klienter i din organisation med 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 hyresgäst

Ikon för ägarehyresgästen.
Ägandehyresgäst

Som standardinställning är klientorganisationer som läggs till i organisationen med flera klienter medlemsklienter. 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 ägartenanten.
Ägar-hyresgäst

Du kan ta bort alla medlemshyresgäster, inklusive dina egna. Du kan inte ta bort ägare-hyresgäster. Inte heller kan du ta bort den ursprungliga skaparen, även om den har ändrats från ägare till medlem.

  1. I ägarklientorganisationen använder du kommandot Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant för att ta bort valfri medlemsklientorganisation. 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. Hyresgästen har tagits bort från multitenant-miljön.

    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 medlemshyresgäst

Ikon för hyresgästmedlemmen.
Medlemshyresgäst

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 multitenantorganisationen

Ikon för medlemshyresgästen.
Medlemshyresgäst

  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 multitenant-organisationen. 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. För att tillåta asynkron bearbetning, vänta upp till två timmar innan anslutningen till en multitenantorganisation har slutförts.

Steg 8: (Valfritt) Lämna molnorganisationen

Ikon för medlemshyresgästen.
Medlemshyresgäst

Du kan lämna en multitenant-organisation som du har gått med i. 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 multitenant-organisationen

Ikon för hyresvärden.
Ägare hyresgäst

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