Aracılığıyla paylaş


PowerShell veya Microsoft Graph API kullanarak çok kiracılı bir kuruluş yapılandırma

Bu makalede, Microsoft Graph PowerShell veya Microsoft Graph API kullanarak çok kiracılı bir kuruluşu yapılandırmaya yönelik temel adımlar açıklanmaktadır. Bu makalede Kahire adlı örnek bir sahip kiracısı ve Berlin ve Atina adlı iki üye kiracı kullanılmaktadır.

Bunun yerine, çok kiracılı bir kuruluşu yapılandırmak için Microsoft 365 yönetim merkezi kullanmak istiyorsanız bkz. Microsoft 365'te çok kiracılı kuruluş ayarlama ve Microsoft 365'te çok kiracılı bir kuruluşa katılma veya kuruluşa katılma veya kuruluşa katılma. Çok kiracılı kuruluşunuz için Microsoft Teams'i yapılandırmayı öğrenmek için bkz . Yeni Microsoft Teams masaüstü istemcisi.

Bir sahip kiracısı ve iki üye kiracısı olan çok kiracılı bir kuruluşu gösteren diyagram.

Önkoşullar

Sahip kiracısı simgesi.
Sahip kiracısı

Üye kiracı simgesi.
Üye kiracısı

1. Adım: Sahip kiracısında oturum açma

Sahip kiracısı simgesi.
Sahip kiracısı

  1. PowerShell'i başlatın.

  2. Gerekirse Microsoft Graph PowerShell SDK'sını yükleyin.

  3. Sahip ve üye kiracılarının kiracı kimliğini alın ve değişkenleri başlatın.

    $OwnerTenantId = "<OwnerTenantId>"
    $MemberTenantIdB = "<MemberTenantIdB>"
    $MemberTenantIdA = "<MemberTenantIdA>"
    
  4. Sahip kiracısında oturum açmak ve aşağıdaki gerekli izinleri kabul etmek için Bağlan-MgGraph komutunu kullanı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"
    

2. Adım: Çok kiracılı bir kuruluş oluşturma

Sahip kiracısı simgesi.
Sahip kiracısı

  1. Sahip kiracısında, çok kiracılı kuruluşunuzu oluşturmak için Update-MgBetaTenantRelationshipMultiTenantOrganization komutunu kullanın. Bu işlem birkaç dakika sürebilir.

    Update-MgBetaTenantRelationshipMultiTenantOrganization -DisplayName "Cairo"
    
  2. Devam etmeden önce işlemin tamamlandığını denetlemek için Get-MgBetaTenantRelationshipMultiTenantOrganization komutunu kullanın.

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

3. Adım: Kiracı ekleme

Sahip kiracısı simgesi.
Sahip kiracısı

  1. Sahip kiracısında, çok kiracılı kuruluşunuza kiracı eklemek için New-MgBetaTenantRelationshipMultiTenantOrganizationTenant komutunu kullanın.

    New-MgBetaTenantRelationshipMultiTenantOrganizationTenant -TenantID $MemberTenantIdB -DisplayName "Berlin" | Format-List
    
    New-MgBetaTenantRelationshipMultiTenantOrganizationTenant -TenantID $MemberTenantIdA -DisplayName "Athens" | Format-List
    
  2. Devam etmeden önce işlemin tamamlandığını doğrulamak için Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant komutunu kullanın.

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

4. Adım: (İsteğe bağlı) Kiracının rolünü değiştirme

Sahip kiracısı simgesi.
Sahip kiracısı

Varsayılan olarak, çok kiracılı kuruluşa eklenen kiracılar üye kiracılardır. İsteğe bağlı olarak, bunları sahip kiracılarıyla değiştirebilir ve bu sayede çok kiracılı kuruluşa başka kiracılar ekleyebilirsiniz. Ayrıca sahip kiracısını üye kiracı olarak da değiştirebilirsiniz.

  1. Sahip kiracısında, üye kiracısını sahip kiracısı olarak değiştirmek için Update-MgBetaTenantRelationshipMultiTenantOrganizationTenant komutunu kullanın.

    Update-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId $MemberTenantIdB -Role "Owner" | Format-List
    
  2. Değişikliği doğrulamak için Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant komutunu kullanın.

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

