Sdílet prostřednictvím

Get-SCUserRole

  • Reference
Modul:
VirtualMachineManager

Získá roli uživatele VMM.

Syntaxe

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í na základě role k definování hranic, ve kterých mohou členové dané role uživatele pracovat, a sadu povolených operací, které můžou provádět členové role uživatele.

Informace o vytváření rolí uživatelů potřebujete zadáním Get-Help New-SCUserRole.

Informace o nastavení vlastností role uživatele, včetně oboru delegovaných a jen pro čtení správců a rozsahu a akcí pro uživatele samoobslužných služeb, 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živatele 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 názvu

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 rolí 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á pro každou roli uživatele zobrazí jméno, profil role uživatele, nadřazenou roli uživatele a cloud.

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

Parametry

-ID

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

Typ:Guid
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

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

Typ:String
Position:0
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-OnBehalfOfUser

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

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-OnBehalfOfUserRole

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

Typ:UserRole
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-UserRoleProfile

Určuje typ profilu, který je základem pro role uživatelů, které tato rutina získá. Přijatelné hodnoty pro tento parametr jsou:

  • Delegovaný správce
  • ReadOnlyAdmin
  • SelfServiceUser
Typ:Profile
Přípustné hodnoty:Administrator, DelegatedAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-VMMServer

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

Typ:ServerConnection
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Výstupy

UserRole

Tato rutina vrátí objekt UserRole.