Set-SCOMUserRole
Configura un rol de usuario de Operations Manager.
Syntax
Set-SCOMUserRole
[-UserRole] <UserRole>
-User <String[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-SCOMUserRole
[-UserRole] <UserRole>
[-AllClass]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-SCOMUserRole
[-UserRole] <UserRole>
-ClassScope <ManagementPackClass[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-SCOMUserRole
[-UserRole] <UserRole>
[-AllTask]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-SCOMUserRole
[-UserRole] <UserRole>
-TaskScope <ManagementPackTask[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-SCOMUserRole
[-UserRole] <UserRole>
[-AllGroup]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-SCOMUserRole
[-UserRole] <UserRole>
-GroupScope <MonitoringObjectGroup[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
El cmdlet Set-SCOMUserRole configura un rol de usuario de System Center Operations Manager. Un rol de usuario contiene dos características:
- Profile (Perfil). Define la colección de operaciones a las que tiene acceso el rol de usuario.
- Ámbito. Define los límites de las operaciones de perfil; por ejemplo, tareas y grupos.
Puede usar este cmdlet para actualizar la lista de usuarios o el ámbito del rol de usuario.
Ejemplos
Ejemplo 1: Conceder a un rol de usuario acceso a todas las tareas
PS C:\>$Role = Get-SCOMUserRole -Name "Constoso Operators"
PS C:\> $Role | Set-SCOMUserRole -AllTask -PassThru | Set-SCOMUserRole -AllGroup
En este ejemplo se muestra cómo actualizar un rol de usuario para concederle acceso a todas las tareas.
El primer comando obtiene el objeto de rol de usuario denominado Operadores de Contoso y almacena el objeto en la variable $Role.
El segundo comando usa el operador de canalización para pasar el rol de usuario almacenado en la variable $Role al cmdlet Set-SCOMUserRole . Este cmdlet concede al rol de usuario acceso a todas las tareas y devuelve el objeto de rol de usuario actualizado. A continuación, el comando pasa el objeto actualizado a Set-SCOMUserRole mediante el operador de canalización, que aprueba el rol para todos los grupos.
Ejemplo 2: Conceder a un rol de usuario acceso a tareas específicas
PS C:\>$Role = Get-SCOMUserRole -Name "Constoso SQL Operators"
PS C:\> $NewTaskList = Get-SCOMTask -Name "*SQL*"
PS C:\> $Role | Set-SCOMUserRole -TaskScope $NewTaskList
En este ejemplo se muestra cómo actualizar un rol de usuario para concederle acceso a tareas específicas.
El primer comando obtiene el objeto de rol de usuario denominado Operadores SQL de Contoso y almacena el objeto en la variable $Role.
El segundo comando obtiene todos los objetos de tarea con SQL en sus nombres y almacena los objetos en la variable $NewTaskList.
El último comando usa el operador de canalización para pasar el rol de usuario almacenado en la variable $Role a Set-SCOMUserRole, que restablece la colección de tareas aprobadas a la lista almacenada en la variable $NewTaskList.
Ejemplo 3: Agregar un usuario a un rol de usuario
PS C:\>$Role = Get-SCOMUserRole -Name "Contoso Read-Only Operators"
PS C:\> $Role | Set-SCOMUserRole -User ($Role.Users + "Contoso\Cesar")
En este ejemplo se agrega un usuario a un rol de usuario.
El primer comando obtiene el objeto de rol de usuario denominado Contoso Read-Only Operadores y almacena el objeto en la variable $Role.
El segundo comando usa el operador de canalización para pasar el objeto almacenado en la variable $Role al cmdlet Set-SCOMUserRole , que agrega el usuario Contoso\Cesar a la lista existente de usuarios para el rol.
Parámetros
-AllClass
Indica que los permisos que concede un rol de usuario Autor se extienden a todas las clases.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllGroup
Indica que los permisos que concede un rol de usuario se extienden a todos los grupos.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllTask
Indica que los permisos que concede un rol de usuario Autor, Operador o Operador avanzado se extienden a todas las tareas.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClassScope
Especifica una matriz de objetos ManagementPackClass que representan las clases a las que tiene acceso un rol Author. Para obtener un objeto ManagementPackClass , use el cmdlet Get-SCOMClass .
Type: | ManagementPackClass[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GroupScope
Especifica una matriz de objetos MonitoringObjectGroup que representan los grupos a los que tiene acceso un rol de usuario. Para obtener un objeto de grupo de objetos de supervisión, use el cmdlet Get-MonitoringObjectGroup .
Si no especifica un valor para este parámetro, el rol tiene acceso a todos los grupos. Para denegar el acceso de rol a todos los grupos, especifique $Null o una matriz vacía, @().
Type: | MonitoringObjectGroup[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Indica que el cmdlet crea o modifica un objeto que un comando puede usar en la canalización. De forma predeterminada, este cmdlet no genera ningún resultado.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TaskScope
Especifica una matriz de objetos ManagementPackTask que representan las tareas a las que tiene acceso un rol autor, operador o operador avanzado.
Si no especifica un valor para este parámetro, el rol tiene acceso a todas las tareas. Para denegar el acceso al rol Autor, Operador o Operador avanzado a todas las tareas, especifique $Null o una matriz vacía, @().
Type: | ManagementPackTask[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-User
Especifica una matriz de nombres de usuario que forman parte de este rol de usuario. Esta lista reemplaza a cualquier lista de usuarios existente. Para borrar todos los usuarios de un rol de usuario, especifique $Null o una matriz vacía, @().
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserRole
Especifica un objeto de función de usuario. Para obtener un objeto UserRole , usamos el cmdlet Get-SCOMUserRole .
Type: | UserRole |
Position: | 1 |
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: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |