Enable-AzureADDirectoryRole

  • Referenz
Modul:
AzureAD

Aktiviert eine vorhandene Verzeichnisrolle in Azure Active Directory.

Syntax

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

Beschreibung

Das Cmdlet Enable-AzureADDirectoryRole aktiviert eine vorhandene Verzeichnisrolle in Azure Active Directory.

Beispiele

Beispiel 1: Aktivieren einer Verzeichnisrolle

# 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.

Mit dem ersten Befehl wird mithilfe des Cmdlets Get-AzureADDirectoryRoleTemplate (./Get-AzureADDirectoryRoleTemplate.md)eine Einladungsrolle mit dem Anzeigenamen Gasteinladung abgerufen. Der Befehl speichert Gastseinladung in der variablen $InviterRole.

Der zweite Befehl zeigt den Inhalt von $InviterRole an.

Der letzte Befehl aktiviert die Verzeichnisrolle in $InviterRole.

Parameter

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert. Zulässige Werte für diesen Parameter:

  • Weiter
  • Ignorieren
  • Diagnosetool
  • SilentlyContinue
  • Beenden
  • Angehalten
Typ:ActionPreference
Aliase:infa
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InformationVariable

Gibt eine Variable an, in der eine Informationsereignismeldung gespeichert werden soll.

Typ:String
Aliase:iv
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RoleTemplateId

Die ID der zu aktivierenden Rollenvorlage

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Hinweise

Weitere Informationen finden Sie im Migrationsleitfaden für Enable-AzureADDirectoryRole zu Microsoft Graph PowerShell.