New-SCUserRole
Crea un ruolo utente per un gruppo di utenti VMM.
Sintassi
New-SCUserRole
[-VMMServer <ServerConnection>]
[-Name] <String>
-UserRoleProfile <Profile>
[-ID <Guid>]
[-JobGroup <Guid>]
[-Description <String>]
[-ParentUserRole <UserRole>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Descrizione
Il cmdlet New-SCUserRole crea un ruolo utente per un gruppo di utenti di Virtual Machine Manager (VMM). È possibile creare i ruoli utente seguenti: Amministratore delegato, amministratore Read-Only, amministratore macchina virtuale e Self-Service utente. Esiste un solo ruolo di amministratore. Non è possibile creare un altro ruolo di amministratore o eliminarlo esistente.
Se si è membri di un ruolo utente Amministratore delegato, è possibile creare un ruolo utente. Tuttavia, l'ambito del nuovo ruolo utente deve essere un subset dell'ambito del ruolo utente padre.
Dopo aver creato un ruolo utente, è possibile usare il cmdlet Set-SCUserRole per rinominare il ruolo utente, aggiungere o rimuovere membri e aggiungere o modificare l'ambito degli oggetti che i membri del ruolo possono gestire. Per un ruolo utente Self-Service, è possibile specificare quali azioni membri di un ruolo utente Self-Service possono assumere nelle macchine virtuali ed è possibile definire una quota che limita il numero di macchine virtuali che gli utenti self-service possono creare. Anche se non è possibile creare o rimuovere il ruolo Amministratore o limitarne l'ambito, è possibile usare Set-SCUserRole per aggiungere o rimuovere membri a tale ruolo.
Per informazioni su come modificare le proprietà di un ruolo utente, digitare Get-Help Set-SCUserRole.
Esempio
Esempio 1: Creare un ruolo utente amministratore delegato
PS C:\> New-SCUserRole -Name "ContosoDelegatedAdmin" -Description "Delegated Administrators for the Contoso.com domain" -UserRoleProfile "DelegatedAdmin"Questo comando crea un ruolo utente amministratore delegato denominato ContosoDelegatedAdmin, fornisce la descrizione Amministratori delegati per il dominio Contoso.com e usa il parametro UserRoleProfile per designare il tipo di ruolo utente come amministratore delegato.
Esempio 2: Creare un ruolo utente self-service
PS C:\> $SelfServiceRole = New-SCUserRole -Name "ContosoSelfServiceUsers" -UserRoleProfile "SelfServiceUser"Questo comando crea un nuovo ruolo utente denominato ContosoSelfServiceUsers, usa il parametro UserRoleProfile per designare il nuovo tipo di ruolo utente come utente Self-Service e archivia il nuovo oggetto ruolo utente nella variabile $SelfServiceRole.
Esempio 3: Creare un ruolo amministratore macchina virtuale
PS C:\> New-SCUserRole -Name "VirtualMachineAdmin" -UserRoleProfile "VMAdmin" -Description "Virtual Machine administrator for contoso.com domain"Questo comando crea un ruolo utente amministratore macchina virtuale denominato VirtualMachineAdmin, fornisce la descrizione "Amministratore macchina virtuale per contoso.com dominio" e usa il parametro UserRoleProfile per designare il tipo di ruolo utente come VMAdmin.
Parametri
-Description
Specifica una descrizione per il ruolo utente.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ID
Specifica l'ID univoco per il nuovo ruolo utente.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobGroup
Specifica un identificatore per una serie di comandi eseguiti come set subito prima dell'esecuzione del comando finale che include lo stesso identificatore del gruppo di processi.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Specifica una variabile in cui viene monitorato e archiviato lo stato del processo.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Specifica un nome per il nuovo ruolo utente.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
Specifica un nome utente. Questo cmdlet opera per conto dell'utente specificato da 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 |
-ParentUserRole
Specifica un ruolo utente VMM esistente come elemento padre del nuovo ruolo utente.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Specifica l'ID della descrizione per le prestazioni e l'ottimizzazione delle 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 |
-RunAsynchronously
Indica che il processo viene eseguito in modo asincrono in modo che il controllo torni immediatamente alla shell dei comandi.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserRoleProfile
Specifica il tipo di profilo che costituisce la base per il nuovo ruolo utente. I valori validi per questo parametro sono:
- DelegatedAdmin
- ReadOnlyAdmin
- SelfServiceUser
- TenantAdmin
- VMAdmin
| Type: | Profile |
| Accepted values: | Administrator, DelegatedAdmin, VMAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
Specifica il server VMM in cui questo cmdlet crea un ruolo utente.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Output
UserRole
Questo cmdlet restituisce un oggetto UserRole .