Guía de inicio rápido: Incorporación de un usuario invitado con PowerShell

Se aplica a: inquilinos de workforce (más información)

Hay muchas maneras de invitar a asociados externos a sus aplicaciones y servicios con Microsoft Entra colaboración B2B. En el inicio rápido anterior, ha visto cómo agregar usuarios invitados directamente en el Microsoft Entra admin center. También puede usar PowerShell para agregar usuarios invitados, uno a uno o de forma masiva. En este inicio rápido, usará el comando New-MgInvitation para agregar un usuario invitado al inquilino de Microsoft Entra.

En este artículo se explica cómo invitar a usuarios invitados con Microsoft Graph PowerShell. También puede administrar usuarios invitados con Microsoft Entra PowerShell.

Requisitos previos

Para completar el escenario en este inicio rápido, necesita:

• Una suscripción Azure. Si no tiene una suscripción de Azure, cree una cuenta free antes de comenzar.
• Un rol que le permite crear usuarios en su directorio de inquilinos, como al menos un Rol de invitador de usuarios invitados o un Administrador de usuarios.
• Instale el módulo Microsoft Graph Identity Sign-ins (Microsoft. Graph.Identity.SignIns) y el módulo Microsoft Graph Users (Microsoft. Graph.Users). Puede usar la instrucción de #Requires para evitar la ejecución de un script a menos que se cumplan los módulos de PowerShell necesarios.

#Requires -Modules Microsoft.Graph.Identity.SignIns, Microsoft.Graph.Users

• Obtenga una cuenta de correo electrónico de prueba. Necesita una cuenta de correo electrónico de prueba a la que poder enviar la invitación. La cuenta debe estar fuera de su organización. Puede usar cualquier tipo de cuenta, incluida una cuenta social, como una dirección de Gmail.com o Outlook.com.

Inicio de sesión en su inquilino

Ejecute el siguiente comando para conectarse al inquilino:

Connect-MgGraph -Scopes 'User.Invite.All','User.Read.All'

Cuando se le solicite, escriba las credenciales.

Envío de una invitación

1. Para enviar una invitación a la cuenta de correo electrónico de prueba, ejecuta el siguiente comando de PowerShell (reemplaza "Henry Ross" y henry@contoso.com por el nombre de cuenta y la dirección del correo electrónico de prueba):

   New-MgInvitation -InvitedUserDisplayName "Henry Ross" -InvitedUserEmailAddress henry@contoso.com -InviteRedirectUrl "https://myapplications.microsoft.com" -SendInvitationMessage:$true
   

2. El comando envía una invitación a la dirección de correo electrónico especificada. Consulte la salida, que debería ser similar a la del ejemplo siguiente:

   Id                                   InviteRedeemUrl                                                                                                   
   --                                   ---------------                                                                                                   
   00aa00aa-bb11-cc22-dd33-44ee44ee44ee https://login.microsoftonline.com/redeem?...
   

Verificación de la existencia del usuario en el directorio

1. Para comprobar que el usuario invitado se agregó a Microsoft Entra ID, ejecute el siguiente comando (reemplace henry@contoso.com por el correo electrónico invitado):

   Get-MgUser -Filter "Mail eq 'henry@contoso.com'"
   

2. Consulte la salida para asegurarse de que el usuario invitado aparece en la lista, con un nombre principal de usuario (UPN) con el formato emailaddress#EXT#@dominio. Por ejemplo, henry_contoso.com#EXT#@fabrikam.onmicrosoft.com, donde fabrikam.onmicrosoft.com es la organización desde la que se enviaron las invitaciones.

   Id                                   DisplayName              Mail                           UserPrincipalName        
   --                                   -----------              ----                           -----------------               
   00aa00aa-bb11-cc22-dd33-44ee44ee44ee Henry Ross               henry@contoso.com              henry_contoso.com#EXT#@fabrikam.onmicrosoft.com
   

Limpieza de recursos

Cuando ya no sea necesaria, puede eliminar la cuenta de usuario de prueba del directorio. Ejecute el siguiente comando para eliminar una cuenta de usuario:

Remove-MgUser -UserId '<String>'

Por ejemplo:

Remove-MgUser -UserId 'henry_contoso.com#EXT#@fabrikam.onmicrosoft.com'

O

Remove-MgUser -UserId '00aa00aa-bb11-cc22-dd33-44ee44ee44ee'

Pasos siguientes

En este inicio rápido, ha invitado y agregado un único usuario invitado al directorio mediante PowerShell. También puede invitar a un usuario invitado mediante el Microsoft Entra admin center. Además, puede invitar a usuarios invitados de forma masiva mediante PowerShell.