Partilhar via

Grant-SCResource

  • Referência
Módulo:
VirtualMachineManager

Concede acesso a um recurso a um utilizador ou a um utilizador de autosserviço.

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

O cmdlet Grant-SCResource concede a um utilizador ou ao utilizador um papel de utilizador de autosserviço acesso a um recurso.

Os tipos de recursos que pode partilhar através do Grant-SCResource incluem os seguintes:

  • Modelos de serviço

  • Modelos de máquina virtual

  • Perfis do sistema operativo convidado

  • perfis de SQL Server

  • Perfis de hardware

  • Perfis de candidatura

  • Serviços

  • Máquinas virtuais

Exemplos

Exemplo 1: Partilhar um recurso com um utilizador específico

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

O primeiro comando obtém o objeto do modelo chamado Template01 e armazena o objeto na variável $Resource.

O segundo comando partilha o recurso armazenado em $Resource (Modelo01) com o utilizador chamado Katarina. Se o utilizador for membro de múltiplas funções de utilizador de autosserviço com permissão de receção, então deve ser especificada uma função de utilizador.

Exemplo 2: Partilhar um recurso com um utilizador que é membro de várias funções de utilizador

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

O primeiro comando obtém o objeto do modelo chamado Template01 e armazena o objeto na variável $Resource.

O segundo comando partilha o recurso armazenado em $Resource (Template01) com o utilizador chamado Katarina, mas apenas enquanto esse utilizador estiver a utilizar as funções de utilizador ContosoSelfServiceUsers ou SelfServiceUserRole02.

Exemplo 3: Partilhar um recurso com todos os membros de uma função de utilizador

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

O primeiro comando obtém o objeto do modelo chamado VMTemplate01 e armazena o objeto na variável $Resource.

O segundo comando partilha o recurso armazenado em $Resource (VMTemplate01) com os membros da função de utilizador chamada ContosoSelfServiceUsers.

Exemplo 4: Partilhar um recurso com todos os membros de uma função de utilizador utilizando o ID da função de utilizador

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

O primeiro comando obtém o objeto do modelo chamado VMTemplate01 e armazena o objeto na variável $Resource.

O segundo comando obtém o objeto da função do utilizador chamado ContosoSelfServiceUsers e armazena o objeto na variável $UserRole.

O último comando partilha o recurso armazenado em $Resource (VMTemplate01) com os membros da função de utilizador ContosoSelfServiceUsers.

Parâmetros

-JobGroup

Especifica um identificador para uma série de comandos que funcionarão como um conjunto pouco antes do comando final que inclui o mesmo identificador do grupo de trabalho.

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

-JobVariable

Especifica que o progresso do trabalho é rastreado e armazenado na variável nomeada por este parâmetro.

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

-OnBehalfOfUser

Especifica um nome de utilizador. Este cmdlet funciona em nome do utilizador que este parâmetro especifica.

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

-OnBehalfOfUserRole

Especifica uma função de utilizador. Para obter uma função de utilizador, utilize o cmdlet Get-SCUserRole . Este cmdlet funciona em nome da função de utilizador que este parâmetro especifica.

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

-PROTipID

Especifica o ID da ponta de otimização de desempenho e recursos (ponta PRO) que desencadeou esta ação. Este parâmetro permite-lhe auditar dicas PRO.

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

-Resource

Especifica um objeto de recurso.

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

-RunAsynchronously

Indica que o trabalho funciona assíncronamente para que o controlo volte imediatamente à concha de comando.

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

-UserName

Especifica um nome de um utilizador. Introduza um nome de utilizador com o formato Domínio\Utilizador.

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

-UserRoleID

Especifica a identificação de uma função de utilizador.

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

-UserRoleName

Especifica o nome de uma função de utilizador. Os tipos de funções de utilizador que são nomeados incluem Administrador Delegado, Administrador Read-Only e Self-Service Utilizador.

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

-VMMServer

Especifica um objeto de servidor VMM.

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

Saídas

Resource

Este cmdlet devolve um objeto de recurso .