Delen via

Get-SCUserRole

  • Referentie
Module:
VirtualMachineManager

Hiermee haalt u een VMM-gebruikersrol op.

Syntax

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 waarin leden van een bepaalde gebruikersrol kunnen werken en de set toegestane bewerkingen die leden van een gebruikersrol kunnen uitvoeren.

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

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 Get-Help Set-SCUserRoleu.

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 op naam ophalen

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

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

Voorbeeld 3: Een gebruikersrol op profiel ophalen

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. De opdracht geeft informatie weer over deze gebruikersrollen.

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 cmdlet Select-Object, waarmee vervolgens 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, waarmee het . NET-type wordt weergegeven voor elke gebruikersrol en de methoden en eigenschappen die zijn gekoppeld aan elk type gebruikersrol.

Parameters

-ID

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

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

-Name

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

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

Hiermee geeft u een gebruikersnaam op. Deze cmdlet werkt namens de gebruiker die met deze parameter wordt opgegeven.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 door deze parameter wordt opgegeven.

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

-UserRoleProfile

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

  • 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

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

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

Uitvoerwaarden

UserRole

Met deze cmdlet wordt een UserRole-object geretourneerd.