Compartir a través de

Set-SCOMUserRole

  • Referencia
Módulo:
OperationsManager

Configura un rol de usuario de Operations Manager.

Sintaxis

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:

  • Perfil. Define la colección de operaciones a las que tiene acceso el rol de usuario.
  • Alcance. 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: Adición de 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 de usuarios existente para el rol.

Parámetros

-AllClass

Indica que los permisos que concede un rol de usuario autor se extienden a todas las clases.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AllGroup

Indica que los permisos que concede un rol de usuario se extienden a todos los grupos.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AllTask

Indica que los permisos que concede un rol de usuario autor, operador o operador avanzado se extienden a todas las tareas.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ClassScope

Especifica una matriz de ManagementPackClass objetos que representan las clases a las que tiene acceso un rol Author. Para obtener un objeto ManagementPackClass de , use el cmdlet get-SCOMClass de .

Tipo:ManagementPackClass[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

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

-GroupScope

Especifica una matriz de MonitoringObjectGroup objetos 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, @().

Tipo:MonitoringObjectGroup[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 ninguna salida.

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

-TaskScope

Especifica una matriz de ManagementPackTask objetos 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, @().

Tipo:ManagementPackTask[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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, @().

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-UserRole

Especifica un objeto de rol de usuario. Para obtener un objeto UserRole, usamos el cmdlet Get-SCOMUserRole.

Tipo:UserRole
Posición:1
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:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False