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-Websitelaufwerk aus, z. PS XYZ:\>B. . 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.

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

-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

-Force

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

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 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.)

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

-InputObject

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

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

-Name

Geben Sie den Namen der zu entfernenden Sicherheitsrolle an.

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

-WhatIf

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

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

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object