New-SCUserRole
Создает роль пользователя для группы пользователей VMM.
Синтаксис
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>] Описание
Командлет New-SCUserRole создает роль пользователя для группы пользователей Virtual Machine Manager (VMM). Вы можете создать следующие роли пользователей: делегированный администратор, администратор Read-Only, администратор виртуальной машины и пользователь Self-Service. Существует только одна роль администратора. Нельзя создать другую роль администратора или удалить существующую.
Если вы являетесь членом роли "Делегированный администратор", вы можете создать роль пользователя. Однако область новой роли пользователя должна быть подмножеством области его родительской роли пользователя.
После создания роли пользователя можно использовать командлет Set-SCUserRole , чтобы переименовать роль пользователя, добавить или удалить участников, а также добавить или изменить область объектов, которыми могут управлять члены роли. Для роли пользователя Self-Service можно указать, какие действия могут выполнять члены Self-Service роли пользователя на своих виртуальных машинах, а также определить квоту, которая ограничивает количество создаваемых пользователей самообслуживания виртуальных машин. Хотя вы не можете создать или удалить роль администратора или ограничить ее область действия, вы можете использовать Set-SCUserRole для добавления или удаления участников в эту роль.
Сведения о том, как изменить свойства роли пользователя, введите Get-Help Set-SCUserRole.
Примеры
Пример 1. Создание роли пользователя делегированного администратора
PS C:\> New-SCUserRole -Name "ContosoDelegatedAdmin" -Description "Delegated Administrators for the Contoso.com domain" -UserRoleProfile "DelegatedAdmin"Эта команда создает делегированную роль администратора с именем ContosoDelegatedAdmin, предоставляет описание делегированных администраторов для домена Contoso.com и использует параметр UserRoleProfile для назначения типа роли пользователя в качестве делегированного администратора.
Пример 2. Создание роли пользователя самообслуживания
PS C:\> $SelfServiceRole = New-SCUserRole -Name "ContosoSelfServiceUsers" -UserRoleProfile "SelfServiceUser"Эта команда создает новую роль пользователя с именем ContosoSelfServiceUsers, использует параметр UserRoleProfile для назначения нового типа роли пользователя в качестве Self-Service пользователя и сохраняет новый объект роли пользователя в переменной $SelfServiceRole.
Пример 3. Создание роли администратора виртуальной машины
PS C:\> New-SCUserRole -Name "VirtualMachineAdmin" -UserRoleProfile "VMAdmin" -Description "Virtual Machine administrator for contoso.com domain"Эта команда создает роль администратора виртуальной машины с именем VirtualMachineAdmin, предоставляет описание "Администратор виртуальной машины для домена contoso.com" и использует параметр UserRoleProfile для назначения типа роли пользователя в качестве VMAdmin.
Параметры
-Description
Указывает описание роли пользователя.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ID
Указывает уникальный идентификатор для новой роли пользователя.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobGroup
Указывает идентификатор для ряда команд, которые выполняются как набор непосредственно перед окончательной командой, которая включает тот же идентификатор группы заданий.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Указывает переменную, в которой выполняется отслеживание и хранение хода выполнения задания.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Указывает имя новой роли пользователя.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
Указывает имя пользователя. Этот командлет работает от имени пользователя, указанного этим параметром.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
Указывает роль пользователя. Чтобы получить роль пользователя, используйте командлет Get-SCUserRole . Этот командлет работает от имени роли пользователя, указанной этим параметром.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ParentUserRole
Указывает существующую роль пользователя VMM в качестве родителя новой роли пользователя.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Указывает идентификатор подсказки по оптимизации производительности и ресурсов (подсказка PRO), активировав это действие. Этот параметр позволяет выполнять аудит советов PRO.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Указывает, что задание выполняется асинхронно, чтобы управление немедленно возвращалось в командную оболочку.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserRoleProfile
Указывает тип профиля, который является основой для новой роли пользователя. Допустимые значения для этого параметра:
- 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
Указывает сервер VMM, на котором этот командлет создает роль пользователя.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Выходные данные
UserRole
Этот командлет возвращает объект UserRole .