Compartir a través de


Código de colaboración B2B y ejemplos de PowerShell de Microsoft Entra

Ejemplo de PowerShell

Puede invitar de forma masiva a usuarios externos a una organización desde direcciones de correo electrónico que almacene en un archivo de .csv.

  1. Preparación del archivo .csv

    Cree un nuevo archivo .csv y asígnelo el nombre invitations.csv. En este ejemplo, el archivo se guarda en C:\data y contiene la información siguiente:

    Nombre CorreoElectrónicoDelUsuarioInvitado
    Invitado de B2B de Gmail b2binvitee@gmail.com
    Invitado de B2B de Outlook b2binvitee@outlook.com
  2. Obtención de la versión más reciente de Microsoft Graph PowerShell

    Para usar los nuevos cmdlets, debe instalar el módulo de PowerShell de Microsoft Graph actualizado. Para obtener más información, consulte Instalar el SDK de PowerShell de Microsoft Graph

  3. Inicie sesión en el espacio.

    Connect-MgGraph -Scopes "User.Invite.All"
    
  4. Ejecución del cmdlet de 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 enviará una invitación a la dirección de correo electrónico de invitations.csv. Algunas características adicionales de este cmdlet incluyen:

  • Texto personalizado en el mensaje de correo electrónico
  • Inclusión de un nombre para mostrar de los usuarios invitados
  • Envío de mensajes en copias o supresión de mensajes de correo electrónico por completo

Ejemplo de código

En el ejemplo de código se muestra cómo llamar a la API de invitación y obtener la dirección URL de canje. Use la dirección URL de canje para enviar un correo electrónico de invitación personalizado. Puedes redactar el correo electrónico con un cliente HTTP, por lo que puedes personalizar el aspecto y enviarlo a través de la API de 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
}

Pasos siguientes