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 .