Delen via

Get-SCUserRole

  • Referentie
Module:
VirtualMachineManager

Hiermee haalt u een VMM-gebruikersrol op.

Syntaxis

Get-SCUserRole
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-UserRoleProfile <Profile>]
   [-ID <Guid>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

De cmdlet Get-SCUserRole haalt een of meer VMM-gebruikersrollen (Virtual Machine Manager) op. VMM maakt gebruik van beveiliging op basis van rollen om de grenzen te definiëren waarbinnen leden van een bepaalde gebruikersrol kunnen werken en de set toegestane bewerkingen die leden van een gebruikersrol kunnen uitvoeren.

Typ Get-Help New-SCUserRolevoor informatie over het maken van gebruikersrollen.

Voor informatie over het instellen van de eigenschappen van een gebruikersrol, inclusief het bereik voor gedelegeerde en alleen-lezen beheerders en het bereik en de acties voor selfservicegebruikers, typt u Get-Help Set-SCUserRole.

Voorbeelden

Voorbeeld 1: Alle gebruikersrollen ophalen

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

Met deze opdracht worden alle VMM-gebruikersrollen op de server met de naam VMMServer01.Contoso.com. De opdracht geeft informatie weer over elke gebruikersrol.

Voorbeeld 2: Een gebruikersrol ophalen op naam

PS C:\> Get-SCUserRole -Name "Administrator"

Met deze opdracht wordt het gebruikersrolobject met de naam Administrator opgehaald. Met de opdracht wordt informatie over die gebruikersrol weergegeven.

Voorbeeld 3: Een gebruikersrol ophalen op profiel

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

Met deze opdracht worden de gebruikersrollen op de server met de naam VMMServer01 met een gebruikersrolprofiel van SelfServiceUser. Met de opdracht wordt informatie over deze gebruikersrollen weergegeven.

Voorbeeld 4: Eigenschappen en andere informatie over gebruikersrolobjecten weergeven

PS C:\> $UserRoles = Get-SCUserRole -VMMServer "VMMServer01.Contoso.com"
PS C:\> $UserRoles | Select-Object -Property Name, UserRoleProfile, ParentUserRole, Cloud
PS C:\> $UserRoles | Get-Member

Met de eerste opdracht worden alle gebruikersrolobjecten op de server met de naam VMMServer01 opgehaald en worden deze objecten vervolgens opgeslagen in de $UserRoles variabele.

Met de tweede opdracht wordt elk gebruikersrolobject in $UserRoles doorgegeven aan de Select-Object-cmdlet, waarna de naam, het gebruikersrolprofiel, de bovenliggende gebruikersrol en de cloud voor elke gebruikersrol worden weergegeven

Met de laatste opdracht wordt elke gebruikersrol in $UserRoles doorgegeven aan de cmdlet Get-Member, waarin het .NET-type wordt weergegeven voor elke gebruikersrol en de methoden en eigenschappen die aan elk gebruikersroltype zijn gekoppeld.

Parameters

-ID

Hiermee geeft u de unieke id op voor de gebruikersrol die deze cmdlet ophaalt.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam op van de VMM-gebruikersrol die door deze cmdlet wordt ophaalt.

Type:String
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OnBehalfOfUser

Hiermee geeft u een gebruikersnaam. Deze cmdlet werkt namens de gebruiker die deze parameter opgeeft.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OnBehalfOfUserRole

Hiermee geeft u een gebruikersrol op. Gebruik de cmdlet Get-SCUserRole om een gebruikersrol te verkrijgen. Deze cmdlet werkt namens de gebruikersrol die met deze parameter wordt opgegeven.

Type:UserRole
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-UserRoleProfile

Hiermee geeft u het type profiel op dat de basis is voor de gebruikersrollen die deze cmdlet ophaalt. De acceptabele waarden voor deze parameter zijn:

  • DelegatedAdmin
  • ReadOnlyAdmin
  • SelfServiceUser
Type:Profile
Geaccepteerde waarden:Administrator, DelegatedAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VMMServer

Hiermee geeft u de VMM-server waarop deze cmdlet gebruikersrollen ophaalt.

Type:ServerConnection
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Uitvoerwaarden

UserRole

Met deze cmdlet wordt een UserRole--object geretourneerd.