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 .