Compartir vía


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

Ejemplo de PowerShell

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

  1. Preparación del archivo .csv

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

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

    Para usar los cmdlets nuevos, debe instalar el módulo PowerShell de Microsoft Graph actualizado. Para obtener más información, consulte Instalación del SDK de PowerShell en 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

Código de ejemplo

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