Compartir a través de

Update-SCSMUserRole

  • Referencia
Módulo:
System.Center.Service.Manager

Establece la propiedad UserRole para un usuario de Service Manager.

Sintaxis

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

Description

El cmdlet Update-SCSMUserRole establece la propiedad UserRole para un usuario de Service Manager.

Ejemplos

Ejemplo 1: Agregar un usuario a un rol de usuario

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

El primer comando obtiene el rol de usuario denominado IncidentResolvers mediante Get-SCSMUserRoley, a continuación, lo almacena en la variable $Role.

El segundo comando obtiene un usuario mediante el cmdlet Get-SCSMUser y, a continuación, almacena ese objeto en la variable $User.

El tercer comando anexa $User a la propiedad usuario de de $Role.

El comando final actualiza el rol para que coincida con el valor actual de $Role.

Ejemplo 2: Quitar un usuario de un rol

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

En este ejemplo se quita un usuario de un rol de usuario. El primer comando muestra los administradores.

Parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:System.Management.Automation.SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PassThru

Indica que este cmdlet devuelve el rol de usuario que actualiza. Puede pasar este objeto a otros cmdlets.

Tipo:System.Management.Automation.SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-UserRole

Especifica el objeto UserRole al que se va a agregar el usuario.

Tipo:Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:System.Management.Automation.SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role

Puede canalizar un objeto UserRole al parámetro UserRole. Para obtener un rol de usuario, use el cmdlet Get-SCSMUserRole.

Salidas

None.

Este cmdlet no genera ninguna salida.