Compartilhar via


Código de colaboração B2B e amostras do PowerShell do Microsoft Entra

Exemplo de PowerShell

É possível convidar usuários externos em massa para uma organização a partir de endereço de email armazenado em um arquivo .csv.

  1. Preparar o arquivo .csv

    Crie um novo arquivo .csv e nomeie-o invitations.csv. Neste exemplo, o arquivo é salvo em C:\data e contém as seguintes informações:

    Nome InvitedUserEmailAddress
    Convidado Gmail B2B b2binvitee@gmail.com
    Convidado Outlook B2B b2binvitee@outlook.com
  2. Obter o PowerShell mais recente do Microsoft Graph

    Para usar os novos cmdlets, você deve instalar o módulo atualizado do Microsoft Graph PowerShell. Para obter mais informações, consulte Instalar o SDK do Microsoft Graph PowerShell

  3. Entre em seu locatário

    Connect-MgGraph -Scopes "User.Invite.All"
    
  4. Executar o cmdlet do PowerShell

    $invitations = import-csv C:\data\invitations.csv
    $messageInfo = New-Object Microsoft.Open.MSGraph.Model.InvitedUserMessageInfo
    $messageInfo.customizedMessageBody = "Hey there! Check this out. I created an invitation through PowerShell"
    foreach ($email in $invitations) {
       New-MgInvitation -InviteRedirectUrl "https://wingtiptoysonline-dev-ed.my.woodgrove.com" `
          -InvitedUserDisplayName $email.Name -InvitedUserEmailAddress $email.InvitedUserEmailAddress `
          -InvitedUserMessageInfo $messageInfo -SendInvitationMessage:$true
    }
    

Esse cmdlet envia um convite para os endereços de email em invitations.csv. Os recursos adicionais desse cmdlet incluem:

  • Texto personalizado na mensagem de email
  • Inclusão de um nome de exibição para o usuário convidado
  • Envio de mensagens para CCs ou supressão completa de mensagens de email

Exemplo de código

O exemplo de código ilustra como chamar a API de convite e obter a URL de resgate. Use a URL de resgate para enviar um email de convite personalizado. Você poderá compor o email com um cliente HTTP, de modo que seja possível personalizar a aparência dele e enviá-lo por meio da API do Microsoft Graph.

POST https://graph.microsoft.com/v1.0/invitations
Content-type: application/json
{
  "invitedUserEmailAddress": "david@fabrikam.com",
  "invitedUserDisplayName": "David",
  "inviteRedirectUrl": "https://myapp.contoso.com",
  "sendInvitationMessage": true
}

Próximas etapas