Sdílet prostřednictvím

Konfigurace víceklientské organizace pomocí PowerShellu nebo rozhraní Microsoft Graph API

  • Článek

Tento článek popisuje klíčové kroky konfigurace víceklientské organizace pomocí Microsoft Graph PowerShellu nebo rozhraní Microsoft Graph API. Tento článek používá příklad tenanta vlastníka s názvem Káhira a dva členské tenanty s názvem Berlín a Atény.

Pokud místo toho chcete použít Centrum pro správu Microsoftu 365 ke konfiguraci víceklientských organizací, přečtěte si téma Nastavení víceklientských organizací v Microsoftu 365 a Připojení se nebo opuštění víceklientských organizací v Microsoftu 365. Informace o tom, jak nakonfigurovat Microsoft Teams pro vaši víceklientskou organizaci, najdete v desktopovém klientovi Microsoft Teams.

Diagram znázorňující víceklientovou organizaci s jedním tenantem vlastníka a dvěma členskými tenanty

Požadavky

Ikona tenanta vlastníka
Tenant vlastníka

Ikona pro člena tenanta
Tenant člena

Krok 1: Přihlášení k tenantovi vlastníka

Ikona tenanta vlastníka
Tenant vlastníka

  1. Spusťte PowerShell.

  2. V případě potřeby nainstalujte sadu Microsoft Graph PowerShell SDK.

  3. Získejte ID tenanta tenanta tenanta vlastníka a člena a inicializuje proměnné.

    $OwnerTenantId = "<OwnerTenantId>"
$MemberTenantIdB = "<MemberTenantIdB>"
$MemberTenantIdA = "<MemberTenantIdA>"

  4. Pomocí příkazu Connect-MgGraph se přihlaste k tenantovi vlastníka a odsouhlaste následující požadovaná oprávnění.

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

Krok 2: Vytvoření víceklientských organizací

Ikona tenanta vlastníka
Tenant vlastníka

  1. V tenantovi vlastníka pomocí příkazu Update-MgBetaTenantRelationshipMultiTenantOrganization vytvořte svou organizaci s více tenanty. Tato operace může trvat několik minut.

    Update-MgBetaTenantRelationshipMultiTenantOrganization -DisplayName "Cairo"

  2. Pomocí příkazu Get-MgBetaTenantRelationshipMultiTenantOrganization zkontrolujte, jestli se operace dokončila, než budete pokračovat.

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

Krok 3: Přidání tenantů

Ikona tenanta vlastníka
Tenant vlastníka

  1. V tenantovi vlastníka použijte příkaz New-MgBetaTenantRelationshipMultiTenantOrganizationTenant a přidejte tenanty do víceklientské organizace.

    New-MgBetaTenantRelationshipMultiTenantOrganizationTenant -TenantID $MemberTenantIdB -DisplayName "Berlin" | Format-List

    New-MgBetaTenantRelationshipMultiTenantOrganizationTenant -TenantID $MemberTenantIdA -DisplayName "Athens" | Format-List

  2. Pomocí příkazu Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant ověřte, že se operace dokončila, než budete pokračovat.

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

Krok 4: (Volitelné) Změna role tenanta

Ikona tenanta vlastníka
Tenant vlastníka

Ve výchozím nastavení jsou tenanti přidaní do víceklientských organizací členy tenantů. Volitelně je můžete změnit na tenanty vlastníka, což jim umožní přidat další tenanty do víceklientských organizací. Tenanta vlastníka můžete také změnit na člena tenanta.

  1. V tenantovi vlastníka pomocí příkazu Update-MgBetaTenantRelationshipMultiTenantOrganizationTenant Změňte člena tenanta na tenanta vlastníka.

    Update-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId $MemberTenantIdB -Role "Owner" | Format-List

  2. K ověření změny použijte příkaz Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant.

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

Krok 5: (Volitelné) Odebrání člena tenanta

Ikona tenanta vlastníka
Tenant vlastníka

Můžete odebrat libovolného člena tenanta, včetně svého vlastního. Tenanty vlastníka nemůžete odebrat. Nemůžete také odebrat původního tenanta tvůrce, i když byl změněn z vlastníka na člena.

  1. V tenantovi vlastníka použijte příkaz Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant k odebrání libovolného tenanta člena. Tato operace trvá několik minut.

    Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId <MemberTenantIdD>

  2. K ověření změny použijte příkaz Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant.

    Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId <MemberTenantIdD>

    Po dokončení příkazu pro odebrání se výstup podobá následujícímu. Jedná se o očekávanou chybovou zprávu. Označuje, že tenant byl odebrán z víceklientských organizací.

    Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant_Get: Unable to read the company information from the directory.

Status: 404 (NotFound)
ErrorCode: Directory_ObjectNotFound
Date: 2024-01-08T20:35:11

...

Krok 6: Přihlášení k tenantovi člena

Ikona pro člena tenanta
Tenant člena

Tenant Káhiry vytvořil víceklientskou organizaci a přidal tenanty Berlína a Atény. V těchtokrocích

  1. Spusťte PowerShell.

  2. Pomocí příkazu Connect-MgGraph se přihlaste k členovi tenanta a odsouhlaste následující požadovaná oprávnění.

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

Krok 7: Připojení k víceklientové organizaci

Ikona pro člena tenanta
Tenant člena

  1. V členovém tenantovi použijte příkaz Update-MgBetaTenantRelationshipMultiTenantOrganizationJoinRequest pro připojení k víceklientské organizaci.

    Update-MgBetaTenantRelationshipMultiTenantOrganizationJoinRequest -AddedByTenantId $OwnerTenantId | Format-List

  2. K ověření spojení použijte příkaz Get-MgBetaTenantRelationshipMultiTenantOrganizationJoinRequest.

    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. Pomocí příkazu Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant zkontrolujte samotnou organizaci s více tenanty. Měla by odrážet operaci spojení.

    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. Pokud chcete povolit asynchronní zpracování, počkejte až 2 hodiny , než se připojíte k organizaci s více tenanty.

Krok 8: (Volitelné) Opuštění víceklientských organizací

Ikona pro člena tenanta
Tenant člena

Můžete opustit víceklientovou organizaci, ke které jste se připojili. Proces odebrání vlastního tenanta z organizace s více tenanty je stejný jako proces pro odebrání jiného tenanta z víceklientských organizací.

Pokud je váš tenant jediným vlastníkem organizace s více tenanty, musíte určit nového tenanta, který bude vlastníkem víceklientských organizací. Postup najdete v kroku 4: (Volitelné) Změna role tenanta.

Krok 9: (Volitelné) Odstranění víceklientové organizace

Ikona tenanta vlastníka
Tenant vlastníka

Odstraněním víceklientských organizací odeberete všechny tenanty. Proces odebrání posledního tenanta vlastníka je stejný jako proces pro odebrání všech ostatních členských tenantů.

Další kroky