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
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