Freigeben über

Remove-SCSMUserRole

  • Referenz
Modul:
System.Center.Service.Manager

Entfernt eine Benutzerrolle aus dem Dienst-Manager.

Syntax

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.

Typ:System.Management.Automation.SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UserRole

Gibt das UserRole--Objekt an, aus dem der Benutzer entfernt werden soll.

Typ:Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:System.Management.Automation.SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

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.