Enable-AzureADDirectoryRole

在 Azure Active Directory 中啟動現有的目錄角色。

Syntax

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

Description

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
  • Stop
  • 暫止
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

要啟用的角色範本識別碼

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

備註

請參閱 Enable-AzureADDirectoryRole 至 Microsoft Graph PowerShell 的移轉指南。