Revoke-SCResource
Revoga o acesso a um recurso de uma função de usuário ou usuário.
Syntax
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.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobVariable
Especifica que o andamento do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OnBehalfOfUser
Especifica um nome de usuário. Esse cmdlet opera em nome do usuário especificado por esse parâmetro.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | UserRole |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
Especifica a ID da dica de Desempenho e Otimização de Recursos (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite 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 é executado de forma assíncrona para que o controle retorne imediatamente ao shell de comando.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserName
Especifica o nome de um usuário. Insira um nome de usuário com o formato Domínio\Usuário.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserRoleID
Especifica a ID de uma função de usuário.
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 usuário. Os tipos de funções de usuário nomeadas incluem Administrador Delegado, Administrador Read-Only e Usuário Self-Service.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMMServer
Especifica um objeto de servidor do VMM.
Type: | ServerConnection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Saídas
Resource
Esse cmdlet retorna um objeto Resource .