Get-SCUserRole
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 .