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
Свойства параметра
| Тип: | 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.