Share via

Get-SCUserRole

  • Riferimento
Modulo:
VirtualMachineManager

Ottiene un ruolo utente VMM.

Sintassi

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 usa 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 membri operazioni consentiti di un ruolo utente può 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 ottiene tutti i ruoli utente VMM nel server denominato VMMServer01.Contoso.com. Il comando visualizza informazioni su ogni 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 informazioni sul ruolo utente.

Esempio 3: Ottenere un ruolo utente per profilo

PS C:\> Get-SCUserRole -VMMServer "VMMServer01.Contoso.com" -UserRoleProfile "SelfServiceUser"

Questo comando ottiene i ruoli utente del server denominato VMMServer01 con un profilo di ruolo utente SelfServiceUser. Il comando visualizza informazioni su questi ruoli utente.

Esempio 4: Visualizzare le proprietà e 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 visualizza quindi 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 che ottiene questo cmdlet.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifica il nome del ruolo utente VMM che ottiene questo cmdlet.

Type:String
Position:0
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 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

-UserRoleProfile

Specifica il tipo di profilo che costituisce la base per i ruoli utente che ottiene questo cmdlet. I valori validi per questo parametro sono:

  • DelegatedAdmin
  • ReadOnlyAdmin
  • SelfServiceUser
Type:Profile
Accepted values:Administrator, DelegatedAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Specifica il server VMM in cui questo cmdlet ottiene i ruoli 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 .