Compartir a través de

Get-SCUserRole

  • Referencia
Módulo:
VirtualMachineManager

Obtiene un rol de usuario de VMM.

Syntax

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 permitidos de un rol de usuario pueden 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: Obtención de 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: Obtener 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 a continuación 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 para el rol de usuario que obtiene este cmdlet.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserRoleProfile

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

  • DelegatedAdmin
  • ReadOnlyAdmin
  • SelfServiceUser
Type:Profile
Accepted values:Administrator, DelegatedAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

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

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Salidas

UserRole

Este cmdlet devuelve un objeto UserRole .