Get-SCUserRole
Ottiene un ruolo utente VMM.
Sintassi
Default (impostazione predefinita).
Get-SCUserRole
[-VMMServer <ServerConnection>]
[[-Name] <String>]
[-UserRoleProfile <Profile>]
[-ID <Guid>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Descrizione
Il cmdlet Get-SCUserRole ottiene uno o più ruoli utente di Virtual Machine Manager (VMM). VMM utilizza la sicurezza basata sui ruoli per definire i limiti entro i quali i membri di un determinato ruolo utente possono operare e il set di operazioni consentite che i membri di un ruolo utente possono eseguire.
Per informazioni sulla creazione di ruoli utente, digitare Get-Help New-SCUserRole.
Per informazioni sull'impostazione delle proprietà di un ruolo utente, incluso l'ambito per gli amministratori delegati e di sola lettura e l'ambito e le azioni per gli utenti self-service, digitare Get-Help Set-SCUserRole.
Esempio
Esempio 1: Ottenere tutti i ruoli utente
PS C:\> Get-SCUserRole -VMMServer "VMMServer01.Contoso.com"
Questo comando consente di ottenere tutti i ruoli utente VMM nel server denominato VMMServer01.Contoso.com. Il comando visualizza informazioni su ciascun ruolo utente.
Esempio 2: Ottenere un ruolo utente in base al nome
PS C:\> Get-SCUserRole -Name "Administrator"
Questo comando ottiene l'oggetto ruolo utente denominato Administrator. Il comando visualizza le informazioni relative al ruolo utente.
Esempio 3: Ottenere un ruolo utente in base al profilo
PS C:\> Get-SCUserRole -VMMServer "VMMServer01.Contoso.com" -UserRoleProfile "SelfServiceUser"
Questo comando consente di ottenere i ruoli utente del server denominato VMMServer01 con un profilo del ruolo utente SelfServiceUser. Il comando visualizza informazioni su questi ruoli utente.
Esempio 4: Visualizzazione delle proprietà e di altre informazioni sugli oggetti ruolo utente
PS C:\> $UserRoles = Get-SCUserRole -VMMServer "VMMServer01.Contoso.com"
PS C:\> $UserRoles | Select-Object -Property Name, UserRoleProfile, ParentUserRole, Cloud
PS C:\> $UserRoles | Get-Member
Il primo comando ottiene tutti gli oggetti ruolo utente nel server denominato VMMServer01 e quindi archivia tali oggetti nella variabile $UserRoles.
Il secondo comando passa ogni oggetto ruolo utente in $UserRoles al cmdlet Select-Object, che quindi visualizza il nome, il profilo del ruolo utente, il ruolo utente padre e il cloud per ogni ruolo utente
Il comando finale passa ogni ruolo utente in $UserRoles al cmdlet Get-Member , che visualizza il tipo .NET per ogni ruolo utente e i metodi e le proprietà associati a ogni tipo di ruolo utente.
Parametri
-ID
Specifica l'ID univoco per il ruolo utente ottenuto da questo cmdlet.
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 |
-Name
Specifica il nome del ruolo utente VMM ottenuto da questo cmdlet.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 0 |
| Obbligatorio: | False |
| 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 |
-UserRoleProfile
Specifica il tipo di profilo che costituisce la base per i ruoli utente ottenuti da questo cmdlet. I valori accettabili per questo parametro sono:
- Amministratore delegato
- ReadOnlyAdmin
- Utente selfservice
Proprietà dei parametri
| Tipo: | Profile |
| Valore predefinito: | None |
| Valori accettati: | Administrator, DelegatedAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin |
| 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 |
-VMMServer
Specifica il server VMM in cui il cmdlet ottiene i ruoli 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 .