Руководство по Массовое приглашение пользователей службы совместной работы Azure Active Directory B2B

Если вы используете службу совместной работы Azure Active Directory (Azure AD) B2B для работы с внешними партнерами, вы можете одновременно пригласить несколько гостевых пользователей к вашей организации. Из этого руководства вы узнаете, как с помощью портала Azure выполнять массовую отправку приглашений внешним пользователям. В частности, необходимо выполнить следующие действия:

  • с помощью функции Массовая отправка приглашений пользователям подготовите файл с разделителями-запятыми (.csv), который содержит данные о пользователях и параметрах приглашения;
  • отправите этот CSV-файл в AAD.
  • убедитесь, что пользователи добавлены в каталог.

Если у вас нет учетной записи AAD, создайте бесплатную учетную запись, прежде чем начинать работу.

Сведения о шаблоне CSV

Скачайте и заполните шаблон CSV для массовой отправки, чтобы успешно приглашать гостевых пользователей AAD в пакетном режиме. Загружаемый шаблон CSV будет похож на этот пример:

Spreadsheet for upload and call-outs explaining the purpose and values for each row and column

Структура шаблона CSV

В скачанном шаблоне CSV содержатся следующие строки.

  • Номер версии: Первая строка с номером версии должна сохраняться в отправляемой версии CSV-файла.
  • Заголовки столбцов. Формат заголовков столбцов: <имя элемента> [ИмяСвойства] <Required или пусто>. Например, Email address to invite [inviteeEmail] Required. Некоторые старые версии шаблона могут иметь небольшие отличия.
  • Строка примеров: Мы включили в шаблон строку с примерами значений для каждого столбца. Строку примеров необходимо удалить, заменив реальными значениями.

Дополнительные рекомендации

  • Первые две строки шаблона отправки нельзя удалять или изменять, иначе отправка не будет обработана.
  • Обязательные столбцы перечислены первыми.
  • Мы не рекомендуем добавлять в шаблон новые столбцы. Любые добавляемые столбцы игнорируются и не обрабатываются.
  • Мы рекомендуем скачивать свежие версии шаблона CSV как можно чаще.

Предварительные требования

Требуется две или больше тестовых учетных записей электронной почты, с которых можно отправлять приглашения. Учетные записи должны находиться за пределами вашей организации. Вы можете использовать любой тип учетной записи, включая учетные записи социальных сетей, такие как адреса gmail.com или outlook.com.

Массовая отправка приглашений гостевым пользователям

  1. Войдите на портал Azure с учетной записью глобального администратора в организации.

  2. В области навигации выберите Azure Active Directory.

  3. В разделе Управление выберите элемент Все пользователи.

  4. Выберите элементы Массовые операции>Массовое приглашение.

    Bulk invite button

  5. На странице Массовое приглашение пользователей выберите действие Скачать, чтобы получить готовый CSV-файл со свойствами для приглашения.

    Download the CSV file

  6. Откройте CSV-файл шаблона и добавьте в него строку для каждого гостевого пользователя. Ниже перечислены обязательные параметры.

    • Адрес электронной почты для приглашения обозначает пользователя, который получит приглашение.

    • URL-адрес перенаправления — это URL-адрес, на который перенаправляется приглашенный пользователь после принятия приглашения. Если вы хотите перенаправить пользователя на страницу "Мои приложения", нужно изменить это значение на https://myapps.microsoft.com или https://myapplications.microsoft.com.

    Example of a CSV file with guest users entered

    Примечание

    Не используйте запятые в поле Настраиваемое сообщение с приглашением, так как с ними сообщение будет обработано неправильно.

  7. Сохраните файл.

  8. На странице Массовая отправка приглашений пользователям найдите нужный файл в разделе Отправка CSV-файла. При выборе файла запускается проверка CSV-файла.

  9. После проверки содержимого файла вы увидите сообщение Файл успешно передан. Если будут обнаружены ошибки, их нужно исправить для отправки задания.

  10. Когда файл пройдет проверку, щелкните Отправить, чтобы запустить групповую операцию Azure, с помощью которой добавляются приглашения.

  11. Чтобы просмотреть состояние задания, выберите Щелкните здесь, чтобы просмотреть состояние каждой операции. Также можно выбрать Результаты групповой операции в разделе Действия. Чтобы получить подробные сведения о каждом элементе групповой операции, выберите значения в столбцах # Success (Количество успешных), # Failure (Количество неудачных) или Всего запросов. При возникновении сбоя здесь будут указаны его причины.

    Example of bulk operation results

  12. По завершении задания поступит уведомление о том, что групповая операция выполнена успешно.

Проверка гостевых пользователей в каталоге

Убедитесь, что добавленные гостевые пользователи есть в каталоге, с помощью портала Azure или PowerShell.

Просмотр гостевых пользователей на портале Azure

  1. Войдите на портал Azure с учетной записью администратора пользователей в организации.
  2. В области навигации выберите Azure Active Directory.
  3. В разделе Управление выберите Пользователи.
  4. В разделе Показать выберите Только пользователи-гости и убедитесь, что отображаются только что добавленные пользователи.

Просмотр гостевых пользователей с помощью PowerShell

Для просмотра гостевых пользователей с помощью PowerShell потребуется модуль PowerShell Microsoft.Graph.Users. Затем войдите в систему, используя Connect-MgGraph команду с учетной записью администратора, чтобы предоставить согласие на требуемые области:

Connect-MgGraph -Scopes "User.Read.All"

Выполните следующую команду:

 Get-MgUser -Filter "UserType eq 'Guest'"

Вы должны увидеть приглашенных пользователей в списке с именем участника-пользователя (UPN) в формате emailaddress#EXT#@domain. Например lstokes_fabrikam.com#EXT#@contoso.onmicrosoft.com, где contoso.onmicrosoft.com — это организация, из которой отправляется приглашение.

Очистка ресурсов

Когда тестовая учетная запись пользователя станет не нужна, ее можно будет удалить из каталога на странице "Пользователи" портала Azure. Для этого нужно установить флажок рядом с гостевым пользователем и щелкнуть Удалить.

Кроме того, для удаления учетной записи пользователя можно выполнить следующую команду PowerShell:

 Remove-MgUser -UserId "<UPN>"

Например: Remove-MgUser -UserId "lstokes_fabrikam.com#EXT#@contoso.onmicrosoft.com"

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

С помощью этого руководства вы отправили массовые приглашения гостевым пользователям за пределами своей организации. Затем узнайте, как работает процесс активации приглашения.