Partilhar via

Guia de Início Rápido: Adicionar um utilizador convidado com o PowerShell

Aplica-se a: círculo verde com um símbolo de marca de seleção branco que indica que o conteúdo a seguir se aplica aos locatários da força de trabalho. Inquilinos da força de trabalho (saiba mais)

Existem muitas formas de convidar parceiros externos para as suas aplicações e serviços com a colaboração Microsoft Entra B2B. No quickstart anterior, viu como adicionar utilizadores convidados diretamente no centro de administração Microsoft Entra. Pode também utilizar o PowerShell para adicionar utilizadores convidados, um de cada vez ou em lote. Neste início rápido, usa o comando New-MgInvitation para adicionar um utilizador convidado ao teu locatário Microsoft Entra.

Este artigo explica como convidar utilizadores convidados com o Microsoft Graph PowerShell. Também pode gerir utilizadores convidados com Microsoft Entra PowerShell.

Pré-requisitos

Para concluir o cenário neste início rápido, você precisa:

  • Uma subscrição do Azure. Se não tiver uma subscrição Azure, crie uma conta gratuita antes de começar.
  • Uma função que lhe permite criar utilizadores no diretório do seu inquilino, como pelo menos uma função de Convite de Convidado ou um Administrador de Utilizador.
  • Instale o módulo de Login de Identidade Microsoft Graph (Microsoft. Graph.Identity.LogIns) e o módulo Microsoft Graph Users (Microsoft. Graph.Users). Você pode usar a instrução para impedir a #Requires execução de um script, a menos que os módulos necessários do PowerShell sejam atendidos.
#Requires -Modules Microsoft.Graph.Identity.SignIns, Microsoft.Graph.Users
  • Obtenha uma conta de e-mail de teste. Precisa de uma conta de e-mail de teste para a qual possa enviar os convites. A conta tem de ser externa à sua organização. Pode usar qualquer tipo de conta, incluindo uma conta social como um endereço Gmail.com ou Outlook.com.

Observação

Este artigo utiliza o Microsoft Graph PowerShell, que substitui os módulos PowerShell do Azure AD e MSOnline já retirados.

Iniciar sessão no seu inquilino

Execute o seguinte comando para se ligar ao seu inquilino:

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

Quando lhe for pedido, introduza as suas credenciais.

Enviar um convite

  1. Para enviar um convite para sua conta de email de teste, execute o seguinte comando do PowerShell (substitua "Henry Ross" e pelo nome e henry@contoso.com endereço de email da sua conta de email de teste):

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

  2. O comando envia um convite para o endereço de e-mail especificado. Verifique a saída, que deve ser semelhante ao exemplo a seguir:

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

Certifique-se de que o utilizador existe no diretório

  1. Para verificar se o utilizador convidado foi adicionado à Microsoft Entra ID, execute o seguinte comando (substitua henry@contoso.com pelo seu email convidado):

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

  2. Verifique o resultado para garantir que o utilizador que convidou está listado com um nome principal de utilizador (UPN) no formato emailaddress#EXT#@domain. Por exemplo, henry_contoso.com#EXT#@fabrikam.onmicrosoft.com, onde fabrikam.onmicrosoft.com é a organização da qual você enviou os convites.

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

Limpar recursos

Quando já não precisar da conta de utilizador de teste no diretório, pode eliminá-la. Execute o seguinte comando para eliminar uma conta de utilizador:

Remove-MgUser -UserId '<String>'

Por exemplo:

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

Ou

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

Próximos passos

Neste quickstart, convidou e adicionou um único utilizador convidado ao seu diretório usando o PowerShell. Também pode convidar um utilizador convidado usando o centro de administração Microsoft Entra. Além disso, pode convidar utilizadores convidados em massa usando o PowerShell.

  • Last updated on