Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
In dit artikel worden de belangrijkste stappen beschreven voor het configureren van een multitenant-organisatie met behulp van Microsoft Graph PowerShell of Microsoft Graph API. In dit artikel wordt een voorbeeldhuurder genaamd Cairo en twee lidhuurders met de naam Berlijn en Athene gebruikt.
Als u in plaats daarvan het Microsoft 365-beheercentrum wilt gebruiken om een multitenant-organisatie te configureren, raadpleegt u Een multitenant-organisatie instellen in Microsoft 365 en Lid worden van of een multitenant-organisatie verlaten in Microsoft 365. Zie de Bureaubladclient van Microsoft Teams voor meer informatie over het configureren van Microsoft Teams voor uw multitenant-organisatie.
Vereisten
Eigenaar-huurder
- Zie Licentievereisten voor licentiegegevens.
- De rol Beveiligingsbeheerder om tenantsoverschrijdende toegangsinstellingen en sjablonen voor de multitenant-organisatie te configureren.
- Beheerder van bevoorrechte rol rol om toestemming te geven voor vereiste machtigingen.
Lidtenant
- Zie Licentievereisten voor licentiegegevens.
- De rol Beveiligingsbeheerder om tenantsoverschrijdende toegangsinstellingen en sjablonen voor de multitenant-organisatie te configureren.
- Beheerder van bevoorrechte rol rol om toestemming te geven voor vereiste machtigingen.
Stap 1: Aanmelden bij de tenant van de eigenaar
Eigenaar-huurder
Start PowerShell.
Installeer zo nodig de Microsoft Graph PowerShell SDK.
Haal de tenant-id op van zowel de eigenaar- als de ledentenant en initialiseer variabelen.
$OwnerTenantId = "<OwnerTenantId>" $MemberTenantIdB = "<MemberTenantIdB>" $MemberTenantIdA = "<MemberTenantIdA>"Gebruik de opdracht Connect-MgGraph om u aan te melden bij de tenant van de eigenaar en toestemming te geven voor de volgende vereiste machtigingen.
MultiTenantOrganization.ReadWrite.AllPolicy.Read.AllPolicy.ReadWrite.CrossTenantAccessApplication.ReadWrite.AllDirectory.ReadWrite.All
Connect-MgGraph -TenantId $OwnerTenantId -Scopes "MultiTenantOrganization.ReadWrite.All","Policy.Read.All","Policy.ReadWrite.CrossTenantAccess","Application.ReadWrite.All","Directory.ReadWrite.All"
Stap 2: Een multitenant-organisatie maken
Eigenaar-huurder
Gebruik de opdracht Update-MgTenantRelationshipMultiTenantOrganization binnen de eigenaarstenant om uw multitenant-organisatie te maken. Deze bewerking kan enkele minuten duren.
Update-MgTenantRelationshipMultiTenantOrganization -DisplayName "Cairo"Gebruik de opdracht Get-MgTenantRelationshipMultiTenantOrganization om te controleren of de bewerking is voltooid voordat u doorgaat.
Get-MgTenantRelationshipMultiTenantOrganization | Format-ListCreatedDateTime : 1/8/2024 7:47:45 PM Description : DisplayName : Cairo Id : <MtoIdC> JoinRequest : Microsoft.Graph.PowerShell.Models.MicrosoftGraphMultiTenantOrganizationJoinRequestRecord State : active Tenants : AdditionalProperties : {[@odata.context, https://graph.microsoft.com/v1.0/$metadata#tenantRelationships/multiTenantOrganization/$entity]}
Stap 3: Tenants toevoegen
Eigenaar-huurder
Gebruik in de tenant van de eigenaar de opdracht New-MgTenantRelationshipMultiTenantOrganizationTenant om tenants toe te voegen aan uw multitenant-organisatie.
New-MgTenantRelationshipMultiTenantOrganizationTenant -TenantID $MemberTenantIdB -DisplayName "Berlin" | Format-ListNew-MgTenantRelationshipMultiTenantOrganizationTenant -TenantID $MemberTenantIdA -DisplayName "Athens" | Format-ListGebruik de opdracht Get-MgTenantRelationshipMultiTenantOrganizationTenant om te controleren of de bewerking is voltooid voordat u doorgaat.
Get-MgTenantRelationshipMultiTenantOrganizationTenant | Format-ListAddedByTenantId : <OwnerTenantId> AddedDateTime : 1/8/2024 7:47:45 PM DeletedDateTime : DisplayName : Cairo Id : <MtoIdC> JoinedDateTime : Role : owner State : active TenantId : <OwnerTenantId> TransitionDetails : Microsoft.Graph.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.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.PowerShell.Models.MicrosoftGraphMultiTenantOrganizationMemberTransitionDetails AdditionalProperties : {[multiTenantOrgLabelType, none]}
Stap 4: (Optioneel) De rol van een tenant wijzigen
Eigenaar-huurder
Tenants die aan de multitenant-organisatie zijn toegevoegd, zijn standaard huurdertenants. U kunt ze desgewenst wijzigen in eigenaar-tenants, wat hen in staat stelt om andere tenants toe te voegen aan de multitenant-organisatie. U kunt een eigenaartenant ook wijzigen in een lidtenant.
Gebruik in de eigenaarstentant de opdracht Update-MgTenantRelationshipMultiTenantOrganizationTenant om een lidtenant te wijzigen in een eigenaarstentant.
Update-MgTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId $MemberTenantIdB -Role "Owner" | Format-ListGebruik de opdracht Get-MgTenantRelationshipMultiTenantOrganizationTenant om de wijziging te controleren.
Get-MgTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId $MemberTenantIdB | Format-ListAddedByTenantId : <OwnerTenantId> AddedDateTime : 1/8/2024 8:05:25 PM DeletedDateTime : DisplayName : Berlin Id : <MtoIdB> JoinedDateTime : Role : owner State : pending TenantId : <MemberTenantIdB> TransitionDetails : Microsoft.Graph.PowerShell.Models.MicrosoftGraphMultiTenantOrganizationMemberTransitionDetails AdditionalProperties : {[@odata.context, https://graph.microsoft.com/v1.0/$metadata#tenantRelationships/multiTenantOrganization/tenants/$entity], [multiTenantOrgLabelType, none]}
Stap 5: (Optioneel) Een lidtenant verwijderen
Eigenaar-huurder
U kunt elke lidtenant verwijderen, inclusief uw eigen tenant. U kunt eigenaartenants niet verwijderen. U kunt de oorspronkelijke makertenant niet verwijderen, zelfs niet als deze is gewijzigd van eigenaar naar lid.
Gebruik in de eigenaarstentant de opdracht Remove-MgTenantRelationshipMultiTenantOrganizationTenant om een lid-tenant te verwijderen. Deze bewerking duurt enkele minuten.
Remove-MgTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId <MemberTenantIdD>Gebruik de opdracht Get-MgTenantRelationshipMultiTenantOrganizationTenant om de wijziging te controleren.
Get-MgTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId <MemberTenantIdD>Nadat de opdracht verwijderen is voltooid, ziet de uitvoer er ongeveer als volgt uit. Dit is een verwacht foutbericht. Hiermee wordt aangegeven dat de tenant is verwijderd uit de multitenant-organisatie.
Get-MgTenantRelationshipMultiTenantOrganizationTenant_Get: Unable to read the company information from the directory. Status: 404 (NotFound) ErrorCode: Directory_ObjectNotFound Date: 2024-01-08T20:35:11 ...
Stap 6: Aanmelden bij een lidtenant
Lidtenant
De tenant van Cairo heeft een multitenant organisatie gecreëerd en de huurders van Berlijn en Athene toegevoegd. In deze stappen meldt u zich aan bij de tenant van Berlijn en neemt u deel aan de multitenant-organisatie die door Cairo is gemaakt.
Start PowerShell.
Gebruik de opdracht Connect-MgGraph om u aan te melden bij de lidtenant en toestemming te geven voor de volgende vereiste machtigingen.
MultiTenantOrganization.ReadWrite.AllPolicy.Read.AllPolicy.ReadWrite.CrossTenantAccessApplication.ReadWrite.AllDirectory.ReadWrite.All
Connect-MgGraph -TenantId $MemberTenantIdB -Scopes "MultiTenantOrganization.ReadWrite.All","Policy.Read.All","Policy.ReadWrite.CrossTenantAccess","Application.ReadWrite.All","Directory.ReadWrite.All"
Stap 7: Deelnemen aan de multitenant-organisatie
Lidtenant
Gebruik in de lidtenant de opdracht Update-MgTenantRelationshipMultiTenantOrganizationJoinRequest om lid te worden van de multitenant-organisatie.
Update-MgTenantRelationshipMultiTenantOrganizationJoinRequest -AddedByTenantId $OwnerTenantId | Format-ListGebruik de opdracht Get-MgTenantRelationshipMultiTenantOrganizationJoinRequest om de join te verifiëren.
Get-MgTenantRelationshipMultiTenantOrganizationJoinRequest | Format-ListAddedByTenantId : <OwnerTenantId> Id : <MtoJoinRequestIdB> MemberState : active Role : member TransitionDetails : Microsoft.Graph.PowerShell.Models.MicrosoftGraphMultiTenantOrganizationJoinRequestTransitionDetails AdditionalProperties : {[@odata.context, https://graph.microsoft.com/v1.0/$metadata#tenantRelationships/multiTenantOrganization/joinRequest/$entity]}Gebruik de opdracht Get-MgTenantRelationshipMultiTenantOrganizationTenant om de multitenant-organisatie zelf te controleren. Dit zou de koppelbewerkingen moeten weerspiegelen.
Get-MgTenantRelationshipMultiTenantOrganizationTenant | Format-ListAddedByTenantId : <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.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.PowerShell.Models.MicrosoftGraphMultiTenantOrganizationMemberTransitionDetails AdditionalProperties : {[multiTenantOrgLabelType, none]}Als u asynchrone verwerking wilt toestaan, wacht u maximaal 2 uur voordat u deelneemt aan een multitenant-organisatie.
Stap 8: (Optioneel) Laat de multitenant-organisatie staan
Lidtenant
U kunt een multitenantorganisatie waaraan u bent toegetreden, verlaten. Het proces voor het verwijderen van uw eigen tenant uit de multitenant-organisatie is hetzelfde als het proces voor het verwijderen van een andere tenant uit de multitenant-organisatie.
Als uw tenant de enige eigenaar van een multitenant-organisatie is, moet u een nieuwe tenant aanwijzen als eigenaar van de multitenant-organisatie. Zie stap 4 voor stappen : (optioneel) Wijzig de rol van een tenant.
Gebruik in de tenant de opdracht Remove-MgTenantRelationshipMultiTenantOrganizationTenant om de tenant te verwijderen. Deze bewerking duurt enkele minuten.
Remove-MgTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId <MemberTenantId>
Stap 9: (Optioneel) De multitenant-organisatie verwijderen
Eigenaar-huurder
U verwijdert een organisatie met meerdere tenants door alle tenants te verwijderen. Het proces voor het verwijderen van de laatste eigenaartenant is hetzelfde als het proces voor het verwijderen van alle andere lid-huurders.
Gebruik in de uiteindelijke eigenaar-tenant de opdracht Remove-MgTenantRelationshipMultiTenantOrganizationTenant om de tenant te verwijderen. Deze bewerking duurt enkele minuten.
Remove-MgTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId $OwnerTenantId