Compartir a través de


Get-SCOMUserRole

Obtiene roles de usuario.

Sintaxis

Empty (Es el valor predeterminado).

Get-SCOMUserRole
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromUserRoleDisplayName

Get-SCOMUserRole
    [-DisplayName] <String[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromUserRoleId

Get-SCOMUserRole
    -Id <Guid[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromUserRoleName

Get-SCOMUserRole
    -Name <String[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

Description

El cmdlet Get-SCOMUserRole obtiene roles de usuario. Un rol de usuario combina dos elementos:

  • 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.

Ejemplos

Ejemplo 1: Obtención de información de roles de usuario para un rol

PS C:\>Get-SCOMUserRole -Name "OperationsManagerReadOnlyOperators"

Este comando obtiene la información del rol de usuario denominado OperationsManagerReadOnlyOperators.

Parámetros

-ComputerName

Especifica una matriz de nombres de equipos. El cmdlet establece conexiones temporales con grupos de administración para estos equipos. Puede usar nombres NetBIOS, direcciones IP o nombres de dominio completos (FQDN). Para especificar el equipo local, escriba el nombre del equipo, localhost o un punto (.).

El equipo debe ejecutar el servicio de acceso a datos de System Center.

Si no especifica este parámetro, el valor predeterminado es el equipo para la conexión del grupo de administración actual.

Propiedades del parámetro

Tipo:

String[]

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

-Credential

Especifica la cuenta de usuario en la que se ejecuta la conexión del grupo de administración. Especifique un objeto de PSCredential, como el que devuelve el cmdlet get-credential de , para este parámetro. Para obtener más información sobre los objetos de credenciales, escriba Get-Help Get-Credential.

Si especifica un equipo en el parámetro computerName , use una cuenta que tenga acceso a ese equipo. El valor predeterminado es el usuario actual.

Propiedades del parámetro

Tipo:PSCredential
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

-DisplayName

Especifica una matriz que contiene los nombres para mostrar de los objetos de rol de usuario. El cmdlet toma cada cadena de la matriz y busca coincidencias entre los nombres para mostrar de los objetos de rol de usuario con los que funciona este cmdlet. Los valores de este parámetro varían en función de los módulos de administración localizados que se importen en el grupo de administración y la configuración regional del usuario que ejecuta Windows PowerShell.

Propiedades del parámetro

Tipo:

String[]

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

Conjuntos de parámetros

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

-Id

Especifica una matriz de identificadores para objetos de rol de usuario. El cmdlet toma cada identificador único global (GUID) de la matriz y busca coincidencias con el identificador de propiedades de los objetos de rol de usuario que obtiene el cmdlet.

Propiedades del parámetro

Tipo:

Guid[]

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

Conjuntos de parámetros

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

-Name

Especifica una matriz que contiene los nombres de los objetos de rol de usuario. El cmdlet toma cada cadena de la matriz y busca coincidencias con las propiedades Name de los objetos de rol de usuario que obtiene el cmdlet.

Propiedades del parámetro

Tipo:

String[]

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

Conjuntos de parámetros

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

-SCSession

Especifica una matriz de objetos connection. Para obtener objetos Connection, especifique el cmdlet get-SCOMManagementGroupConnection .

Si no especifica un valor para este parámetro, el cmdlet usa la conexión persistente activa a un grupo de administración. Use el parámetro SCSession para especificar una conexión persistente diferente. Puede crear una conexión temporal a un grupo de administración mediante el computerName de y parámetros de Credential. Para obtener más información, escriba Get-Help about_OpsMgr_Connections.

Propiedades del parámetro

Tipo:

Connection[]

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

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.