Remove-CMSecurityRole
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 Custom
beginnen, 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
Ähnliche Themen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für