Поделиться через

New-SCUserRole

  • Ссылка
Модуль:
VirtualMachineManager

Создает роль пользователя для группы пользователей 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

Указывает описание роли пользователя.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ID

Указывает уникальный идентификатор для новой роли пользователя.

Тип:Guid
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-JobGroup

Задает идентификатор для ряда команд, которые выполняются в качестве набора непосредственно перед окончательной командой, которая содержит тот же идентификатор группы заданий.

Тип:Guid
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-JobVariable

Указывает переменную, в которой выполняется задание, отслеживается и сохраняется.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Name

Указывает имя новой роли пользователя.

Тип:String
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-OnBehalfOfUser

Указывает имя пользователя. Этот командлет работает от имени пользователя, указанного этим параметром.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-OnBehalfOfUserRole

Указывает роль пользователя. Чтобы получить роль пользователя, используйте командлет Get-SCUserRole . Этот командлет работает от имени роли пользователя, указанной этим параметром.

Тип:UserRole
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ParentUserRole

Указывает существующую роль пользователя VMM в качестве родительской роли нового пользователя.

Тип:UserRole
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PROTipID

Указывает идентификатор подсказки по оптимизации производительности и ресурсов (подсказка PRO), активировав это действие. Этот параметр позволяет выполнять аудит советов PRO.

Тип:Guid
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RunAsynchronously

Указывает, что задание выполняется асинхронно, чтобы элемент управления сразу же возвращал командную оболочку.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-UserRoleProfile

Указывает тип профиля, который является основой для новой роли пользователя. Допустимые значения для этого параметра:

  • ДелегированныйAdmin
  • ReadOnlyAdmin
  • SelfServiceUser
  • TenantAdmin
  • VMAdmin
Тип:Profile
Допустимые значения:Administrator, DelegatedAdmin, VMAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-VMMServer

Указывает сервер VMM, на котором этот командлет создает роль пользователя.

Тип:ServerConnection
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

Выходные данные

UserRole

Этот командлет возвращает объект UserRole.