Condividi tramite


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 all'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 set subito prima dell'esecuzione del comando finale che include lo stesso identificatore del gruppo di processi.

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-JobVariable

Specifica che lo stato del processo viene rilevato e archiviato nella variabile denominata da questo parametro.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-OnBehalfOfUser

Specifica un nome utente. Questo cmdlet opera per conto dell'utente specificato da questo parametro.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:UserRole
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PROTipID

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

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Resource

Specifica un oggetto risorsa.

Tipo:ClientObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-RunAsynchronously

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UserName

Specifica un nome di un utente. Immettere un nome utente con il formato Dominio\Utente.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UserRoleID

Specifica l'ID di un ruolo utente.

Tipo:Guid[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VMMServer

Specifica un oggetto server VMM.

Tipo:ServerConnection
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Output

Resource

Questo cmdlet restituisce un oggetto resource .