Condividi tramite

New-SCUserRole

Modulo:
VirtualMachineManager Module

Crea un ruolo utente per un gruppo di utenti VMM.

Sintassi

Default (impostazione predefinita). 

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 seguenti ruoli utente: Amministratore delegato, Amministratore Read-Only, Amministratore della macchina virtuale e Utente Self-Service. Esiste un solo ruolo di amministratore. Non è possibile creare un altro ruolo di amministratore o eliminare quello 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 sottoinsieme dell'ambito del ruolo utente padre.

Dopo aver creato un ruolo utente, è possibile utilizzare 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 i membri di un ruolo utente Self-Service possono eseguire sulle proprie macchine virtuali ed è possibile definire una quota che limiti il numero di macchine virtuali che gli utenti self-service possono creare. Sebbene non sia possibile creare o rimuovere il ruolo di amministratore o limitarne l'ambito, è possibile utilizzare 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: Creazione di 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 utilizza il parametro UserRoleProfile per designare il tipo di ruolo utente come Amministratore delegato.

Esempio 2: Creazione di un ruolo utente Self Service

PS C:\> $SelfServiceRole = New-SCUserRole -Name "ContosoSelfServiceUsers" -UserRoleProfile "SelfServiceUser"

Questo comando crea un nuovo ruolo utente denominato ContosoSelfServiceUsers, utilizza 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 di amministratore della 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 della macchina virtuale denominato VirtualMachineAdmin, fornisce la descrizione "Amministratore della macchina virtuale per contoso.com dominio" e utilizza il parametro UserRoleProfile per designare il tipo di ruolo utente come VMAdmin.

Parametri

-Description

Specifica una descrizione per il ruolo utente.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ID

Specifica l'ID univoco per il nuovo ruolo utente.

Proprietà dei parametri

Tipo:Guid
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-JobGroup

Specifica un identificatore per una serie di comandi che viene eseguito come set appena prima dell'esecuzione del comando finale che include lo stesso identificatore del gruppo di processi.

Proprietà dei parametri

Tipo:Guid
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-JobVariable

Specifica una variabile in cui viene rilevato e archiviato lo stato di avanzamento del processo.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Name

Specifica un nome per il nuovo ruolo utente.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:0
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-OnBehalfOfUser

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-OnBehalfOfUserRole

Specifica un ruolo utente. Per ottenere un ruolo utente, utilizzare il cmdlet Get-SCUserRole . Questo cmdlet funziona per conto del ruolo utente specificato da questo parametro.

Proprietà dei parametri

Tipo:UserRole
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ParentUserRole

Specifica un ruolo utente VMM esistente come padre del nuovo ruolo utente.

Proprietà dei parametri

Tipo:UserRole
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:Guid
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-RunAsynchronously

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-UserRoleProfile

Specifica il tipo di profilo che costituisce la base per il nuovo ruolo utente. I valori accettabili per questo parametro sono:

  • Amministratore delegato
  • ReadOnlyAdmin
  • Utente selfservice
  • TenantAdmin
  • VMAdmin

Proprietà dei parametri

Tipo:Profile
Valore predefinito:None
Valori accettati:Administrator, DelegatedAdmin, VMAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-VMMServer

Specifica il server VMM in cui il cmdlet crea un ruolo utente.

Proprietà dei parametri

Tipo:ServerConnection
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Output

UserRole

Questo cmdlet restituisce un oggetto UserRole .