New-SCUserRole
Tworzy rolę użytkownika dla grupy użytkowników programu VMM.
Składnia
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>] Opis
Polecenie cmdlet New-SCUserRole tworzy rolę użytkownika dla grupy użytkowników programu Virtual Machine Manager (VMM). Możesz utworzyć następujące role użytkownika: Administrator delegowany, administrator Read-Only, administrator maszyny wirtualnej i użytkownik Self-Service. Istnieje tylko jedna rola administratorów. Nie można utworzyć innej roli administratora ani usunąć istniejącej.
Jeśli jesteś członkiem roli użytkownika Administrator delegowany, możesz utworzyć rolę użytkownika. Jednak zakres nowej roli użytkownika musi być podzbiorem zakresu roli użytkownika nadrzędnego.
Po utworzeniu roli użytkownika możesz użyć polecenia cmdlet Set-SCUserRole , aby zmienić nazwę roli użytkownika, dodać lub usunąć elementy członkowskie oraz dodać lub zmodyfikować zakres obiektów, którymi członkowie roli mogą zarządzać. W przypadku roli użytkownika Self-Service można określić, które akcje mogą wykonywać członkowie roli użytkownika Self-Service na maszynach wirtualnych, a także zdefiniować limit przydziału, który ogranicza liczbę użytkowników samoobsługi maszyn wirtualnych. Chociaż nie można utworzyć ani usunąć roli administratora ani ograniczyć jej zakresu, możesz użyć polecenia Set-SCUserRole , aby dodać lub usunąć członków do tej roli.
Aby uzyskać informacje na temat modyfikowania właściwości roli użytkownika, wpisz Get-Help Set-SCUserRole.
Przykłady
Przykład 1. Tworzenie roli użytkownika administrator delegowany
PS C:\> New-SCUserRole -Name "ContosoDelegatedAdmin" -Description "Delegated Administrators for the Contoso.com domain" -UserRoleProfile "DelegatedAdmin"To polecenie tworzy rolę użytkownika administratora delegowanego o nazwie ContosoDelegatedAdmin, zawiera opis Administratorzy delegowani dla domeny Contoso.com i używa parametru UserRoleProfile do wyznaczenia typu roli użytkownika jako Administrator delegowany.
Przykład 2. Tworzenie roli użytkownika samoobsługi
PS C:\> $SelfServiceRole = New-SCUserRole -Name "ContosoSelfServiceUsers" -UserRoleProfile "SelfServiceUser"To polecenie tworzy nową rolę użytkownika o nazwie ContosoSelfServiceUsers, używa parametru UserRoleProfile do wyznaczenia nowego typu roli użytkownika jako użytkownika Self-Service i przechowuje nowy obiekt roli użytkownika w zmiennej $SelfServiceRole.
Przykład 3. Tworzenie roli administratora maszyny wirtualnej
PS C:\> New-SCUserRole -Name "VirtualMachineAdmin" -UserRoleProfile "VMAdmin" -Description "Virtual Machine administrator for contoso.com domain"To polecenie tworzy rolę użytkownika administratora maszyny wirtualnej o nazwie VirtualMachineAdmin, zawiera opis "Administrator maszyny wirtualnej dla domeny contoso.com" i używa parametru UserRoleProfile do wyznaczenia typu roli użytkownika jako VMAdmin.
Parametry
-Description
Określa opis roli użytkownika.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ID
Określa unikatowy identyfikator nowej roli użytkownika.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobGroup
Określa identyfikator serii poleceń uruchamianych jako zestaw tuż przed ostatnim poleceniem zawierającym ten sam identyfikator grupy zadań.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Określa zmienną, w której postęp zadania jest śledzony i przechowywany.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Określa nazwę nowej roli użytkownika.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
Określa nazwę użytkownika. To polecenie cmdlet działa w imieniu użytkownika określonego przez 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 |
-ParentUserRole
Określa istniejącą rolę użytkownika programu VMM jako element nadrzędny nowej roli użytkownika.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Określa identyfikator porady wydajności i optymalizacji zasobów (porada PRO), która wyzwoliła tę akcję. Ten parametr umożliwia inspekcję porad PRO.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Wskazuje, że zadanie jest uruchamiane asynchronicznie, aby kontrolka natychmiast wracała do powłoki poleceń.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserRoleProfile
Określa typ profilu, który jest podstawą nowej roli użytkownika. Dopuszczalne wartości dla tego parametru to:
- DelegatedAdmin
- ReadOnlyAdmin
- SelfServiceUser
- Administrator dzierżawy
- 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
Określa serwer programu VMM, na którym to polecenie cmdlet tworzy rolę 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 .