Przykłady kodu współpracy B2B i programu PowerShell firmy Microsoft Entra

Przykład programu PowerShell

Możesz zbiorczo zapraszać użytkowników zewnętrznych do organizacji z adresów e-mail przechowywanych w pliku .csv.

  1. Przygotowywanie pliku .csv

    Utwórz nowy plik .csv i nadaj mu nazwę invitations.csv. W tym przykładzie plik został zapisany w folderze C:\data i zawiera następujące informacje:

    Nazwisko InvitedUserEmailAddress
    Osoba zaproszona B2B w usłudze Gmail b2binvitee@gmail.com
    Osoba zaproszona B2B w usłudze Outlook b2binvitee@outlook.com
  2. Pobieranie najnowszej wersji programu Microsoft Graph PowerShell

    Aby użyć nowych poleceń cmdlet, należy zainstalować zaktualizowany moduł programu Microsoft Graph PowerShell. Aby uzyskać więcej informacji, zobacz Instalowanie zestawu Microsoft Graph PowerShell SDK

  3. Zaloguj się do dzierżawy

    Connect-MgGraph -Scopes "User.Invite.All"
    
  4. Uruchom polecenie cmdlet programu 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
    }
    

To polecenie cmdlet wysyła zaproszenie na adresy e-mail podane w pliku invitations.csv. Więcej funkcji tego polecenia cmdlet obejmuje:

  • Dostosowany tekst w wiadomości e-mail
  • Dodanie nazwy wyświetlanej dla zaproszonego użytkownika
  • Wysyłanie wiadomości na adresy DW lub całkowite pominięcie wiadomości e-mail

Przykładowy kod

Przykładowy kod ilustruje sposób wywoływania interfejsu API zaproszenia i uzyskiwania adresu URL realizacji. Użyj adresu URL realizacji, aby wysłać niestandardową wiadomość e-mail z zaproszeniem. Możesz utworzyć wiadomość e-mail przy użyciu klienta HTTP, aby dostosować jego wygląd i wysłać go za pośrednictwem interfejsu API programu 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
}

Następne kroki