Sdílet prostřednictvím

Get-SCUserRole

  • Reference
Modul:
VirtualMachineManager

Získá roli uživatele VMM.

Syntax

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

Description

Rutina Get-SCUserRole získá jednu nebo více uživatelských rolí nástroje Virtual Machine Manager (VMM). Nástroj VMM používá zabezpečení založené na rolích k definování hranic, ve kterých mohou členové dané role uživatele fungovat, a sadu povolených operací role uživatele může provádět.

Informace o vytváření rolí uživatele zadejte Get-Help New-SCUserRole.

Informace o nastavení vlastností role uživatele, včetně oboru pro delegované a jen pro správce jen pro čtení a rozsah a akce pro uživatele samoobslužné služby, zadejte Get-Help Set-SCUserRole.

Příklady

Příklad 1: Získání všech rolí uživatelů

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

Tento příkaz získá všechny role uživatelů VMM na serveru s názvem VMMServer01.Contoso.com. Příkaz zobrazí informace o jednotlivých rolích uživatele.

Příklad 2: Získání role uživatele podle jména

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

Tento příkaz získá objekt role uživatele s názvem Administrator. Příkaz zobrazí informace o této roli uživatele.

Příklad 3: Získání role uživatele podle profilu

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

Tento příkaz získá role uživatele server s názvem VMMServer01, které mají profil role uživatele SelfServiceUser. Příkaz zobrazí informace o těchto rolích uživatelů.

Příklad 4: Zobrazení vlastností a dalších informací o objektech role uživatele

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

První příkaz získá všechny objekty role uživatele na serveru s názvem VMMServer01 a pak tyto objekty uloží do proměnné $UserRoles.

Druhý příkaz předá každý objekt role uživatele v $UserRoles rutině Select-Object, která zobrazí jméno, profil role uživatele, nadřazenou roli uživatele a cloud pro každou roli uživatele.

Poslední příkaz předá každou roli uživatele v $UserRoles rutině Get-Member , která zobrazí typ .NET pro každou roli uživatele a metody a vlastnosti přidružené k jednotlivým typům role uživatele.

Parametry

-ID

Určuje jedinečné ID role uživatele, kterou tato rutina získá.

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

-Name

Určuje název role uživatele VMM, kterou tato rutina získá.

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

-OnBehalfOfUser

Určuje uživatelské jméno. Tato rutina funguje jménem uživatele, který tento parametr určuje.

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

-OnBehalfOfUserRole

Určuje roli uživatele. K získání role uživatele použijte rutinu Get-SCUserRole . Tato rutina funguje jménem role uživatele, kterou tento parametr určuje.

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

-UserRoleProfile

Určuje typ profilu, který je základem pro role uživatelů, které tato rutina získá. Tento parametr přijímá tyto hodnoty:

  • Delegovaný správce
  • 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

Určuje server VMM, na kterém tato rutina získá role uživatele.

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

Výstupy

UserRole

Tato rutina vrátí objekt UserRole .