Примеры кода совместной работы Microsoft Entra B2B и PowerShell

Пример с PowerShell

Вы можете массово приглашать внешних пользователей в организацию из адресов электронной почты, которые вы храните в файле .csv.

  1. Подготовка файла .csv

    Создайте файл .csv и назовите его invitations.csv. В этом примере файл сохранен в папке C:\data. Он содержит следующие сведения:

    Имя. InvitedUserEmailAddress
    Приглашенный Gmail B2B b2binvitee@gmail.com
    Приглашенный B2B Outlook b2binvitee@outlook.com
  2. Получение последней версии Microsoft Graph PowerShell

    Чтобы использовать новые командлеты, необходимо установить обновленный модуль Microsoft Graph PowerShell. Дополнительные сведения см. в разделе "Установка пакета SDK Для Microsoft Graph PowerShell"

  3. Войдите в свой клиент:

    Connect-MgGraph -Scopes "User.Invite.All"
    
  4. Выполнение командлета 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
    }
    

Этот командлет отправляет приглашение на электронные адреса, указанные в файле invitations.csv. Дополнительные возможности этого командлета:

  • настраиваемый текст электронного сообщения;
  • добавление отображаемого имени для приглашенного пользователя;
  • отправка копий сообщений или полное подавление электронных сообщений.

Пример кода

В этом примере кода показано, как вызвать API приглашения и получить URL-адрес активации. Используйте этот URL-адрес активации, чтобы отправить настраиваемое сообщение с приглашением по электронной почте. Вы можете создать сообщение электронной почты с помощью HTTP-клиента, чтобы настроить его внешний вид и отправить через API 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
}

Следующие шаги