Remove-SCSMUserRole
Entfernt eine Benutzerrolle aus Service Manager.
Syntax
Remove-SCSMUserRole
[-UserRole] <Role[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Cmdlet Remove-SCSMUserRole entfernt eine Benutzerrolle aus Service Manager. Einige Benutzerrollen werden als Systembenutzerrollen festgelegt und können nicht entfernt werden. Sie können den folgenden Befehl ausführen, um das Issystem-Attribut aller Benutzerrollenobjekte anzuzeigen.
Get-SCSMUserRole | Format-Table -Property DisplayName,{$_.userrole.issystem} -AutoSize
Wenn die Benutzerrolle nicht entfernt werden kann, gibt dieses Cmdlet einen nicht beendeten Fehler zurück.
Beispiele
Beispiel 1: Entfernen einer Benutzerrolle
PS C:\>Get-SCSMUserRole -Name "CustomUser" | Remove-SCSMUserRole
Dieser Befehl ruft die Benutzerrolle "CustomUser" mithilfe des Cmdlets Get-SCSMUserRole ab. Der Befehl übergibt dieses Objekt mithilfe des Pipelineoperators an das aktuelle Cmdlet. Dieses Cmdlet löscht diese Benutzerrolle.
Parameter
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserRole
Gibt das UserRole-Objekt an, aus dem der Benutzer entfernt werden soll.
Type: | Role[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Zeigt, was geschieht, 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.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role
Sie können eine Benutzerrolle an den UserRole-Parameter übergeben. Ein Objekt, z. B. das vom Cmdlet Get-SCSMUserRole zurückgegeben wird.
Ausgaben
None.
Dieses Cmdlet generiert keine Ausgabe.