Freigeben über

Remove-CMSecurityRole

  • Referenz
Modul:
ConfigurationManager

Entfernen einer benutzerdefinierten Sicherheitsrolle.

Syntax

Remove-CMSecurityRole
      [-Force]
      -InputObject <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMSecurityRole
      [-Force]
      -Id <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMSecurityRole
      [-Force]
      -Name <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um eine benutzerdefinierte Sicherheitsrolle aus Configuration Manager zu entfernen. Geben Sie den Namen oder die ID einer Sicherheitsrolle an, die Sie entfernen möchten, oder verwenden Sie das Cmdlet Get-CMSecurityRole , um eine zu erhalten.

Sie können das Cmdlet Remove-CMSecurityRole verwenden, um alte, nicht benötigte benutzerdefinierte Sicherheitsrollen zu entfernen. Integrierte Sicherheitsrollen können nicht entfernt werden. Jeder Administrator muss über mindestens eine Sicherheitsrolle verfügen. Bevor Sie eine Sicherheitsrolle entfernen, stellen Sie sicher, dass jeder Benutzer zusätzlich zu der rolle, die Sie entfernen, über eine Rolle verfügt.

Weitere Informationen zu Sicherheitsrollen und Berechtigungen finden Sie unter Grundlagen der rollenbasierten Verwaltung in Configuration Manager.

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: Entfernen einer Sicherheitsrolle mithilfe eines Namens

Dieser Befehl entfernt eine Sicherheitsrolle mit dem Namen MainSecurityRole. Der Befehl verwendet den Force-Parameter , sodass Sie nicht zur Bestätigung aufgefordert werden.

Remove-CMSecurityRole -Name "MainSecurityRole" -Force

Beispiel 2: Entfernen einer Sicherheitsrolle mithilfe einer Variablen

Der erste Befehl verwendet das Cmdlet Get-CMSecurityRole , um alle Sicherheitsrollen abzurufen, die mit Custombeginnen, und speichert sie in der variablen $role .

Der zweite Befehl entfernt die erste sicherheitsrelevante Rolle, die im Array gespeichert ist. Da der Force-Parameter nicht angegeben wird, fordert dieser Befehl zur Bestätigung auf.

$role = Get-CMSecurityRole -Name "Custom*"
Remove-CMSecurityRole -InputObject $role[1]

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-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

-Force

Erzwingt die Ausführung des Befehls ohne Benutzerbestätigung.

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 zu entfernenden Sicherheitsrolle an. Dieser Wert ist die RoleID -Eigenschaft. Da dieses Cmdlet nur mit benutzerdefinierten Rollen funktioniert, sollte dieser Wert immer mit dem Standortcode beginnen. (IDs für integrierte Rollen beginnen mit SMS.)

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

-InputObject

Geben Sie ein sicherheitsrollenobjekt an, das entfernt werden soll. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMSecurityRole .

Typ:IResultObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Geben Sie den Namen der zu entfernenden Sicherheitsrolle an.

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

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object