Revoke-SCResource
Revoca el acceso a un recurso de un usuario o rol de usuario.
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
El cmdlet Revoke-SCResource revoca el acceso a un recurso de un usuario o rol de usuario.
Ejemplos
Ejemplo 1: Revocar el acceso a un recurso de un usuario específico
PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Revoke-SCResource -Resource $Resource -Username "Contoso\Katarina"
El primer comando obtiene el objeto de plantilla denominado Template01 y almacena el objeto en la variable $Resource.
El segundo comando revoca el acceso al recurso almacenado en $Resource (Template01) del usuario denominado Katarina. Si el usuario es miembro de varios roles de usuario, se revocará el acceso del usuario en todos sus roles de usuario.
Ejemplo 2: Revocar el acceso a un recurso de un usuario que sea miembro de varios roles de usuario
PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Revoke-SCResource -Resource $Resource -Username "Contoso\Katarina" -UserRoleName @("ContosoSelfServiceUsers", "SelfServiceUserRole02")
El primer comando obtiene el objeto de plantilla denominado Template01 y almacena el objeto en la variable $Resource.
El segundo comando revoca el acceso al recurso almacenado en $Resource (Template01) del usuario denominado Katarina, pero solo si el usuario usa los roles de usuario ContosoSelfServiceUsers o SelfServiceUserRole02. Si Katarina usa un rol de usuario diferente que tiene acceso al recurso, seguirá siendo capaz de acceder al recurso.
Ejemplo 3: Revocar el acceso a un recurso de todos los miembros de un rol de usuario
PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Revoke-SCResource -Resource $Resource -UserRoleName "ContosoSelfServiceUsers"
El primer comando obtiene el objeto de plantilla denominado Template01 y almacena el objeto en la variable $Resource.
El segundo comando revoca el acceso al recurso almacenado en $Resource (Template01) de todos los miembros del rol de usuario ContosoSelfServiceUsers.
Parámetros
-JobGroup
Especifica un identificador para una serie de comandos que se ejecutarán como un conjunto antes del comando final que incluye las mismas ejecuciones de identificador de grupo de trabajos.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobVariable
Especifica que se realiza un seguimiento del progreso del trabajo y que se almacena en la variable cuyo nombre indica este parámetro.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OnBehalfOfUser
Especifica un nombre de usuario. Este cmdlet funciona en nombre del usuario que especifica este parámetro.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OnBehalfOfUserRole
Especifica un rol de usuario. Para obtener un rol de usuario, use el cmdlet Get-SCUserRole . Este cmdlet funciona en nombre del rol de usuario que especifica este parámetro.
Type: | UserRole |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
Especifica el identificador de la sugerencia rendimiento y optimización de recursos (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias PRO.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Resource
Especifica un objeto de recurso.
Type: | ClientObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RunAsynchronously
Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva al shell de comandos inmediatamente.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserName
Especifica el nombre de un usuario. Escriba un nombre de usuario con el formato Dominio\Usuario.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserRoleID
Especifica el identificador de un rol de usuario.
Type: | Guid[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserRoleName
Especifica el nombre de un rol de usuario. Los tipos de roles de usuario que se denominan incluyen Administrador delegado, administrador Read-Only y usuario de Self-Service.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMMServer
Especifica un objeto de servidor VMM.
Type: | ServerConnection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Salidas
Resource
Este cmdlet devuelve un objeto Resource .