Partilhar via


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

Exemplo do PowerShell

Você pode convidar usuários externos em massa para uma organização a partir de endereços de e-mail armazenados em um arquivo .csv.

  1. Preparar o ficheiro .csv

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

    Nome InvitedUserEmailAddress
    Gmail B2B Invitee b2binvitee@gmail.com
    Outlook B2B invitee b2binvitee@outlook.com
  2. Obtenha o Microsoft Graph PowerShell mais recente

    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. Iniciar sessão no seu inquilino

    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
    }
    

Este cmdlet envia um convite para os endereços de e-mail em convites.csv. Mais recursos desse cmdlet incluem:

  • Texto personalizado na mensagem de e-mail
  • Incluindo um nome a apresentar para o utilizador convidado
  • Envio de mensagens para os utilizadores no campo CC ou supressão de mensagens de e-mail

Exemplo de código

O exemplo de código ilustra como chamar a API de convite e obter a URL de resgate. Use o URL de resgate para enviar um e-mail de convite personalizado. Você pode compor o email com um cliente HTTP, para que possa personalizar sua aparência 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óximos passos