Update-SCSMUserRole
Establece la propiedad UserRole para un usuario de Service Manager.
Syntax
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 llamado IncidentResolvers mediante Get-SCSMUserRole y, 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 User 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 solicita su confirmación antes de ejecutar el cmdlet.
Type: | System.Management.Automation.SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Indica que este cmdlet devuelve el rol de usuario que actualiza. Puede pasar este objeto a otros cmdlets.
Type: | System.Management.Automation.SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserRole
Especifica el objeto UserRole al que se va a agregar el usuario.
Type: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
Type: | System.Management.Automation.SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 ningún resultado.