New-SCUserRole
Membuat peran pengguna untuk sekelompok pengguna VMM.
Sintaks
New-SCUserRole
[-VMMServer <ServerConnection>]
[-Name] <String>
-UserRoleProfile <Profile>
[-ID <Guid>]
[-JobGroup <Guid>]
[-Description <String>]
[-ParentUserRole <UserRole>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Deskripsi
Cmdlet New-SCUserRole membuat peran pengguna untuk sekelompok pengguna Virtual Machine Manager (VMM). Anda dapat membuat peran pengguna berikut: Administrator yang Didelegasikan, Administrator Read-Only, administrator Komputer Virtual, dan Pengguna Self-Service. Hanya ada satu peran Administrator. Anda tidak dapat membuat peran Administrator lain atau menghapus peran yang sudah ada.
Jika Anda adalah anggota peran pengguna Administrator yang Didelegasikan, Anda bisa membuat peran pengguna. Namun, cakupan peran pengguna baru harus merupakan subset dari cakupan peran pengguna induknya.
Setelah membuat peran pengguna, Anda dapat menggunakan cmdlet Set-SCUserRole untuk mengganti nama peran pengguna, untuk menambahkan atau menghapus anggota, dan untuk menambahkan atau memodifikasi cakupan objek yang dapat dikelola anggota peran. Untuk peran pengguna Self-Service, Anda dapat menentukan tindakan mana yang dapat diambil anggota peran pengguna Self-Service pada komputer virtual mereka, dan Anda dapat menentukan kuota yang membatasi jumlah komputer virtual yang dapat dibuat pengguna layanan mandiri. Meskipun Anda tidak dapat membuat atau menghapus peran Administrator atau membatasi cakupannya, Anda dapat menggunakan Set-SCUserRole untuk menambahkan atau menghapus anggota ke peran tersebut.
Untuk informasi tentang cara mengubah properti peran pengguna, ketik Get-Help Set-SCUserRole.
Contoh
Contoh 1: Membuat peran pengguna Administrator yang Didelegasikan
PS C:\> New-SCUserRole -Name "ContosoDelegatedAdmin" -Description "Delegated Administrators for the Contoso.com domain" -UserRoleProfile "DelegatedAdmin"Perintah ini membuat peran pengguna administrator yang didelegasikan bernama ContosoDelegatedAdmin, menyediakan deskripsi Administrator yang Didelegasikan untuk domain Contoso.com, dan menggunakan parameter UserRoleProfile untuk menetapkan jenis peran pengguna sebagai Administrator yang Didelegasikan.
Contoh 2: Membuat peran pengguna Layanan Mandiri
PS C:\> $SelfServiceRole = New-SCUserRole -Name "ContosoSelfServiceUsers" -UserRoleProfile "SelfServiceUser"Perintah ini membuat peran pengguna baru bernama ContosoSelfServiceUsers, menggunakan parameter UserRoleProfile untuk menunjuk jenis peran pengguna baru sebagai pengguna Self-Service, dan menyimpan objek peran pengguna baru dalam variabel $SelfServiceRole.
Contoh 3: Membuat peran Administrator Komputer Virtual
PS C:\> New-SCUserRole -Name "VirtualMachineAdmin" -UserRoleProfile "VMAdmin" -Description "Virtual Machine administrator for contoso.com domain"Perintah ini membuat peran pengguna administrator Komputer Virtual bernama VirtualMachineAdmin, menyediakan deskripsi 'Administrator Komputer Virtual untuk domain contoso.com' dan menggunakan parameter UserRoleProfile untuk menetapkan jenis peran pengguna sebagai VMAdmin.
Parameter
-Description
Menentukan deskripsi untuk peran pengguna.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ID
Menentukan ID unik untuk peran pengguna baru.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobGroup
Menentukan pengidentifikasi untuk serangkaian perintah yang berjalan sebagai set tepat sebelum perintah akhir yang menyertakan pengidentifikasi grup pekerjaan yang sama berjalan.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Menentukan variabel di mana kemajuan pekerjaan dilacak dan disimpan.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Menentukan nama untuk peran pengguna baru.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| 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 |
-ParentUserRole
Menentukan peran pengguna VMM yang ada sebagai induk peran pengguna baru.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Menentukan ID tip Performa dan Pengoptimalan Sumber Daya (pro tip) yang memicu tindakan ini. Parameter ini memungkinkan Anda mengaudit tips PRO.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Menunjukkan bahwa pekerjaan berjalan secara asinkron sehingga kontrol segera kembali ke shell perintah.
| Type: | SwitchParameter |
| 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 baru. Nilai yang dapat diterima untuk parameter ini adalah:
- DelegatedAdmin
- ReadOnlyAdmin
- SelfServiceUser
- TenantAdmin
- VMAdmin
| Type: | Profile |
| Accepted values: | Administrator, DelegatedAdmin, VMAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
Menentukan server VMM tempat cmdlet ini membuat 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 .