5. Adım: (İsteğe bağlı) Üye kiracısını kaldırma

Sahip kiracısı simgesi.
Sahip kiracısı

Kendi kiracınız da dahil olmak üzere herhangi bir üye kiracısını kaldırabilirsiniz. Sahip kiracılarını kaldıramazsınız. Ayrıca, sahipten üyeye değiştirilmiş olsa bile özgün oluşturucu kiracısını kaldıramazsınız.

  1. Sahip kiracısında, herhangi bir üye kiracısını kaldırmak için Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant komutunu kullanın. Bu işlem birkaç dakika sürer.

    Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId <MemberTenantIdD>
    
  2. Değişikliği doğrulamak için Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant komutunu kullanın.

    Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId <MemberTenantIdD>
    

    Remove komutu tamamlandıktan sonra çıkış aşağıdakine benzer. Bu beklenen bir hata iletisidir. Kiracının çok kiracılı kuruluştan kaldırıldığını gösterir.

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

6. Adım: Üye kiracısında oturum açma

Üye kiracı simgesi.
Üye kiracısı

Kahire kiracısı çok kiracılı bir kuruluş oluşturmuş ve Berlin ve Atina kiracılarını eklemiş. Bu adımlarda, Berlin kiracısında oturum açar ve Kahire tarafından oluşturulan çok kiracılı kuruluşa katılırsınız.

  1. PowerShell'i başlatın.

  2. Üye kiracısında oturum açmak ve aşağıdaki gerekli izinleri kabul etmek için Bağlan-MgGraph komutunu kullanı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"
    

7. Adım: Çok kiracılı kuruluşa katılma

Üye kiracı simgesi.
Üye kiracısı

  1. Üye kiracısında, çok kiracılı kuruluşa katılmak için Update-MgBetaTenantRelationshipMultiTenantOrganizationJoinRequest komutunu kullanın.

    Update-MgBetaTenantRelationshipMultiTenantOrganizationJoinRequest -AddedByTenantId $OwnerTenantId | Format-List
    
  2. Birleştirmeyi doğrulamak için Get-MgBetaTenantRelationshipMultiTenantOrganizationJoinRequest komutunu kullanın.

    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. Çok kiracılı kuruluşun kendisini denetlemek için Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant komutunu kullanın. Birleştirme işlemini yansıtmalıdır.

    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. Zaman uyumsuz işlemeye izin vermek için, çok kiracılı bir kuruluşa katılma işleminin tamamlanması için 2 saate kadar bekleyin.

8. Adım: (İsteğe bağlı) Çok kiracılı kuruluşta bırakın

Üye kiracı simgesi.
Üye kiracısı

Katıldığınız çok kiracılı bir kuruluşta bırakabilirsiniz. Çok kiracılı kuruluştan kendi kiracınızı kaldırma işlemi, çok kiracılı kuruluştan başka bir kiracıyı kaldırma işlemiyle aynıdır.

Kiracınız tek çok kiracılı kuruluş sahibiyse, yeni bir kiracıyı çok kiracılı kuruluş sahibi olarak atamanız gerekir. Adımlar için bkz . 4. Adım: (İsteğe bağlı) Kiracının rolünü değiştirme.

9. Adım: (İsteğe bağlı) Çok kiracılı kuruluşu silme

Sahip kiracısı simgesi.
Sahip kiracısı

Tüm kiracıları kaldırarak çok kiracılı bir kuruluşu silersiniz. Son sahip kiracısını kaldırma işlemi, diğer tüm üye kiracıları kaldırma işlemiyle aynıdır.

  • Kiracıyı kaldırmak için son sahip kiracısında Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant komutunu kullanın. Bu işlem birkaç dakika sürer.

    Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId $OwnerTenantId
    

Sonraki adımlar