Share via


Revoke-SCResource

Revoca l'accesso a una risorsa da un utente o da un ruolo utente.

Sintassi

Revoke-SCResource
      [-VMMServer <ServerConnection>]
      -Resource <ClientObject>
      [-UserRoleName <String[]>]
      [-UserRoleID <Guid[]>]
      [-UserName <String>]
      [-JobGroup <Guid>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

Descrizione

Il cmdlet Revoke-SCResource revoca l'accesso a una risorsa da un utente o da un ruolo utente.

Esempio

Esempio 1: Revocare l'accesso a una risorsa da un utente specifico

PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"} 
PS C:\> Revoke-SCResource -Resource $Resource -Username "Contoso\Katarina"

Il primo comando ottiene l'oggetto modello denominato Template01 e archivia l'oggetto nella variabile $Resource.

Il secondo comando revoca l'accesso alla risorsa archiviata in $Resource (Template01) dall'utente denominato Katarina. Se l'utente è membro di più ruoli utente, l'accesso verrà revocato dall'utente in tutti i ruoli utente.

Esempio 2: Revocare l'accesso a una risorsa da un utente membro di più ruoli utente

PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Revoke-SCResource -Resource $Resource -Username "Contoso\Katarina" -UserRoleName @("ContosoSelfServiceUsers", "SelfServiceUserRole02")

Il primo comando ottiene l'oggetto modello denominato Template01 e archivia l'oggetto nella variabile $Resource.

Il secondo comando revoca l'accesso alla risorsa archiviata in $Resource (Template01) dall'utente denominato Katarina, ma solo se l'utente usa i ruoli utente ContosoSelfServiceUsers o SelfServiceUserRole02. Se Katarina usa un ruolo utente diverso che ha accesso alla risorsa, sarà comunque in grado di accedere alla risorsa.

Esempio 3: Revocare l'accesso a una risorsa da tutti i membri di un ruolo utente

PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Revoke-SCResource -Resource $Resource -UserRoleName "ContosoSelfServiceUsers"

Il primo comando ottiene l'oggetto modello denominato Template01 e archivia l'oggetto nella variabile $Resource.

Il secondo comando revoca l'accesso alla risorsa archiviata in $Resource (Template01) da tutti i membri del ruolo utente ContosoSelfServiceUsers.

Parametri

-JobGroup

Specifica un identificatore per una serie di comandi che verranno eseguiti come un insieme prima dell'esecuzione dell'ultimo comando che include lo stesso identificatore di gruppo di processi.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

Specifica che lo stato del processo viene monitorato e archiviato nella variabile indicata in questo parametro.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

Specifica un nome utente. Questo cmdlet opera per conto dell'utente che specifica questo parametro.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

Specifica un ruolo utente. Per ottenere un ruolo utente, usare il cmdlet Get-SCUserRole . Questo cmdlet opera per conto del ruolo utente specificato da questo parametro.

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Specifica l'ID del suggerimento prestazioni e ottimizzazione risorse (suggerimento PRO) che ha attivato questa azione. Questo parametro consente di controllare i suggerimenti PRO.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Resource

Specifica un oggetto risorsa.

Type:ClientObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RunAsynchronously

Indica che il processo viene eseguito in modo asincrono in modo che il controllo restituisca immediatamente alla shell dei comandi.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserName

Specifica un nome di un utente. Immettere un nome utente con il formato Domain\User.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserRoleID

Specifica l'ID di un ruolo utente.

Type:Guid[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserRoleName

Specifica il nome di un ruolo utente. I tipi di ruoli utente denominati includono Amministratore delegato, amministratore Read-Only e Self-Service utente.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Specifica un oggetto server Virtual Machine Manager.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Output

Resource

Questo cmdlet restituisce un oggetto Resource .