New-SCUserRole
Vytvoří roli uživatele pro skupinu uživatelů VMM.
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
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živatelů: 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 ale 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 rozsah objektů, které mohou členové role spravovat. U role uživatele Self-Service můžete určit, které akce mohou členové role uživatele Self-Service na svých virtuálních počítačích provádět, 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ů do této role použít Set-SCUserRole .
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ří delegovanou roli uživatele správce s názvem ContosoDelegatedAdmin, poskytne popis Delegovaní správci pro doménu Contoso.com a pomocí parametru UserRoleProfile označí typ role uživatele delegovaným správcem.
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 ContosoSelfServiceUsers, pomocí parametru UserRoleProfile označí nový typ role uživatele jako Self-Service uživatele 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éně a pomocí parametru UserRoleProfile označí typ role uživatele jako VMAdmin.
Parametry
-Description
Určuje popis role uživatele.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ID
Určuje jedinečné ID nové role uživatele.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobGroup
Určuje identifikátor řady příkazů, které běží jako sada těsně před posledním příkazem, který obsahuje stejný identifikátor skupiny úloh.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Určuje proměnnou, ve které se sleduje a ukládá průběh úlohy.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Určuje název nové role uživatele.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
Určuje uživatelské jméno. Tato rutina pracuje jménem uživatele, kterého tento parametr určuje.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
Určuje roli uživatele. K získání role uživatele použijte rutinu Get-SCUserRole . Tato rutina pracuje jménem role uživatele, kterou tento parametr určuje.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ParentUserRole
Určuje existující roli uživatele VMM jako nadřazenou roli nového uživatele.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Označuje, že úloha běží asynchronně, aby se ovládací prvek vrátil do příkazového prostředí okamžitě.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserRoleProfile
Určuje typ profilu, který je základem nové role uživatele. Tento parametr přijímá tyto hodnoty:
- Delegovaný správce
- ReadOnlyAdmin
- SelfServiceUser
- Správce tenanta
- 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
Určuje server VMM, na kterém tato rutina vytvoří roli uživatele.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Výstupy
UserRole
Tato rutina vrátí objekt UserRole .