Get-DSPrincipalRoleAssignment

Übersicht

Die administrativen Rollen abrufen, die ein Benutzer, eine Benutzergruppe oder eine Anwendungsidentität besitzt.

Syntax

__AllParameterSets

Get-DSPrincipalRoleAssignment -PrincipalId <guid> [-IncludeIndirect] [<CommonParameters>]

Beschreibung

Jede administrative Rollenzuweisung abrufen, die der angegebene Zugewiesene über jeden Bereich besitzt. Umgekehrte Suche von Get-DSRoleAssignment: statt "wer besitzt eine Rolle in diesem Bereich" beantwortet dies "welche Rollen besitzt dieser Zugewiesene, irgendwo". -IncludeIndirect verwenden, um auch Rollen anzuzeigen, die einer Benutzergruppe gewährt wurden, der der Zugewiesene angehört; wenn eine Zuweisung von einer Gruppe stammt, identifizieren GroupID/GroupName diese Gruppe und die Zuweisung wird nicht direkt vom Zugewiesenen gehalten.

Beispiele

Beispiel 1

PS C:\> Get-DSPrincipalRoleAssignment -PrincipalId $userID

Jede einem Benutzer direkt zugewiesene Rolle abrufen.

Beispiel 2

PS C:\> Get-DSPrincipalRoleAssignment -PrincipalId $userID -IncludeIndirect

Auch Rollen einschließen, die der Benutzer durch die Mitgliedschaft in einer Benutzergruppe besitzt.

Parameter

-IncludeIndirect

Auch Rollen einschließen, die einer Benutzergruppe gewährt wurden, der der Zugewiesene angehört, nicht nur direkte Zuweisungen.

Type: System.Management.Automation.SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PrincipalId

ID des Benutzers, der Benutzergruppe oder der Anwendungsidentität, die gesucht wird.

Type: System.Guid
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

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

Ausgaben

RemoteDesktopManager.PowerShellModule.PSOutputObject.PSPrincipalRoleAssignment

Hinweise

Weitere Informationen erhalten Sie mit "Get-Help Get-DSPrincipalRoleAssignment -detailed". Technische Informationen erhalten Sie mit "Get-Help Get-DSPrincipalRoleAssignment -full".