Udostępnij za pośrednictwem

Get-SCUserRole

  • Odwołanie
Moduł:
VirtualMachineManager

Pobiera rolę użytkownika programu VMM.

Składnia

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

Opis

Polecenie cmdlet Get-SCUserRole pobiera co najmniej jedną rolę użytkownika programu Virtual Machine Manager (VMM). Program VMM używa zabezpieczeń opartych na rolach do definiowania granic, w których członkowie danej roli użytkownika mogą działać, a zestaw dozwolonych członków operacji roli użytkownika może wykonywać.

Aby uzyskać informacje na temat tworzenia ról użytkownika, wpisz Get-Help New-SCUserRole.

Aby uzyskać informacje o ustawianiu właściwości roli użytkownika, w tym zakresu dla administratorów delegowanych i tylko do odczytu oraz zakresu i akcji dla użytkowników samoobsługi, wpisz Get-Help Set-SCUserRole.

Przykłady

Przykład 1. Pobieranie wszystkich ról użytkowników

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

To polecenie pobiera wszystkie role użytkownika programu VMM na serwerze o nazwie VMMServer01.Contoso.com. Polecenie wyświetla informacje o każdej roli użytkownika.

Przykład 2. Pobieranie roli użytkownika według nazwy

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

To polecenie pobiera obiekt roli użytkownika o nazwie Administrator. Polecenie wyświetla informacje o tej roli użytkownika.

Przykład 3. Pobieranie roli użytkownika według profilu

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

To polecenie pobiera role użytkownika na serwerze o nazwie VMMServer01, który ma profil roli użytkownika SelfServiceUser. Polecenie wyświetla informacje o tych rolach użytkownika.

Przykład 4. Wyświetlanie właściwości i innych informacji o obiektach roli użytkownika

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

Pierwsze polecenie pobiera wszystkie obiekty roli użytkownika na serwerze o nazwie VMMServer01, a następnie przechowuje te obiekty w zmiennej $UserRoles.

Drugie polecenie przekazuje każdy obiekt roli użytkownika w $UserRoles do polecenia cmdlet Select-Object, które następnie wyświetla nazwę, profil roli użytkownika, rolę nadrzędnego użytkownika i chmurę dla każdej roli użytkownika

Ostatnie polecenie przekazuje każdą rolę użytkownika w $UserRoles do get-member polecenia cmdlet, które wyświetla typ platformy .NET dla każdej roli użytkownika oraz metody i właściwości skojarzone z każdym typem roli użytkownika.

Parametry

-ID

Określa unikatowy identyfikator roli użytkownika, którą pobiera to polecenie cmdlet.

Typ:Guid
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę roli użytkownika programu VMM, którą pobiera to polecenie cmdlet.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-OnBehalfOfUser

Określa nazwę użytkownika. To polecenie cmdlet działa w imieniu użytkownika, który określa ten parametr.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-OnBehalfOfUserRole

Określa rolę użytkownika. Aby uzyskać rolę użytkownika, użyj polecenia cmdlet Get-SCUserRole. To polecenie cmdlet działa w imieniu roli użytkownika, którą określa ten parametr.

Typ:UserRole
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UserRoleProfile

Określa typ profilu, który jest podstawą ról użytkownika pobieranych przez to polecenie cmdlet. Dopuszczalne wartości tego parametru to:

  • Administrator delegowany
  • ReadOnlyAdmin
  • SelfServiceUser
Typ:Profile
Dopuszczalne wartości:Administrator, DelegatedAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-VMMServer

Określa serwer programu VMM, na którym to polecenie cmdlet pobiera role użytkownika.

Typ:ServerConnection
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wyjściowe

UserRole

To polecenie cmdlet zwraca obiekt UserRole.