New-SCSMUserRole
Создает новую роль пользователя в Service Manager.
Синтаксис
New-SCSMUserRole
[-UserRoleType] <UserRoleTypeEnum>
-DisplayName <String>
[-Description <String>]
[-Class <ManagementPackClass[]>]
[-Group <EnterpriseManagementObject[]>]
[-CatalogGroup <EnterpriseManagementObject[]>]
[-Queue <EnterpriseManagementObject[]>]
[-Task <ManagementPackConsoleTask[]>]
[-View <ManagementPackView[]>]
[-FormTemplate <ManagementPackObjectTemplate[]>]
[-User <String[]>]
[-PassThru]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет New-SCSMUserRole создает роль пользователя в Service Manager.
Примеры
Пример 1. Создание роли пользователя со всеми доступами
PS C:\>New-SCSMUserRole -UserRoleType ActivityImplementer -DisplayName "Role for implementers" -User "WOODGROVE\Domain Admins"
Эта команда создает роль пользователя, которая имеет доступ ко всем пакетам управления, очередям, группам, задачам, представлениям и шаблонам. Члены роли пользователя — администраторы домена.
Пример 2. Создание роли только для чтения для форм и представлений
PS C:\>New-SCSMUserRole -UserRoleType ReadOnlyOperator -DisplayName "restricted role" -Group @() -Queue @() -Task @() -User "WOODGROVE\Patti Fuller"
Эта команда создает роль оператора только для чтения, которая имеет доступ только к формам и представлениям. Единственным членом новой роли является Патти Фуллер.
Параметры
-CatalogGroup
Указывает группы элементов каталога, доступные членам этой роли пользователя, чтобы ограничить доступ только к определенным группам элементов каталога. Элементы каталога в группах, которые не указаны, недоступны участникам этой роли.
Укажите все, чтобы разрешить доступ ко всем группам. Если значение не указано, группы элементов каталога недоступны.
Тип: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Class
Указывает экземпляры классов пакетов управления, к которым имеет доступ роль пользователя. Это применимо только к роли "Автор".
Тип: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ComputerName
Указывает имя компьютера, на котором выполняется служба доступа к данным System Center.
Учетная запись пользователя, указанная в параметре учетных данных
Тип: | System.String[] |
Position: | Named |
Default value: | Localhost |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Confirm
Запрашивает подтверждение перед запуском командлета.
Тип: | System.Management.Automation.SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Credential
Указывает учетные данные, которые этот командлет использует для подключения к серверу, на котором выполняется служба доступа к данным System Center. Указанная учетная запись пользователя должна иметь права доступа к серверу.
Тип: | System.Management.Automation.PSCredential |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Description
Указывает описание роли пользователя.
Тип: | System.String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DisplayName
Указывает имя роли пользователя.
Тип: | System.String |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-FormTemplate
Указывает шаблоны форм, доступные пользователям в этой роли пользователя. Формы, которые не указаны, недоступны для пользователей в этой роли. Укажите none, чтобы не было доступных шаблонов. Укажите все, чтобы сделать все шаблоны доступными.
Тип: | Microsoft.EnterpriseManagement.Configuration.ManagementPackObjectTemplate[] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Group
Указывает группы, доступные членам этой роли пользователя, для области доступа только к определенным группам элементов конфигурации. Элементы конфигурации в группах, которые не указаны, недоступны участникам этой роли. Укажите все, чтобы разрешить доступ ко всем группам. Если значение не указано, группы недоступны.
Тип: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-PassThru
Указывает, что этот командлет возвращает созданную им роль пользователя. Этот объект можно передать другим командлетам.
Тип: | System.Management.Automation.SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Queue
Указывает очереди, доступные членам этой роли пользователя, чтобы ограничить доступ только к определенным очередям рабочих элементов. Рабочие элементы в очередях, которые не указаны, недоступны участникам этой роли пользователя. Укажите все, чтобы разрешить доступ ко всем очередям. Если значение не указано, очереди недоступны.
Тип: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-SCSession
Указывает объект, представляющий сеанс на сервере управления Service Manager.
Тип: | Microsoft.SystemCenter.Core.Connection.Connection[] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Task
Указывает задачу консоли пакета управления.
Укажите этот параметр, только если свойство ManagementPack
Тип: | Microsoft.EnterpriseManagement.Configuration.ManagementPackConsoleTask[] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-User
Указывает пользователей, которые будут членами новой роли пользователя.
Тип: | System.String[] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-UserRoleType
Указывает тип создаваемой роли пользователя. Допустимые значения:
- ActivityImplementers
- Администраторы
- AdvancedOperator
- Авторы
- ChangeInitiator
- ChangeManagers
- EndUsers
- IncidentResolvers
- ПроблемыAnalysts
- ReadOnlyOperators
- Рабочие процессы
Тип: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.UserRoleTypeEnum |
Допустимые значения: | ActivityImplementer, AdvancedOperator, Author, ChangeInitiator, ChangeManager, EndUser, IncidentResolver, ProblemAnalyst, ReadOnlyOperator, ReleaseManager, ServiceRequestAnalyst |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-View
Указывает представления, доступные членам этой роли пользователя, чтобы ограничить доступ только к определенным представлениям. Представления, которые не указаны, недоступны участникам этой роли. Укажите все, чтобы разрешить доступ ко всем представлениям. Если значение не указано, представления недоступны.
Тип: | Microsoft.EnterpriseManagement.Configuration.ManagementPackView[] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.
Тип: | System.Management.Automation.SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Входные данные
None.
Входные данные в этот командлет невозможно передать.
Выходные данные
None.
Этот командлет не создает выходные данные.