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

Set-SCOMUserRole

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

Настраивает роль пользователя Operations Manager.

Синтаксис

Set-SCOMUserRole
   [-UserRole] <UserRole>
   -User <String[]>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SCOMUserRole
   [-UserRole] <UserRole>
   [-AllClass]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SCOMUserRole
   [-UserRole] <UserRole>
   -ClassScope <ManagementPackClass[]>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SCOMUserRole
   [-UserRole] <UserRole>
   [-AllTask]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SCOMUserRole
   [-UserRole] <UserRole>
   -TaskScope <ManagementPackTask[]>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SCOMUserRole
   [-UserRole] <UserRole>
   [-AllGroup]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SCOMUserRole
   [-UserRole] <UserRole>
   -GroupScope <MonitoringObjectGroup[]>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Командлет Set-SCOMUserRole настраивает роль пользователя System Center — Operations Manager. Роль пользователя содержит две функции:

  • Профиль. Определяет коллекцию операций, к которым имеет доступ роль пользователя.
  • Размах. Определяет границы операций профиля; например, задачи и группы.

Этот командлет можно использовать для обновления списка пользователей или области роли пользователя.

Примеры

Пример 1. Предоставление пользователю доступа ко всем задачам

PS C:\>$Role = Get-SCOMUserRole -Name "Constoso Operators"
PS C:\> $Role | Set-SCOMUserRole -AllTask -PassThru | Set-SCOMUserRole -AllGroup

В этом примере показано, как обновить роль пользователя, чтобы предоставить ему доступ ко всем задачам.

Первая команда получает объект роли пользователя с именем Contoso Operators и сохраняет объект в переменной $Role.

Вторая команда использует оператор конвейера для передачи роли пользователя, хранящейся в переменной $Role, командлету Set-SCOMUserRole. Этот командлет предоставляет пользователю доступ ко всем задачам и возвращает обновленный объект роли пользователя. Затем команда передает обновленный объект Set-SCOMUserRole с помощью оператора конвейера, который утверждает роль для всех групп.

Пример 2. Предоставление пользователю доступа к определенным задачам

PS C:\>$Role = Get-SCOMUserRole -Name "Constoso SQL Operators"
PS C:\> $NewTaskList = Get-SCOMTask -Name "*SQL*"
PS C:\> $Role | Set-SCOMUserRole -TaskScope $NewTaskList

В этом примере показано, как обновить роль пользователя, чтобы предоставить ему доступ к определенным задачам.

Первая команда получает объект роли пользователя с именем "Операторы SQL Contoso" и сохраняет объект в переменной $Role.

Вторая команда получает все объекты задач с SQL в их именах и сохраняет объекты в переменной $NewTaskList.

Последняя команда использует оператор конвейера для передачи роли пользователя, хранящейся в переменной $Role, для Set-SCOMUserRole, которая сбрасывает коллекцию утвержденных задач в список, хранящийся в переменной $NewTaskList.

Пример 3. Добавление роли пользователя

PS C:\>$Role = Get-SCOMUserRole -Name "Contoso Read-Only Operators"
PS C:\> $Role | Set-SCOMUserRole -User ($Role.Users + "Contoso\Cesar")

В этом примере пользователь добавляется в роль пользователя.

Первая команда получает объект роли пользователя с именем Contoso Read-Only Operators и сохраняет объект в переменной $Role.

Вторая команда использует оператор конвейера для передачи объекта, хранящегося в переменной $Role, командлету Set-SCOMUserRole, который добавляет пользователя Contoso\Cesar в существующий список пользователей для роли.

Параметры

-AllClass

Указывает, что разрешения, предоставленные ролью пользователя Author, расширяются ко всем классам.

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

-AllGroup

Указывает, что разрешения, предоставленные роли пользователя, расширяются для всех групп.

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

-AllTask

Указывает, что разрешения, которые предоставляет роль пользователя "Автор", "Оператор" или "Расширенный оператор" для всех задач.

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

-ClassScope

Задает массив объектов ManagementPackClass, представляющих классы, к которым имеет доступ роль Author. Чтобы получить объект ManagementPackClass , используйте командлет Get-SCOMClass .

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

-Confirm

Запрашивает подтверждение перед запуском командлета.

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

-GroupScope

Задает массив объектов MonitoringObjectGroup, представляющих группы, к которым имеет доступ роль пользователя. Чтобы получить объект группы объектов мониторинга, используйте командлет Get-MonitoringObjectGroup.

Если значение этого параметра не указано, роль имеет доступ ко всем группам. Чтобы запретить доступ к роли ко всем группам, укажите $Null или пустой массив @().

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

-PassThru

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

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

-TaskScope

Задает массив объектов ManagementPackTask, представляющих задачи, к которым имеется роль "Автор", "Оператор" или "Расширенный оператор".

Если значение этого параметра не указано, роль имеет доступ ко всем задачам. Чтобы запретить доступ к роли "Автор", "Оператор" или "Расширенный оператор" ко всем задачам, укажите $Null или пустой массив @().

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

-User

Задает массив имен пользователей, которые являются частью этой роли пользователя. Этот список заменяет существующий список пользователей. Чтобы очистить всех пользователей от роли пользователя, укажите $Null или пустой массив @().

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

-UserRole

Указывает объект роли пользователя. Чтобы получить объект UserRole, командлет Get-SCOMUserRole.

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

-WhatIf

Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.

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