Bagikan melalui

Get-SCUserRole

  • Referensi
Modul:
VirtualMachineManager

Mendapatkan peran pengguna VMM.

Sintaks

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

Deskripsi

Cmdlet Get-SCUserRole mendapatkan satu atau beberapa peran pengguna Virtual Machine Manager (VMM). VMM menggunakan keamanan berbasis peran untuk menentukan batasan di mana anggota peran pengguna tertentu dapat beroperasi dan serangkaian anggota operasi yang diizinkan dari peran pengguna dapat melakukan.

Untuk informasi tentang membuat peran pengguna, ketik Get-Help New-SCUserRole.

Untuk informasi tentang mengatur properti peran pengguna, termasuk cakupan untuk administrator yang didelegasikan dan baca-saja serta cakupan dan tindakan untuk pengguna layanan mandiri, ketik Get-Help Set-SCUserRole.

Contoh

Contoh 1: Mendapatkan semua peran pengguna

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

Perintah ini mendapatkan semua peran pengguna VMM di server bernama VMMServer01.Contoso.com. Perintah menampilkan informasi tentang setiap peran pengguna.

Contoh 2: Mendapatkan peran pengguna berdasarkan nama

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

Perintah ini mendapatkan objek peran pengguna bernama Administrator. Perintah menampilkan informasi tentang peran pengguna tersebut.

Contoh 3: Mendapatkan peran pengguna menurut profil

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

Perintah ini mendapatkan peran pengguna server bernama VMMServer01 yang memiliki profil peran pengguna SelfServiceUser. Perintah menampilkan informasi tentang peran pengguna ini.

Contoh 4: Menampilkan properti dan informasi lain tentang objek peran pengguna

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

Perintah pertama mendapatkan semua objek peran pengguna di server bernama VMMServer01, lalu menyimpan objek tersebut dalam variabel $UserRoles.

Perintah kedua meneruskan setiap objek peran pengguna dalam $UserRoles ke cmdlet Select-Object, yang kemudian menampilkan nama, profil peran pengguna, peran pengguna induk, dan cloud untuk setiap peran pengguna

Perintah akhir meneruskan setiap peran pengguna dalam $UserRoles ke cmdlet Get-Member , yang menampilkan jenis .NET untuk setiap peran pengguna dan metode dan properti yang terkait dengan setiap jenis peran pengguna.

Parameter

-ID

Menentukan ID unik untuk peran pengguna yang didapat cmdlet ini.

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

-Name

Menentukan nama peran pengguna VMM yang didapat cmdlet ini.

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

-OnBehalfOfUser

Menentukan nama pengguna. Cmdlet ini beroperasi atas nama pengguna yang ditentukan parameter ini.

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

-OnBehalfOfUserRole

Menentukan peran pengguna. Untuk mendapatkan peran pengguna, gunakan cmdlet Get-SCUserRole . Cmdlet ini beroperasi atas nama peran pengguna yang ditentukan parameter ini.

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

-UserRoleProfile

Menentukan jenis profil yang menjadi dasar untuk peran pengguna yang didapat cmdlet ini. Nilai yang dapat diterima untuk parameter ini adalah:

  • 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

Menentukan server VMM tempat cmdlet ini mendapatkan peran pengguna.

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

Output

UserRole

Cmdlet ini mengembalikan objek UserRole .