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. Microsoft Teams'i çok kiracılı kuruluşunuz için yapılandırmayı öğrenmek için bkz . Microsoft Teams masaüstü istemcisi.
Önkoşullar
Sahip kiracısı
- Lisans bilgileri için bkz . Lisans gereksinimleri.
- Çok kiracılı kuruluş için kiracılar arası erişim ayarlarını ve şablonlarını yapılandırmak için Güvenlik Yöneticisi rolü.
- Gerekli izinlere onay vermek için Genel Yönetici rolü.
Üye kiracısı
- Lisans bilgileri için bkz . Lisans gereksinimleri.
- Çok kiracılı kuruluş için kiracılar arası erişim ayarlarını ve şablonlarını yapılandırmak için Güvenlik Yöneticisi rolü.
- Gerekli izinlere onay vermek için Genel Yönetici rolü.
1. Adım: Sahip kiracısında oturum açma
Sahip kiracısı
PowerShell'i başlatın.
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>"
Connect-MgGraph komutunu kullanarak sahip kiracısında oturum açın ve aşağıdaki gerekli izinleri onaylayı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ı
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"
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ı
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
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ı
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.
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
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ı
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.
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>
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ı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.
PowerShell'i başlatın.
Üye kiracısında oturum açmak ve aşağıdaki gerekli izinleri kabul etmek için Connect-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ısı
Üye kiracısında, çok kiracılı kuruluşa katılmak için Update-MgBetaTenantRelationshipMultiTenantOrganizationJoinRequest komutunu kullanın.
Update-MgBetaTenantRelationshipMultiTenantOrganizationJoinRequest -AddedByTenantId $OwnerTenantId | Format-List
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]}
Ç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]}
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ı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.
Kiracıda, kiracıyı kaldırmak için Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant komutunu kullanın. Bu işlem birkaç dakika sürer.
Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId <MemberTenantId>
9. Adım: (İsteğe bağlı) Çok kiracılı kuruluşu silme
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