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ąć członków 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ć 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 Delegowani administratorzy dla domeny Contoso.com i używa UserRoleProfile parametru, aby wyznaczyć typ 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
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.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-ID
Określa unikatowy identyfikator nowej roli użytkownika.
| Typ: | Guid |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-JobGroup
Określa identyfikator serii poleceń uruchamianych jako zestaw tuż przed ostatnim poleceniem zawierającym ten sam identyfikator grupy zadań.
| Typ: | Guid |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-JobVariable
Określa zmienną, w której postęp zadania jest śledzony i przechowywany.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Name
Określa nazwę nowej roli użytkownika.
| Typ: | String |
| Position: | 0 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-OnBehalfOfUser
Określa nazwę użytkownika. To polecenie cmdlet działa w imieniu użytkownika, który określa ten parametr.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | UserRole |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-ParentUserRole
Określa istniejącą rolę użytkownika programu VMM jako element nadrzędny nowej roli użytkownika.
| Typ: | UserRole |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | Guid |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-RunAsynchronously
Wskazuje, że zadanie jest uruchamiane asynchronicznie, aby kontrolka natychmiast wracała do powłoki poleceń.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-UserRoleProfile
Określa typ profilu, który jest podstawą nowej roli użytkownika. Dopuszczalne wartości tego parametru to:
- Administrator delegowany
- ReadOnlyAdmin
- SelfServiceUser
- Administrator dzierżawy
- Administrator maszyny wirtualnej
| Typ: | Profile |
| Dopuszczalne wartości: | Administrator, DelegatedAdmin, VMAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-VMMServer
Określa serwer programu VMM, na którym to polecenie cmdlet tworzy rolę użytkownika.
| Typ: | ServerConnection |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
Dane wyjściowe
UserRole
To polecenie cmdlet zwraca obiekt UserRole.