New-SCUserRole
Vytvoří roli uživatele pro skupinu uživatelů VMM.
Syntaxe
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
Rutina New-SCUserRole vytvoří roli uživatele pro skupinu uživatelů nástroje Virtual Machine Manager (VMM). Můžete vytvořit následující role uživatele: Delegovaný správce, Read-Only Správce, Správce virtuálního počítače a Self-Service Uživatel. Existuje pouze jedna role správce. Nemůžete vytvořit jinou roli správce ani existující roli odstranit.
Pokud jste členem role uživatele Delegovaný správce, můžete vytvořit roli uživatele. Obor nové role uživatele však musí být podmnožinou oboru jeho nadřazené role uživatele.
Po vytvoření role uživatele můžete pomocí rutiny Set-SCUserRole přejmenovat roli uživatele, přidat nebo odebrat členy a přidat nebo upravit obor objektů, které můžou členové role spravovat. U role uživatele Self-Service můžete určit, které akce můžou členové role uživatele Self-Service provádět na svých virtuálních počítačích, a můžete definovat kvótu, která omezuje počet uživatelů samoobslužných virtuálních počítačů, které můžou vytvářet. I když nemůžete vytvořit nebo odebrat roli správce nebo omezit její obor, můžete k přidání nebo odebrání členů této role použít Set-SCUserRol e.
Informace o tom, jak upravit vlastnosti role uživatele, zadejte Get-Help Set-SCUserRole.
Příklady
Příklad 1: Vytvoření role uživatele Delegovaný správce
PS C:\> New-SCUserRole -Name "ContosoDelegatedAdmin" -Description "Delegated Administrators for the Contoso.com domain" -UserRoleProfile "DelegatedAdmin"Tento příkaz vytvoří roli uživatele delegovaného správce s názvem ContosoDelegatedAdmin, poskytne popis Delegovaní správci pro Contoso.com doménu a použije parametr UserRoleProfile k určení typu role uživatele jako Delegovaný správce.
Příklad 2: Vytvoření role samoobslužného uživatele
PS C:\> $SelfServiceRole = New-SCUserRole -Name "ContosoSelfServiceUsers" -UserRoleProfile "SelfServiceUser"Tento příkaz vytvoří novou roli uživatele s názvem ContosoSelfServiceUsers, použije parametr UserRoleProfile určit nový typ role uživatele jako Self-Service uživatel a uloží nový objekt role uživatele do proměnné $SelfServiceRole.
Příklad 3: Vytvoření role správce virtuálního počítače
PS C:\> New-SCUserRole -Name "VirtualMachineAdmin" -UserRoleProfile "VMAdmin" -Description "Virtual Machine administrator for contoso.com domain"Tento příkaz vytvoří roli uživatele správce virtuálního počítače s názvem VirtualMachineAdmin, poskytne popis "Správce virtuálního počítače pro contoso.com doménu" a pomocí parametru UserRoleProfile určí typ role uživatele jako VMAdmin.
Parametry
-Description
Určuje popis role uživatele.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ID
Určuje jedinečné ID nové role uživatele.
| Typ: | Guid |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-JobGroup
Určuje identifikátor pro řadu příkazů, které se spouští jako sada těsně před posledním příkazem, který obsahuje stejné spuštění identifikátoru skupiny úloh.
| Typ: | Guid |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-JobVariable
Určuje proměnnou, ve které je průběh úlohy sledován a uložen.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Name
Určuje název nové role uživatele.
| Typ: | String |
| Position: | 0 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-OnBehalfOfUser
Určuje uživatelské jméno. Tato rutina funguje jménem uživatele, který tento parametr určuje.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-OnBehalfOfUserRole
Určuje roli uživatele. Pokud chcete získat roli uživatele, použijte rutinu Get-SCUserRole. Tato rutina funguje jménem role uživatele, kterou tento parametr určuje.
| Typ: | UserRole |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ParentUserRole
Určuje existující roli uživatele VMM jako nadřazenou roli nového uživatele.
| Typ: | UserRole |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-PROTipID
Určuje ID tipu pro optimalizaci výkonu a prostředků (TIP PRO), který tuto akci aktivoval. Tento parametr umožňuje auditovat tipy PRO.
| Typ: | Guid |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-RunAsynchronously
Označuje, že úloha běží asynchronně, aby se ovládací prvek okamžitě vrátil do příkazového prostředí.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-UserRoleProfile
Určuje typ profilu, který je základem nové role uživatele. Přijatelné hodnoty pro tento parametr jsou:
- Delegovaný správce
- ReadOnlyAdmin
- SelfServiceUser
- TenantAdmin
- VMAdmin
| Typ: | Profile |
| Přípustné hodnoty: | Administrator, DelegatedAdmin, VMAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-VMMServer
Určuje server VMM, na kterém tato rutina vytvoří roli uživatele.
| Typ: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
Výstupy
UserRole
Tato rutina vrátí objekt UserRole.