Compartir vía


Configuración de una organización multiinquilino mediante PowerShell o Microsoft Graph API

En este artículo se describen los pasos clave para configurar una organización multiinquilino mediante Microsoft Graph PowerShell o Microsoft Graph API. En este artículo, se usa un inquilino de propietario de ejemplo denominado Cairo y dos inquilinos miembros denominados Berlín y Atenas.

Si en su lugar desea usar el Centro de administración de Microsoft 365 para configurar una organización multiinquilino, consulte Configurar una organización multiinquilino en Microsoft 365 y Unirse o dejar una organización multiinquilino en Microsoft 365. Para obtener información sobre cómo configurar Microsoft Teams para su organización multiinquilino, consulte El nuevo cliente de escritorio de Microsoft Teams.

Diagrama que muestra una organización multiinquilino con un inquilino propietario y dos inquilinos miembro.

Requisitos previos

Icono para el inquilino propietario.
Inquilino propietario

Icono para el inquilino miembro.
Inquilino miembro

Paso 1: Inicie sesión en el inquilino propietario

Icono para el inquilino propietario.
Inquilino propietario

  1. Inicie PowerShell.

  2. Si fuera necesario, instale el SDK de PowerShell de Microsoft Graph.

  3. Obtenga el identificador de inquilino de los inquilinos propietario y miembro e inicialice variables.

    $OwnerTenantId = "<OwnerTenantId>"
    $MemberTenantIdB = "<MemberTenantIdB>"
    $MemberTenantIdA = "<MemberTenantIdA>"
    
  4. Use el comando Connect-MgGraph para iniciar sesión en el inquilino propietario y dar su consentimiento a los siguientes permisos necesarios.

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

Paso 2: Crear una organización multiinquilino

Icono para el inquilino propietario.
Inquilino propietario

  1. En el inquilino propietario, use el comando Update-MgBetaTenantRelationshipMultiTenantOrganization para crear la organización multiinquilino. Esta operación puede tardar unos minutos.

    Update-MgBetaTenantRelationshipMultiTenantOrganization -DisplayName "Cairo"
    
  2. Use el comando Get-MgBetaTenantRelationshipMultiTenantOrganization para comprobar que la operación se ha completado antes de continuar.

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

Paso 3: Agregue inquilinos

Icono para el inquilino propietario.
Inquilino propietario

  1. En el inquilino propietario, use el comando New-MgBetaTenantRelationshipMultiTenantOrganizationTenant para agregar inquilinos a la organización multiinquilino.

    New-MgBetaTenantRelationshipMultiTenantOrganizationTenant -TenantID $MemberTenantIdB -DisplayName "Berlin" | Format-List
    
    New-MgBetaTenantRelationshipMultiTenantOrganizationTenant -TenantID $MemberTenantIdA -DisplayName "Athens" | Format-List
    
  2. Use el comando get-MgBetaTenantRelationshipMultiTenantOrganizationTenant para comprobar que la operación se ha completado antes de continuar.

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

Paso 4: (Opcional) Cambie el rol de un inquilino

Icono para el inquilino propietario.
Inquilino propietario

De forma predeterminada, los inquilinos agregados a la organización multiinquilino son inquilinos miembros. Opcionalmente, puede cambiarlos a inquilinos propietarios, lo que les permite agregar otros inquilinos a la organización multiinquilino. También puede cambiar un inquilino propietario a un inquilino miembro.

  1. En el inquilino propietario, use el comando Update-MgBetaTenantRelationshipMultiTenantOrganizationTenant para cambiar un inquilino miembro a un inquilino propietario.

    Update-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId $MemberTenantIdB -Role "Owner" | Format-List
    
  2. Use el comando Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant para comprobar el cambio.

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

Paso 5: (Opcional) Quite un inquilino miembro

Icono para el inquilino propietario.
Inquilino propietario

Puede quitar cualquier inquilino miembro, incluido el suyo propio. No se pueden quitar inquilinos propietarios. Además, no puede quitar el inquilino creador original, incluso si se ha cambiado de propietario a miembro.

  1. En el inquilino propietario, use el comando Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant para quitar cualquier inquilino miembro. Esta operación tarda unos minutos.

    Remove-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId <MemberTenantIdD>
    
  2. Use el comando Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant para comprobar el cambio.

    Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant -MultiTenantOrganizationMemberId <MemberTenantIdD>
    

    Una vez completado el comando Remove, la salida es similar a la siguiente. Este es un mensaje de error esperado. Indica que el inquilino se ha quitado de la organización multiinquilino.

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

Paso 6: Inicie sesión en un inquilino miembro

Icono para el inquilino miembro.
Inquilino miembro

El inquilino de Cairo creó una organización multiinquilino y agregó los inquilinos de Berlín y Atenas. En estos pasos, inicie sesión en el inquilino de Berlín y únase a la organización multiinquilino creada por Cairo.

  1. Inicie PowerShell.

  2. Use el comando Connect-MgGraph para iniciar sesión en el inquilino miembro y dar su consentimiento a los siguientes permisos necesarios.

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

Paso 7: unirse a la organización multiinquilino

Icono para el inquilino miembro.
Inquilino miembro

  1. En el inquilino miembro, use el comando Update-MgBetaTenantRelationshipMultiTenantOrganizationJoinRequest para unirse a la organización multiinquilino.

    Update-MgBetaTenantRelationshipMultiTenantOrganizationJoinRequest -AddedByTenantId $OwnerTenantId | Format-List
    
  2. Use el comando Get-MgBetaTenantRelationshipMultiTenantOrganizationJoinRequest para comprobar la combinació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. Use el comando Get-MgBetaTenantRelationshipMultiTenantOrganizationTenant para comprobar la propia organización multiinquilino. Debe reflejar la operación de combinación.

    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. Para permitir el procesamiento asincrónico, espere hasta 2 horas antes de unirse a una organización multiinquilino.

Paso 8: (Opcional) Deje la organización multiinquilino

Icono para el inquilino miembro.
Inquilino miembro

Puede dejar una organización multiinquilino a la que se haya unido. El proceso para quitar su propio inquilino de la organización multiinquilino es el mismo que el proceso para quitar otro inquilino de la organización multiinquilino.

Si el inquilino es el único propietario de la organización multiinquilino, debe designar un nuevo inquilino para que sea el propietario de la organización multiinquilino. Para ver los pasos, consulte Paso 4: (Optional) Cambie el rol de un inquilino.

Paso 9: (Opcional) Eliminar la organización multiinquilino

Icono para el inquilino propietario.
Inquilino propietario

Para eliminar una organización multiinquilino, quite todos los inquilinos. El proceso para quitar el inquilino del propietario final es el mismo que el proceso para quitar todos los demás inquilinos miembros.

Pasos siguientes