Поделиться через


Enable-AzureADDirectoryRole

Активирует существующую роль каталога в Azure Active Directory.

Синтаксис

Default (по умолчанию)

Enable-AzureADDirectoryRole
    [-InformationAction <ActionPreference>]
    [-InformationVariable <String>]
    [-RoleTemplateId <String>]
    [<CommonParameters>]

Описание

Командлет Enable-AzureADDirectoryRole активирует существующую роль каталога в Azure Active Directory.

Примеры

Пример 1: Включение роли каталога

# Retrieve the Template Role object for the Guest Inviter role
$InviterRole = Get-AzureADDirectoryRoleTemplate | Where-Object {$_.DisplayName -eq "Guest Inviter"}

# Inspect the $Inviter variable to make sure we found the correct template role
$InviterRole

ObjectId                             DisplayName   Description
--------                             -----------   -----------
95e79109-95c0-4d8e-aee3-d01accf2d47b Guest Inviter Guest Inviter has access to invite guest users.

# Enable the Inviter Role
Enable-AzureADDirectoryRole -RoleTemplateId $InviterRole.ObjectId

ObjectId                             DisplayName   Description
--------                             -----------   -----------
03618579-3c16-4765-9539-86d9163ee3d9 Guest Inviter Guest Inviter has access to invite guest users.

Первая команда получает роль пригласителя с отображаемым именем Guest Inviter с помощью командлета Get-AzureADDirectoryRoleTemplate (./Get-AzureADDirectoryRoleTemplate.md). Команда сохраняет Guest Inviter в переменной $InviterRole.

Вторая команда отображает содержимое $InviterRole.

Последняя команда включает роль каталога в $InviterRole.

Параметры

-InformationAction

Указывает, как этот командлет реагирует на событие сведений. Допустимые значения для этого параметра:

  • Продолжать
  • Игнорировать
  • Запросить
  • Продолжать бесшумно
  • Остановка
  • Приостановить

Свойства параметра

Тип:ActionPreference
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:infa

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-InformationVariable

Указывает переменную, в которой будет храниться сообщение об информационном событии.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:iv

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RoleTemplateId

Идентификатор шаблона роли, который необходимо включить

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Примечания

Ознакомьтесь с руководством по миграции Enable-AzureADDirectoryRole в Microsoft Graph PowerShell.