Sdílet prostřednictvím


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 .csv souboru.

  1. Příprava souboru .csv

    Vytvořte nový soubor .csv a pojmenujte ho invitations.csv. V tomto příkladu soubor uložíme do adresáře C:\data a bude obsahovat následující informace:

    Název InvitedUserEmailAddress (E-mailová adresa pozvaného uživatele)
    Pozvaný uživatel B2B z Gmailu b2binvitee@gmail.com
    Pozvaný uživatel B2B z Outlooku b2binvitee@outlook.com
  2. Získání nejnovějšího Prostředí 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 tenantovi

    Connect-MgGraph -Scopes "User.Invite.All"
    
  4. Spuštění rutiny PowerShellu

    $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 e-mailovým adresám v souboru invitations.csv. Mezi další funkce této rutiny patří:

  • Vlastní text v e-mailové zprávě
  • Zahrnutí zobrazovaného jména pozvaného uživatele
  • Odeslání zpráv kopiím nebo úplné potlačení e-mailových zpráv

Ukázka kódu

Ukázka kódu ukazuje, jak volat rozhraní API 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