你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Enable-AzureADDirectoryRole

激活 Azure Active Directory 中的现有目录角色。

语法

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

说明

Enable-AzureADDirectoryRole cmdlet 激活 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.

第一个命令通过使用 Get-AzureADDirectoryRoleTemplate (./Get-AzureADDirectoryRoleTemplate.md) cmdlet 获取显示名称为“来宾邀请者”的邀请者角色。 命令将来宾邀请程序存储在 $InviterRole 变量中。

第二个命令显示$InviterRole的内容。

最后一个命令在 $InviterRole 中启用目录角色。

参数

-InformationAction

指定此 cmdlet 如何响应信息事件。 此参数的可接受值为:

  • 继续
  • 忽略
  • 查询
  • SilentlyContinue
  • 停止
  • 挂起
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

指定要在其中存储信息事件消息的变量。

Type:String
Aliases:iv
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RoleTemplateId

要启用的角色模板的 ID

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

备注

请参阅 Enable-AzureADDirectoryRole 到 Microsoft Graph PowerShell 的迁移指南。