Udostępnij za pośrednictwem

Konfigurowanie organizacji wielodostępnej przy użyciu programu PowerShell lub interfejsu API programu Microsoft Graph

  • Artykuł

W tym artykule opisano kluczowe kroki konfigurowania organizacji wielodostępnej przy użyciu programu Microsoft Graph PowerShell lub interfejsu API programu Microsoft Graph. W tym artykule użyto przykładowej dzierżawy właściciela o nazwie Kair i dwóch dzierżawach członkowskich o nazwach Berlin i Atenach.

Jeśli zamiast tego chcesz użyć Centrum administracyjne platformy Microsoft 365 do skonfigurowania organizacji wielodostępnej, zobacz Konfigurowanie wielodostępnej organizacji na platformie Microsoft 365 i Dołączanie lub opuszczanie wielodostępnej organizacji na platformie Microsoft 365. Aby dowiedzieć się, jak skonfigurować usługę Microsoft Teams dla organizacji wielodostępnych, zobacz klienta klasycznego usługi Microsoft Teams.

Diagram przedstawiający wielodostępną organizację z jedną dzierżawą właściciela i dwie dzierżawy członkowskie.

Wymagania wstępne

Ikona dzierżawy właściciela.
Dzierżawa właściciela

  • Aby uzyskać informacje o licencji, zobacz Wymagania licencyjne.
  • Rola administratora zabezpieczeń w celu skonfigurowania ustawień dostępu między dzierżawami i szablonów dla organizacji wielodostępnej.
  • Rola administratora globalnego w celu wyrażenia zgody na wymagane uprawnienia.

Ikona dzierżawy członka.
Dzierżawa członka

  • Aby uzyskać informacje o licencji, zobacz Wymagania licencyjne.
  • Rola administratora zabezpieczeń w celu skonfigurowania ustawień dostępu między dzierżawami i szablonów dla organizacji wielodostępnej.
  • Rola administratora globalnego w celu wyrażenia zgody na wymagane uprawnienia.

Krok 1. Logowanie się do dzierżawy właściciela

Ikona dzierżawy właściciela.
Dzierżawa właściciela

  1. Uruchom program PowerShell.

  2. W razie potrzeby zainstaluj zestaw MICROSOFT Graph PowerShell SDK.

  3. Pobierz identyfikator dzierżawy dzierżawy i dzierżawców członków oraz zainicjuj zmienne.

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

  4. Użyj polecenia Connect-MgGraph, aby zalogować się do dzierżawy właściciela i wyrazić zgodę na następujące wymagane uprawnienia.

    • 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. Tworzenie organizacji wielodostępnej

Ikona dzierżawy właściciela.
Dzierżawa właściciela

  1. W dzierżawie właściciela użyj polecenia Update-MgBetaTenantRelationshipMultiTenantOrganization , aby utworzyć organizację wielodostępną. Ta operacja może potrwać kilka minut.

    Update-MgBetaTenantRelationshipMultiTenantOrganization -DisplayName "Cairo"

  2. Użyj polecenia Get-MgBetaTenantRelationshipMultiTenantOrganization, aby sprawdzić, czy operacja została ukończona przed kontynuowaniem.

    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. Dodawanie dzierżaw

Ikona dzierżawy właściciela.
Dzierżawa właściciela

  1. W dzierżawie właściciela użyj polecenia New-MgBetaTenantRelationshipMultiTenantOrganizationTenantTenant , aby dodać dzierżawy do organizacji wielodostępnej.

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

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

  2. Użyj polecenia Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant, aby sprawdzić, czy operacja została ukończona przed kontynuowaniem.

    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. (Opcjonalnie) Zmienianie roli dzierżawy

Ikona dzierżawy właściciela.
Dzierżawa właściciela

