Revoke-SCResource
Revoga o acesso a um recurso de uma função de usuário ou usuário.
Sintaxe
Revoke-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 Revoke-SCResource revoga o acesso a um recurso de uma função de usuário ou usuário.
Exemplos
Exemplo 1: revogar o acesso a um recurso de um usuário específico
PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Revoke-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 revoga o acesso ao recurso armazenado em $Resource (Template01) do usuário chamado Katarina. Se o usuário for membro de várias funções de usuário, o acesso será revogado do usuário em todas as suas funções de usuário.
Exemplo 2: revogar o acesso a um recurso de um usuário que é membro de várias funções de usuário
PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Revoke-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 revoga o acesso ao recurso armazenado em $Resource (Template01) do usuário chamado Katarina, mas somente se o usuário estiver usando as funções de usuário ContosoSelfServiceUsers ou SelfServiceUserRole02. Se Katarina usar uma função de usuário diferente que tenha acesso ao recurso, ela ainda poderá acessar o recurso.
Exemplo 3: revogar o acesso a um recurso de todos os membros de uma função de usuário
PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Revoke-SCResource -Resource $Resource -UserRoleName "ContosoSelfServiceUsers"O primeiro comando obtém o objeto de modelo chamado Template01 e armazena o objeto na variável $Resource.
O segundo comando revoga o acesso ao recurso armazenado em $Resource (Template01) de todos 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.
| Tipo: | Guid |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-JobVariable
Especifica que o progresso do trabalho é acompanhado e armazenado na variável nomeada por esse parâmetro.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-OnBehalfOfUser
Especifica um nome de usuário. Esse cmdlet opera em nome do usuário especificado por esse parâmetro.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | 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.
| Tipo: | UserRole |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | 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.
| Tipo: | Guid |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Resource
Especifica um objeto de recurso.
| Tipo: | ClientObject |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-UserName
Especifica o nome de um usuário. Insira um nome de usuário com o formato Domínio\Usuário.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-UserRoleID
Especifica a ID de uma função de usuário.
| Tipo: | Guid[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | 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.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-VMMServer
Especifica um objeto de servidor do VMM.
| Tipo: | ServerConnection |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
Saídas
Resource
Esse cmdlet retorna um objeto Resource.