Compartir a través de

Get-SCUserRole

  • Referencia
Módulo:
VirtualMachineManager

Obtiene un rol de usuario de VMM.

Sintaxis

Get-SCUserRole
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-UserRoleProfile <Profile>]
   [-ID <Guid>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

El cmdlet Get-SCUserRole obtiene uno o varios roles de usuario de Virtual Machine Manager (VMM). VMM usa la seguridad basada en roles para definir los límites dentro de los cuales pueden funcionar los miembros de un rol de usuario determinado y el conjunto de miembros de operaciones permitidos de un rol de usuario puede realizar.

Para obtener información sobre cómo crear roles de usuario, escriba Get-Help New-SCUserRole.

Para obtener información sobre cómo establecer las propiedades de un rol de usuario, incluido el ámbito de los administradores delegados y de solo lectura, así como el ámbito y las acciones de los usuarios de autoservicio, escriba Get-Help Set-SCUserRole.

Ejemplos

Ejemplo 1: Obtener todos los roles de usuario

PS C:\> Get-SCUserRole -VMMServer "VMMServer01.Contoso.com"

Este comando obtiene todos los roles de usuario de VMM en el servidor denominado VMMServer01.Contoso.com. El comando muestra información sobre cada rol de usuario.

Ejemplo 2: Obtención de un rol de usuario por nombre

PS C:\> Get-SCUserRole -Name "Administrator"

Este comando obtiene el objeto de rol de usuario denominado Administrador. El comando muestra información sobre ese rol de usuario.

Ejemplo 3: Obtener un rol de usuario por perfil

PS C:\> Get-SCUserRole -VMMServer "VMMServer01.Contoso.com" -UserRoleProfile "SelfServiceUser"

Este comando obtiene los roles de usuario del servidor denominado VMMServer01 que tienen un perfil de rol de usuario de SelfServiceUser. El comando muestra información sobre estos roles de usuario.

Ejemplo 4: Mostrar propiedades y otra información sobre objetos de rol de usuario

PS C:\> $UserRoles = Get-SCUserRole -VMMServer "VMMServer01.Contoso.com"
PS C:\> $UserRoles | Select-Object -Property Name, UserRoleProfile, ParentUserRole, Cloud
PS C:\> $UserRoles | Get-Member

El primer comando obtiene todos los objetos de rol de usuario en el servidor denominado VMMServer01 y, a continuación, almacena esos objetos en la variable $UserRoles.

El segundo comando pasa cada objeto de rol de usuario en $UserRoles al cmdlet Select-Object, que después muestra el nombre, el perfil de rol de usuario, el rol de usuario primario y la nube para cada rol de usuario.

El comando final pasa cada rol de usuario en $UserRoles al cmdlet Get-Member, que muestra el tipo de .NET para cada rol de usuario y los métodos y propiedades asociados a cada tipo de rol de usuario.

Parámetros

-ID

Especifica el identificador único del rol de usuario que obtiene este cmdlet.

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

-Name

Especifica el nombre del rol de usuario VMM que obtiene este cmdlet.

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

-OnBehalfOfUser

Especifica un nombre de usuario. Este cmdlet funciona en nombre del usuario que especifica este parámetro.

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

-OnBehalfOfUserRole

Especifica un rol de usuario. Para obtener un rol de usuario, use el cmdlet Get-SCUserRole. Este cmdlet funciona en nombre del rol de usuario que especifica este parámetro.

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

-UserRoleProfile

Especifica el tipo de perfil que es la base de los roles de usuario que obtiene este cmdlet. Los valores aceptables para este parámetro son:

  • DelegatedAdmin
  • ReadOnlyAdmin
  • SelfServiceUser
Tipo:Profile
Valores aceptados:Administrator, DelegatedAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VMMServer

Especifica el servidor VMM en el que este cmdlet obtiene roles de usuario.

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

Salidas

UserRole

Este cmdlet devuelve un objeto UserRole.