Freigeben über

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 vom Configuration Manager-Standort 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-Standortlaufwerk aus, z. B PS XYZ:\>. . 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.

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

-ForceWildcardHandling

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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 ".

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

-Name

Geben Sie den Namen der abzurufenden Sicherheitsrolle an.

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

Eingaben

None

Ausgaben

IResultObject[]

IResultObject

Hinweise

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