Revoke-SCResource
Revoga o acesso a um recurso de um usuário ou função de 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 um usuário ou função de 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 no $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 no $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 no $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 imediatamente antes da execução do comando final que inclui o mesmo identificador de grupo de trabalhos.
| Tipo: | Guid |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-JobVariable
Especifica que o progresso do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-OnBehalfOfUser
Especifica um nome de usuário. Este cmdlet opera em nome do usuário especificado por esse parâmetro.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-OnBehalfOfUserRole
Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole. Este cmdlet opera em nome da função de usuário especificada por esse parâmetro.
| Tipo: | UserRole |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-PROTipID
Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.
| Tipo: | Guid |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Resource
Especifica um objeto de recurso.
| Tipo: | ClientObject |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-UserName
Especifica o nome de um usuário. Insira um nome de usuário com o formato Domínio\Usuário.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-UserRoleID
Especifica a ID de uma função de usuário.
| Tipo: | Guid[] |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-UserRoleName
Especifica o nome de uma função de usuário. Os tipos de funções de usuário nomeados incluem Administrador Delegado, Administrador Read-Only e Usuário Self-Service.
| Tipo: | String[] |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-VMMServer
Especifica um objeto de servidor VMM.
| Tipo: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
Saídas
Resource
Este cmdlet retorna um objeto Resource.