Compartilhar via


Grant-SCResource

Concede a um usuário ou função de usuário de autoatendimento acesso a um recurso.

Sintaxe

Default (Padrão)

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 usuário ou função de usuário de autoatendimento acesso a um recurso.

Os tipos de recursos que você pode compartilhar usando Grant-SCResource incluem o seguinte:

  • Modelos de serviço

  • Modelos de máquina virtual

  • Perfis do sistema operacional convidado

  • Perfis do SQL Server

  • Perfis de hardware

  • Perfis de aplicativo

  • Serviços

  • Máquinas virtuais

Exemplos

Exemplo 1: Compartilhar um recurso com um usuário 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 de modelo chamado Template01 e armazena o objeto na variável $Resource.

O segundo comando compartilha o recurso armazenado no $Resource (Template01) com a usuária chamada Katarina. Se o usuário for membro de várias funções de usuário de autoatendimento com permissão de recebimento, uma função de usuário deverá ser especificada.

Exemplo 2: Compartilhar um recurso com um usuário que é membro de várias funções de usuário

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 de modelo chamado Template01 e armazena o objeto na variável $Resource.

O segundo comando compartilha o recurso armazenado no $Resource (Template01) com o usuário chamado Katarina, mas somente enquanto esse usuário estiver usando as funções de usuário ContosoSelfServiceUsers ou SelfServiceUserRole02.

Exemplo 3: Compartilhar um recurso com todos os membros de uma função de usuário

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

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

O segundo comando compartilha o recurso armazenado no $Resource (VMTemplate01) com os membros da função de usuário chamada ContosoSelfServiceUsers.

Exemplo 4: Compartilhar um recurso com todos os membros de uma função de usuário usando a ID da função de usuário

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 de modelo chamado VMTemplate01 e armazena o objeto na variável $Resource.

O segundo comando obtém o objeto de função de usuário chamado ContosoSelfServiceUsers e armazena o objeto na variável $UserRole.

O último comando compartilha o recurso armazenado no $Resource (VMTemplate01) com os membros da função de usuário ContosoSelfServiceUsers.

Parâmetros

-JobGroup

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

Propriedades do parâmetro

Tipo:Guid
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-JobVariable

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-OnBehalfOfUser

Especifica um nome de usuário. Esse cmdlet opera em nome do usuário especificado por esse parâmetro.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-OnBehalfOfUserRole

Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole . Esse cmdlet opera em nome da função de usuário especificada por esse parâmetro.

Propriedades do parâmetro

Tipo:UserRole
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PROTipID

Especifica a ID da dica de Otimização de Recursos e Desempenho (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

Propriedades do parâmetro

Tipo:Guid
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Resource

Especifica um objeto de recurso.

Propriedades do parâmetro

Tipo:ClientObject
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-UserName

Especifica o nome de um usuário. Insira um nome de usuário com o formato Domínio\Usuário.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-UserRoleID

Especifica a ID de uma função de usuário.

Propriedades do parâmetro

Tipo:

Guid[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-UserRoleName

Especifica o nome de uma função de usuário. Os tipos de funções de usuário nomeadas incluem Administrador Delegado, Administrador Read-Only e Usuário Self-Service.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-VMMServer

Especifica um objeto de servidor do VMM.

Propriedades do parâmetro

Tipo:ServerConnection
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Saídas

Resource

Esse cmdlet retorna um objeto Resource .