Freigeben über

Enable-AzureADDirectoryRole

Modul:
AzureAD Module

Aktiviert eine vorhandene Verzeichnisrolle in Azure Active Directory.

Syntax

Default (Standardwert) 

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

Beschreibung

Mit dem Cmdlet Enable-AzureADDirectoryRole wird eine vorhandene Verzeichnisrolle in Azure Active Directory aktiviert.

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 Gasteinladender abgerufen. Der Befehl speichert Guest Inviter in der Variablen $InviterRole.

Der zweite Befehl zeigt den Inhalt von $InviterRole an.

Mit dem letzten Befehl wird die Verzeichnisrolle in $InviterRole aktiviert.

Parameter

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert. Die zulässigen Werte für diesen Parameter sind:

  • Fortfahren
  • Ignorieren
  • Inquire
  • SilentlyContinue (leise fortfahren)
  • Stopp!
  • Anhalten

Parametereigenschaften

Typ:ActionPreference
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:infa

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-InformationVariable

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Iv

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RoleTemplateId

Die ID der zu aktivierenden Rollenvorlage

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Hinweise

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