Grant-SCResource
Concede a un utente o a un ruolo utente self-service l'accesso a una risorsa.
Sintassi
Grant-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 Grant-SCResource concede a un utente o a un ruolo utente self-service l'accesso a una risorsa.
I tipi di risorse che è possibile condividere con Grant-SCResource includono quanto segue:
Modelli di servizio
Modelli di macchina virtuale
Profili del sistema operativo guest
profili SQL Server
Profili hardware
Profili applicazione
Servizi
Macchine virtuali
Esempio
Esempio 1: Condividere una risorsa con un utente specifico
PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Grant-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 condivide la risorsa archiviata in $Resource (Template01) con l'utente denominato Katarina. Se l'utente è membro di più ruoli utente self-service con autorizzazione di ricezione, è necessario specificare un ruolo utente.
Esempio 2: Condividere una risorsa con un utente membro di più ruoli utente
PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Grant-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 condivide la risorsa archiviata in $Resource (Template01) con l'utente denominato Katarina ma solo mentre l'utente usa i ruoli utente ContosoSelfServiceUsers o SelfServiceUserRole02.
Esempio 3: Condividere una risorsa con tutti i membri di un ruolo utente
PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> Grant-SCResource -Resource $Resource -UserRoleName "ContosoSelfServiceUsers"
Il primo comando ottiene l'oggetto modello denominato VMTemplate01 e archivia l'oggetto nella variabile $Resource.
Il secondo comando condivide la risorsa archiviata in $Resource (VMTemplate01) con i membri del ruolo utente denominato ContosoSelfServiceUsers.
Esempio 4: Condividere una risorsa con tutti i membri di un ruolo utente usando l'ID ruolo utente
PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> $UserRole = Get-SCUserRole -Name "ContosoSelfServiceUsers"
PS C:\> Grant-SCResource -Resource $Resource -UserRoleId $UserRole.Id
Il primo comando ottiene l'oggetto modello denominato VMTemplate01 e archivia l'oggetto nella variabile $Resource.
Il secondo comando ottiene l'oggetto ruolo utente denominato ContosoSelfServiceUsers e archivia l'oggetto nella variabile $UserRole.
L'ultimo comando condivide la risorsa archiviata in $Resource (VMTemplate01) con 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 .