Grant-SCResource

Concede a un usuario o rol de usuario de autoservicio acceso a un recurso.

Syntax

Grant-SCResource
     [-VMMServer <ServerConnection>]
     -Resource <ClientObject>
     [-UserRoleName <String[]>]
     [-UserRoleID <Guid[]>]
     [-UserName <String>]
     [-JobGroup <Guid>]
     [-RunAsynchronously]
     [-PROTipID <Guid>]
     [-JobVariable <String>]
     [-OnBehalfOfUser <String>]
     [-OnBehalfOfUserRole <UserRole>]
     [<CommonParameters>]

Description

El cmdlet Grant-SCResource concede a un usuario o rol de usuario de autoservicio acceso a un recurso.

Los tipos de recursos que puede compartir mediante Grant-SCResource incluyen los siguientes:

  • Plantillas de servicio

  • Plantillas de máquina virtual

  • Perfiles del sistema operativo invitado

  • perfiles de SQL Server

  • Perfiles de hardware

  • Perfiles de aplicación

  • Servicios

  • Máquinas virtuales

Ejemplos

Ejemplo 1: Compartir un recurso con un usuario específico

PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Grant-SCResource -Resource $Resource -Username "Contoso\Katarina"

El primer comando obtiene el objeto de plantilla denominado Template01 y almacena el objeto en la variable $Resource.

El segundo comando comparte el recurso almacenado en $Resource (Template01) con el usuario llamado Katarina. Si el usuario es miembro de varios roles de usuario de autoservicio con permiso de recepción, se debe especificar un rol de usuario.

Ejemplo 2: Compartir un recurso con un usuario que sea miembro de varios roles de usuario

PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Grant-SCResource -Resource $Resource -Username "Contoso\Katarina" -UserRoleName @("ContosoSelfServiceUsers", "SelfServiceUserRole02")

El primer comando obtiene el objeto de plantilla denominado Template01 y almacena el objeto en la variable $Resource.

El segundo comando comparte el recurso almacenado en $Resource (Template01) con el usuario denominado Katarina, pero solo mientras ese usuario usa los roles de usuario ContosoSelfServiceUsers o SelfServiceUserRole02.

Ejemplo 3: Compartir un recurso con todos los miembros de un rol de usuario

PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> Grant-SCResource -Resource $Resource -UserRoleName "ContosoSelfServiceUsers"

El primer comando obtiene el objeto de plantilla denominado VMTemplate01 y almacena el objeto en la variable $Resource.

El segundo comando comparte el recurso almacenado en $Resource (VMTemplate01) con los miembros del rol de usuario denominado ContosoSelfServiceUsers.

Ejemplo 4: Compartir un recurso con todos los miembros de un rol de usuario mediante el identificador de rol de usuario

PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> $UserRole = Get-SCUserRole -Name "ContosoSelfServiceUsers"
PS C:\> Grant-SCResource -Resource $Resource -UserRoleId $UserRole.Id

El primer comando obtiene el objeto de plantilla denominado VMTemplate01 y almacena el objeto en la variable $Resource.

El segundo comando obtiene el objeto de rol de usuario denominado ContosoSelfServiceUsers y almacena el objeto en la variable $UserRole.

El último comando comparte el recurso almacenado en $Resource (VMTemplate01) con los miembros del rol de usuario ContosoSelfServiceUsers.

Parámetros

-JobGroup

Especifica un identificador para una serie de comandos que se ejecutarán como un conjunto antes del comando final que incluye las mismas ejecuciones de identificador de grupo de trabajos.

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

-JobVariable

Especifica que se realiza un seguimiento del progreso del trabajo y que se almacena en la variable cuyo nombre indica este parámetro.

Type:String
Position:Named
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

-PROTipID

Especifica el identificador de la sugerencia de optimización de recursos y rendimiento (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias pro.

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

-Resource

Especifica un objeto de recurso.

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

-RunAsynchronously

Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva inmediatamente al shell de comandos.

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

-UserName

Especifica el nombre de un usuario. Escriba un nombre de usuario con el formato Dominio\Usuario.

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

-UserRoleID

Especifica el identificador de un rol de usuario.

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

-UserRoleName

Especifica el nombre de un rol de usuario. Los tipos de roles de usuario que se denominan incluyen Administrador delegado, administrador Read-Only y usuario de Self-Service.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Especifica un objeto de servidor VMM.

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

Salidas

Resource

Este cmdlet devuelve un objeto Resource .