Udostępnij za pośrednictwem


Get-SCUserRole

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 o tworzeniu ról użytkownika, wpisz Get-Help New-SCUserRole.

Aby uzyskać informacje na temat ustawiania właściwości roli użytkownika, w tym zakresu 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ę użytkownika nadrzędnego i chmurę dla każdej roli użytkownika

Ostatnie polecenie przekazuje każdą rolę użytkownika w $UserRoles do polecenia cmdlet Get-Member , 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ą otrzymuje to polecenie cmdlet.

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

-Name

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

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

-OnBehalfOfUser

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

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

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

-UserRoleProfile

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

  • Administrator delegowany
  • 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

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

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

Dane wyjściowe

UserRole

To polecenie cmdlet zwraca obiekt UserRole .