Remove-SCSMUserRole
Entfernt eine Benutzerrolle aus dem Dienst-Manager.
Syntax
Default (Standardwert)
Remove-SCSMUserRole
[-UserRole] <Role[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das cmdlet Remove-SCSMUserRole entfernt eine Benutzerrolle aus Service Manager. Einige Benutzerrollen sind 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
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
Parametereigenschaften
| Typ: | System.Management.Automation.SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-UserRole
Gibt das UserRole--Objekt an, aus dem der Benutzer entfernt werden soll.
Parametereigenschaften
| Typ: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
| Typ: | System.Management.Automation.SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Eingaben
Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role
Sie können eine Benutzerrolle an den parameter UserRole übergeben. Ein Objekt, z. B. das vom Cmdlet Get-SCSMUserRole zurückgegeben wird.
Ausgaben
None.
Dieses Cmdlet generiert keine Ausgabe.