Set-SCOMUserRole

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

Синтаксис

FromUser

Set-SCOMUserRole
    [-UserRole] <UserRole>
    -User <String[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FromAllClassScope

Set-SCOMUserRole
    [-UserRole] <UserRole>
    [-AllClass]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FromClassScope

Set-SCOMUserRole
    [-UserRole] <UserRole>
    -ClassScope <ManagementPackClass[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FromAllTaskScope

Set-SCOMUserRole
    [-UserRole] <UserRole>
    [-AllTask]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FromTaskScope

Set-SCOMUserRole
    [-UserRole] <UserRole>
    -TaskScope <ManagementPackTask[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FromAllGroupScope

Set-SCOMUserRole
    [-UserRole] <UserRole>
    [-AllGroup]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FromGroupcope

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
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

FromAllClassScope
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AllGroup

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

FromAllGroupScope
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AllTask

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

FromAllTaskScope
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ClassScope

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

Свойства параметра

Тип:

ManagementPackClass[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

FromClassScope
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Confirm

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

Свойства параметра

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-GroupScope

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

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

Свойства параметра

Тип:

MonitoringObjectGroup[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

FromGroupcope
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PassThru

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-TaskScope

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

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

Свойства параметра

Тип:

ManagementPackTask[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

FromTaskScope
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-User

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

Свойства параметра

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

FromUser
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-UserRole

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

Свойства параметра

Тип:UserRole
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:1
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WhatIf

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

Свойства параметра

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.