Domyślnie dzierżawy dodawane do organizacji wielodostępnych to dzierżawy członkowskie. Opcjonalnie można je zmienić na dzierżawy właściciela, które umożliwiają dodawanie innych dzierżaw do organizacji wielodostępnych. Możesz również zmienić dzierżawę właściciela na dzierżawę członka.

  1. W dzierżawie właściciela użyj polecenia Update-MgBetaTenantRelationshipMultiTenantOrganizationTenantTenant , aby zmienić dzierżawę członka na dzierżawę właściciela.

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

  2. Użyj polecenia Get-MgBetaTenantRelationshipMultiTenantOrganizationTenantTenant, aby zweryfikować zmianę.

    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. (Opcjonalnie) Usuwanie dzierżawy członka

Ikona dzierżawy właściciela.
Dzierżawa właściciela

Możesz usunąć dowolną dzierżawę członka, w tym własną. Nie można usunąć dzierżaw właścicieli. Ponadto nie można usunąć oryginalnej dzierżawy twórców, nawet jeśli została zmieniona z właściciela na członka.

  1. W dzierżawie właściciela użyj polecenia Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenantTenant, aby usunąć dowolną dzierżawę członka. Ta operacja trwa kilka minut.

    Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId <MemberTenantIdD>

  2. Użyj polecenia Get-MgBetaTenantRelationshipMultiTenantOrganizationTenantTenant, aby zweryfikować zmianę.

    Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId <MemberTenantIdD>

    Po zakończeniu usuwania polecenia dane wyjściowe są podobne do poniższych. Jest to oczekiwany komunikat o błędzie. Wskazuje, że dzierżawa została usunięta z organizacji wielodostępnej.

    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. Logowanie do dzierżawy członka

Ikona dzierżawy członka.
Dzierżawa członka

Dzierżawca Kairu stworzył wielodostępną organizację i dodał dzierżawców Berlina i Aten. W tych krokach zalogujesz się do dzierżawy Berlina i dołączysz do wielodostępnego organizacji utworzonej przez Kair.

  1. Uruchom program PowerShell.

  2. Użyj polecenia Connect-MgGraph, aby zalogować się do dzierżawy członka i wyrazić zgodę na następujące wymagane uprawnienia.

    • 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. Dołączanie do organizacji wielodostępnych

Ikona dzierżawy członka.
Dzierżawa członka

  1. W dzierżawie członkowskiej użyj polecenia Update-MgBetaTenantRelationshipMultiTenantOrganizationJoinRequest , aby dołączyć do organizacji wielodostępnej.

    Update-MgBetaTenantRelationshipMultiTenantOrganizationJoinRequest -AddedByTenantId $OwnerTenantId | Format-List

  2. Użyj polecenia Get-MgBetaTenantRelationshipMultiTenantOrganizationJoinRequest, aby zweryfikować sprzężenie.

    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. Użyj polecenia Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant, aby sprawdzić samą organizację wielodostępną. Powinna ona odzwierciedlać operację sprzężenia.

    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. Aby umożliwić przetwarzanie asynchroniczne, poczekaj do 2 godzin przed ukończeniem dołączania do organizacji wielodostępnej.

Krok 8. (Opcjonalnie) Pozostaw organizację wielodostępną

Ikona dzierżawy członka.
Dzierżawa członka

Możesz pozostawić organizację wielodostępną, do której dołączyłeś. Proces usuwania własnej dzierżawy z organizacji wielodostępnej jest taki sam jak proces usuwania innej dzierżawy z organizacji wielodostępnej.

Jeśli dzierżawa jest jedynym właścicielem wielodostępnej organizacji, musisz wyznaczyć nową dzierżawę jako właściciela wielodostępnej organizacji. Aby uzyskać instrukcje, zobacz Krok 4: (Opcjonalnie) Zmienianie roli dzierżawy.

Krok 9. (Opcjonalnie) Usuń organizację wielodostępną

Ikona dzierżawy właściciela.
Dzierżawa właściciela

Możesz usunąć organizację wielodostępną, usuwając wszystkie dzierżawy. Proces usuwania końcowej dzierżawy właściciela jest taki sam jak proces usuwania wszystkich pozostałych dzierżawców członkowskich.

Następne kroki