Udostępnij przez


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 jest zapisywany w folderze C:\data i zawiera następujące informacje:

    Nazwa ZaproszonyAdresEmailUżytkownika
    Gmail B2B Invitee b2binvitee@gmail.com
    Zaproszenie B2B programu 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
    }
    

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

  • Dostosowany tekst w wiadomości e-mail
  • Dołączanie nazwy wyświetlanej użytkownika zaproszonego
  • Wysyłanie wiadomości do CCs lub całkowite pomijanie wiadomości e-mail

Przykład kodu

Przykładowy kod ilustruje, jak wywołać interfejs API zaproszenia i uzyskać adres URL do 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
}

Dalsze kroki