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 .