Freigeben über

Update-SCSMUserRole

  • Referenz
Modul:
System.Center.Service.Manager

Legt die UserRole-Eigenschaft für einen Dienst-Manager-Benutzer fest.

Syntax

Update-SCSMUserRole
      [-UserRole] <Role[]>
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Update-SCSMUserRole legt die UserRole- eigenschaft für einen Service Manager-Benutzer fest.

Beispiele

Beispiel 1: Hinzufügen eines Benutzers zu einer Benutzerrolle

PS C:\>$Role = Get-SCSMUserRole -Name "IncidentResolvers"
PS C:\> $User = Get-SCSMUser -UserName "PattiFuller"
PS C:\> $Role.User += $User
PS C:\> Update-SCSMUserRole -Role $Role

Der erste Befehl ruft die Benutzerrolle mit dem Namen IncidentResolvers mithilfe von Get-SCSMUserRoleab und speichert sie dann in der $Role Variablen.

Der zweite Befehl ruft einen Benutzer mithilfe des Cmdlets Get-SCSMUser ab und speichert dieses Objekt dann in der $User Variablen.

Der dritte Befehl fügt $User an die eigenschaft User von $Role an.

Der letzte Befehl aktualisiert die Rolle so, dass sie dem aktuellen Wert von $Role entspricht.

Beispiel 2: Entfernen eines Benutzers aus einer Rolle

PS C:\>Get-SCSMUserRole -Name "Administrators"
WOODGROVE\Administrator
WOODGROVE\Domain Admins


The second command assigns the user role previously displayed to the $Role variable. 
PS C:\>$Role = Get-SCSMUserRole -Name "Administrators"

The third command assigns the first user role to the **User** property of $Role. This command that property, removing all except the specified user. 
PS C:\>$Role.User = $Role.Users[0]

The final command updates the role to match the current value of $Role.
PS C:\>Update-SCSMUserRole -Role $Role

In diesem Beispiel wird ein Benutzer aus einer Benutzerrolle entfernt. Der erste Befehl zeigt Administratoren an.

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

-PassThru

Gibt an, dass dieses Cmdlet die Benutzerrolle zurückgibt, die aktualisiert wird. Sie können dieses Objekt an andere Cmdlets übergeben.

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

-UserRole

Gibt das UserRole--Objekt an, dem der Benutzer hinzugefügt 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 ein UserRole--Objekt an den parameter UserRole übergeben. Verwenden Sie das Cmdlet Get-SCSMUserRole, um eine Benutzerrolle abzurufen.

Ausgaben

None.

Dieses Cmdlet generiert keine Ausgabe.