Примеры кода и команд PowerShell для службы совместной работы Azure Active Directory B2B

Пример PowerShell

Можно выполнить массовое приглашение внешних пользователей в организацию, используя электронные адреса, сохраненные в CSV-файле.

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

    Имя InvitedUserEmailAddress
    Приглашенный Gmail B2B b2binvitee@gmail.com
    Приглашенный B2B Outlook b2binvitee@outlook.com
  2. Установите последнюю версию Azure AD PowerShell. Для использования новых командлетов необходимо установить обновленный модуль Azure AD PowerShell, который можно скачать на странице выпусков модуля PowerShell.

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

    $cred = Get-Credential
    Connect-AzureAD -Credential $cred
    
  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-AzureADMSInvitation -InvitedUserEmailAddress $email.InvitedUserEmailAddress -InvitedUserDisplayName $email.Name -InviteRedirectUrl https://wingtiptoysonline-dev-ed.my.salesforce.com -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
}

Дальнейшие действия