Dela via

Get-SCUserRole

  • Referens
Modul:
VirtualMachineManager

Hämtar en VMM-användarroll.

Syntax

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

Description

Cmdleten Get-SCUserRole hämtar en eller flera VMM-användarroller (Virtual Machine Manager). VMM använder rollbaserad säkerhet för att definiera de gränser inom vilka medlemmar av en viss användarroll kan arbeta och uppsättningen tillåtna åtgärder som medlemmar i en användarroll kan utföra.

Om du vill ha information om hur du skapar användarroller skriver du Get-Help New-SCUserRole.

Om du vill ha information om hur du ställer in egenskaperna för en användarroll, inklusive omfånget för delegerade och skrivskyddade administratörer och omfång och åtgärder för självbetjäningsanvändare, skriver du Get-Help Set-SCUserRole.

Exempel

Exempel 1: Hämta alla användarroller

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

Det här kommandot hämtar alla VMM-användarroller på servern med namnet VMMServer01.Contoso.com. Kommandot visar information om varje användarroll.

Exempel 2: Hämta en användarroll efter namn

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

Det här kommandot hämtar användarrollobjektet med namnet Administratör. Kommandot visar information om användarrollen.

Exempel 3: Hämta en användarroll efter profil

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

Det här kommandot hämtar användarrollerna som servern med namnet VMMServer01 som har en användarrollprofil för SelfServiceUser. Kommandot visar information om dessa användarroller.

Exempel 4: Visa egenskaper och annan information om användarrollobjekt

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

Det första kommandot hämtar alla användarrollobjekt på servern med namnet VMMServer01 och lagrar sedan objekten i variabeln $UserRoles.

Det andra kommandot skickar varje användarrollobjekt i $UserRoles till cmdleten Select-Object, som sedan visar namn, användarrollprofil, överordnad användarroll och moln för varje användarroll

Det sista kommandot skickar varje användarroll i $UserRoles till cmdleten Get-Member, som visar . NET-typen för varje användarroll och de metoder och egenskaper som är associerade med varje användarrolltyp.

Parametrar

-ID

Anger det unika ID för användarrollen som den här cmdleten hämtar.

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

-Name

Anger namnet på den VMM-användarroll som den här cmdleten hämtar.

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

-OnBehalfOfUser

Anger ett användarnamn. Den här cmdleten fungerar för användarens räkning som den här parametern anger.

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

-OnBehalfOfUserRole

Anger en användarroll. Om du vill hämta en användarroll använder du cmdleten Get-SCUserRole . Den här cmdleten fungerar för den användarroll som den här parametern anger.

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

-UserRoleProfile

Anger vilken typ av profil som utgör grunden för de användarroller som den här cmdleten får. De acceptabla värdena för den här parametern är:

  • 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

Anger den VMM-server där den här cmdleten hämtar användarroller.

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

Utdata

UserRole

Den här cmdleten returnerar ett UserRole-objekt .