New-SCUserRole
VmM kullanıcılarının bir grubu için bir kullanıcı rolü oluşturur.
Syntax
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>]
Description
New-SCUserRole cmdlet'i, bir grup Virtual Machine Manager (VMM) kullanıcısı için bir kullanıcı rolü oluşturur. Şu kullanıcı rollerini oluşturabilirsiniz: Yönetici Temsilcisi, yönetici Read-Only, Sanal Makine yöneticisi ve Self-Service Kullanıcı. Yalnızca bir Yönetici rolü var. Başka bir Yönetici rolü oluşturamaz veya var olan rolü silemezsiniz.
Yönetici Temsilcisi kullanıcı rolünün üyesiyseniz, bir kullanıcı rolü oluşturabilirsiniz. Ancak, yeni kullanıcı rolünün kapsamı, üst kullanıcı rolünün kapsamının bir alt kümesi olmalıdır.
Bir kullanıcı rolü oluşturduktan sonra Set-SCUserRole cmdlet'ini kullanarak kullanıcı rolünü yeniden adlandırabilir, üye ekleyebilir veya kaldırabilir ve rol üyelerinin yönetebileceği nesnelerin kapsamını ekleyebilir veya değiştirebilirsiniz. Self-Service kullanıcı rolü için, Self-Service kullanıcı rolünün üyelerinin sanal makinelerinde hangi eylemleri gerçekleştirebileceğini belirtebilir ve self servis kullanıcılarının oluşturabileceği sanal makine sayısını sınırlayan bir kota tanımlayabilirsiniz. Yönetici rolünü oluşturamasanız veya kaldıramasanız da ya da kapsamını sınırlandıramasanız da, bu role üye eklemek veya kaldırmak için Set-SCUserRole kullanabilirsiniz.
Kullanıcı rolünün özelliklerini değiştirme hakkında bilgi için yazın Get-Help Set-SCUserRole
.
Örnekler
Örnek 1: Yönetici Temsilcisi kullanıcı rolü oluşturma
PS C:\> New-SCUserRole -Name "ContosoDelegatedAdmin" -Description "Delegated Administrators for the Contoso.com domain" -UserRoleProfile "DelegatedAdmin"
Bu komut ContosoDelegatedAdmin adlı bir yönetici temsilcisi kullanıcı rolü oluşturur, Contoso.com etki alanı için Yönetici Temsilcileri açıklamasını sağlar ve kullanıcı rolü türünü Yönetici Temsilcisi olarak atamak için UserRoleProfile parametresini kullanır.
Örnek 2: Self Servis kullanıcı rolü oluşturma
PS C:\> $SelfServiceRole = New-SCUserRole -Name "ContosoSelfServiceUsers" -UserRoleProfile "SelfServiceUser"
Bu komut ContosoSelfServiceUsers adlı yeni bir kullanıcı rolü oluşturur, userRoleProfile parametresini kullanarak yeni kullanıcı rolü türünü Self-Service kullanıcı olarak belirler ve yeni kullanıcı rolü nesnesini $SelfServiceRole değişkeninde depolar.
Örnek 3: Sanal Makine Yöneticisi rolü oluşturma
PS C:\> New-SCUserRole -Name "VirtualMachineAdmin" -UserRoleProfile "VMAdmin" -Description "Virtual Machine administrator for contoso.com domain"
Bu komut VirtualMachineAdmin adlı bir Sanal Makine yöneticisi kullanıcı rolü oluşturur, 'contoso.com etki alanı için Sanal Makine yöneticisi' açıklamasını sağlar ve kullanıcı rolü türünü VMAdmin olarak ayarlamak için UserRoleProfile parametresini kullanır.
Parametreler
-Description
Kullanıcı rolü için bir açıklama belirtir.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ID
Yeni kullanıcı rolü için benzersiz kimliği belirtir.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobGroup
Aynı iş grubu tanımlayıcısını içeren son komut çalıştırmalarından hemen önce küme olarak çalışan bir dizi komut için tanımlayıcı belirtir.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobVariable
İş ilerleme durumunun izlendiği ve depolandığı bir değişken belirtir.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Yeni kullanıcı rolü için bir ad belirtir.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OnBehalfOfUser
Bir kullanıcı adı belirtir. Bu cmdlet, bu parametrenin belirttiği kullanıcı adına çalışır.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OnBehalfOfUserRole
Bir kullanıcı rolü belirtir. Kullanıcı rolü almak için Get-SCUserRole cmdlet'ini kullanın. Bu cmdlet, bu parametrenin belirttiği kullanıcı rolü adına çalışır.
Type: | UserRole |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ParentUserRole
Yeni kullanıcı rolünün üst öğesi olarak mevcut bir VMM kullanıcı rolünü belirtir.
Type: | UserRole |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
Bu eylemi tetikleyen Performans ve Kaynak İyileştirme ipucunun (PRO ipucu) kimliğini belirtir. Bu parametre PRO ipuçlarını denetlemenize olanak tanır.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsynchronously
Denetimin hemen komut kabuğuna döndürülmesi için işin zaman uyumsuz olarak çalıştığını gösterir.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserRoleProfile
Yeni kullanıcı rolünün temeli olan profil türünü belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:
- 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
Bu cmdlet'in kullanıcı rolü oluşturduğu VMM sunucusunu belirtir.
Type: | ServerConnection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Çıkışlar
UserRole
Bu cmdlet bir UserRole nesnesi döndürür.