Microsoft Entra B2B-samarbetskod och PowerShell-exempel

PowerShell-exempel

Du kan massinbjuda externa användare till en organisation från e-postadresser som du lagrar i en .csv fil.

  1. Förbereda .csv-filen

    Skapa en ny .csv fil och ge den namnet invitations.csv. I det här exemplet sparas filen i C:\data och innehåller följande information:

    Name InvitedUserEmailAddress
    Gmail B2B-inbjuden b2binvitee@gmail.com
    Outlook B2B-inbjuden b2binvitee@outlook.com
  2. Hämta den senaste Microsoft Graph PowerShell

    Om du vill använda de nya cmdletarna måste du installera den uppdaterade Microsoft Graph PowerShell-modulen. Mer information finns i Installera Microsoft Graph PowerShell SDK

  3. Logga in på ditt innehav

    Connect-MgGraph -Scopes "User.Invite.All"
    
  4. Kör PowerShell-cmdleten

    $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
    }
    

Den här cmdleten skickar en inbjudan till e-postadresserna i invitations.csv. Fler funktioner i den här cmdleten är:

  • Anpassad text i e-postmeddelandet
  • Inkludera ett visningsnamn för den inbjudna användaren
  • Skicka meddelanden till CC eller förhindra e-postmeddelanden helt

Kodexempel

Kodexemplet visar hur du anropar inbjudnings-API:et och hämtar inlösnings-URL:en. Använd url:en för inlösen för att skicka ett anpassat e-postmeddelande med inbjudan. Du kan skriva e-postmeddelandet med en HTTP-klient så att du kan anpassa hur det ser ut och skicka det via Microsoft Graph-API:et.

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
}

Nästa steg