Kód spolupráce Microsoft Entra B2B a ukázky PowerShellu

Příklad PowerShellu

Externí uživatele můžete hromadně pozvat do organizace z e-mailových adres, které ukládáte do souboru .csv.

  1. Příprava souboru .csv

    Vytvořte nový soubor .csv a pojmenujte ho invitations.csv. V tomto příkladu se soubor uloží do složky C:\data a obsahuje následující informace:

    Název EmailováAdresaPozvanéhoUživatele
    Pozvaný uživatel Gmail B2B b2binvitee@gmail.com
    Outlook pozvaný B2B b2binvitee@outlook.com
  2. Získejte nejnovější modul Microsoft Graph PowerShell

    Pokud chcete používat nové rutiny, musíte nainstalovat aktualizovaný modul Microsoft Graph PowerShellu. Další informace najdete v tématu Instalace sady Microsoft Graph PowerShell SDK.

  3. Přihlášení k vašemu nájemnímu účtu

    Connect-MgGraph -Scopes "User.Invite.All"
    
  4. Spusťte rutinu 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
    }
    

Tato rutina odešle pozvánku na e-mailové adresy v invitations.csv. Další funkce této rutiny zahrnují:

  • Přizpůsobený text v e-mailové zprávě
  • Zahrnutí zobrazovaného jména pozvaného uživatele
  • Odesílání zpráv do CCS nebo potlačování e-mailových zpráv úplně

Ukázka kódu

Ukázka kódu ukazuje, jak volat rozhraní API pro pozvánky a získat adresu URL uplatnění. K odeslání vlastního e-mailu s pozvánkou použijte adresu URL uplatnění. E-mail můžete vytvořit pomocí klienta HTTP, abyste mohli přizpůsobit jeho vzhled a odeslat ho prostřednictvím rozhraní Microsoft Graph API.

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
}

Další kroky