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

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 и сохраняет объект в переменной $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

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

Первая команда получает объект роли пользователя с именем Contoso SQL Operators и сохраняет объект в переменной $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, распространяются на все классы.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-AllGroup

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-AllTask

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ClassScope

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

Type:ManagementPackClass[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Запрос подтверждения перед выполнением командлета.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GroupScope

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

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

Type:MonitoringObjectGroup[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TaskScope

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

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

Type:ManagementPackTask[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-User

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

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-UserRole

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

Type:UserRole
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False