Get-CMSecurityRole

  • Referenz
Modul:
ConfigurationManager

Abrufen von Sicherheitsrollen.

Syntax

Get-CMSecurityRole
   [-Name <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMSecurityRole
   -Id <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um eine oder mehrere Sicherheitsrollen von der Configuration Manager-Website abzurufen. Weitere Informationen zu Sicherheitsrollen und Berechtigungen finden Sie unter Grundlagen der rollenbasierten Verwaltung in Configuration Manager.

Wenn Ihr Konto nicht über berechtigungen zum Anzeigen von Sicherheitsrollen auf der Website verfügt, gibt dieses Cmdlet keine Ergebnisse zurück.

Hinweis

Führen Sie Configuration Manager Cmdlets auf dem Configuration Manager-Websitelaufwerk aus, z. PS XYZ:\>B. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Abrufen aller Sicherheitsrollen

In diesem Beispiel werden alle Rollen und IDs für die Website aufgelistet.

Get-CMSecurityRole | Select-Object RoleID, RoleName

Beispiel 2: Abrufen einer Sicherheitsrolle mithilfe eines Wildcards

Dieser Befehl ruft alle Sicherheitsrollen ab, die über einen Namen verfügen, der mit App beginnt.

Get-CMSecurityRole -Name "App*"

Beispiel 3: Auflisten aller benutzerdefinierten Sicherheitsrollen

Dieser Befehl gibt alle Sicherheitsrollen zurück, die nicht integriert sind.

Get-CMSecurityRole | Where-Object { $_.IsBuiltIn -eq $false }

Parameter

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

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

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

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

-Id

Geben Sie die ID der abzurufenden Sicherheitsrolle an. Dieser Wert ist die RoleID -Eigenschaft, z. B SMS000AR . für die Rolle "Betriebssystembereitstellungs-Manager ".

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

-Name

Geben Sie den Namen der abzurufenden Sicherheitsrolle an.

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

Eingaben

None

Ausgaben

IResultObject[]

IResultObject

Hinweise

Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_Role WMI-Serverklasse.