Remove-SCSMUserRole

  • Referenz
Modul:
System.Center.Service.Manager

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:System.Management.Automation.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:Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.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:System.Management.Automation.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.