Compartir a través de

Set-SCOMUserRole

Módulo:
OperationsManager Module

Configura un rol de usuario de Operations Manager.

Sintaxis

FromUser 

Set-SCOMUserRole
    [-UserRole] <UserRole>
    -User <String[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FromAllClassScope 

Set-SCOMUserRole
    [-UserRole] <UserRole>
    [-AllClass]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FromClassScope 

Set-SCOMUserRole
    [-UserRole] <UserRole>
    -ClassScope <ManagementPackClass[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FromAllTaskScope 

Set-SCOMUserRole
    [-UserRole] <UserRole>
    [-AllTask]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FromTaskScope 

Set-SCOMUserRole
    [-UserRole] <UserRole>
    -TaskScope <ManagementPackTask[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FromAllGroupScope 

Set-SCOMUserRole
    [-UserRole] <UserRole>
    [-AllGroup]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FromGroupcope 

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.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

FromAllClassScope
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AllGroup

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

FromAllGroupScope
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AllTask

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

FromAllTaskScope
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 .

Propiedades del parámetro

Tipo:

ManagementPackClass[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

FromClassScope
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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, @().

Propiedades del parámetro

Tipo:

MonitoringObjectGroup[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

FromGroupcope
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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, @().

Propiedades del parámetro

Tipo:

ManagementPackTask[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

FromTaskScope
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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, @().

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

FromUser
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-UserRole

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

Propiedades del parámetro

Tipo:UserRole
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:1
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.