New-SCSMUserRole
Создает новую роль пользователя в Service Manager.
Синтаксис
Default (по умолчанию)
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[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Class
Указывает экземпляры классов пакетов управления, к которым имеет доступ роль пользователя. Это применимо только к роли "Автор".
Свойства параметра
| Тип: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ComputerName
Указывает имя компьютера, на котором выполняется служба доступа к данным System Center.
Учетная запись пользователя, указанная в параметре учетных данных
Свойства параметра
| Тип: | System.String[] |
| Default value: | Localhost |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Запрашивает подтверждение перед запуском командлета.
Свойства параметра
| Тип: | System.Management.Automation.SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Credential
Указывает учетные данные, которые этот командлет использует для подключения к серверу, на котором выполняется служба доступа к данным System Center. Указанная учетная запись пользователя должна иметь права доступа к серверу.
Свойства параметра
| Тип: | System.Management.Automation.PSCredential |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Description
Указывает описание роли пользователя.
Свойства параметра
| Тип: | System.String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DisplayName
Указывает имя роли пользователя.
Свойства параметра
| Тип: | System.String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-FormTemplate
Указывает шаблоны форм, доступные пользователям в этой роли пользователя. Формы, которые не указаны, недоступны для пользователей в этой роли. Укажите none, чтобы не было доступных шаблонов. Укажите все, чтобы сделать все шаблоны доступными.
Свойства параметра
| Тип: | Microsoft.EnterpriseManagement.Configuration.ManagementPackObjectTemplate[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Group
Указывает группы, доступные членам этой роли пользователя, для области доступа только к определенным группам элементов конфигурации. Элементы конфигурации в группах, которые не указаны, недоступны участникам этой роли. Укажите все, чтобы разрешить доступ ко всем группам. Если значение не указано, группы недоступны.
Свойства параметра
| Тип: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PassThru
Указывает, что этот командлет возвращает созданную им роль пользователя. Этот объект можно передать другим командлетам.
Свойства параметра
| Тип: | System.Management.Automation.SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Queue
Указывает очереди, доступные членам этой роли пользователя, чтобы ограничить доступ только к определенным очередям рабочих элементов. Рабочие элементы в очередях, которые не указаны, недоступны участникам этой роли пользователя. Укажите все, чтобы разрешить доступ ко всем очередям. Если значение не указано, очереди недоступны.
Свойства параметра
| Тип: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SCSession
Указывает объект, представляющий сеанс на сервере управления Service Manager.
Свойства параметра
| Тип: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Task
Указывает задачу консоли пакета управления.
Укажите этот параметр, только если свойство ManagementPack
Свойства параметра
| Тип: | Microsoft.EnterpriseManagement.Configuration.ManagementPackConsoleTask[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-User
Указывает пользователей, которые будут членами новой роли пользователя.
Свойства параметра
| Тип: | System.String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-UserRoleType
Указывает тип создаваемой роли пользователя. Допустимые значения:
- ActivityImplementers
- Администраторы
- AdvancedOperator
- Авторы
- ChangeInitiator
- Менеджеры по изменениям
- Конечные пользователи
- Решатели инцидентов
- ПроблемыAnalysts
- ReadOnlyOperators (Операторы ReadOnly)
- Рабочие процессы
Свойства параметра
| Тип: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.UserRoleTypeEnum |
| Default value: | None |
| Допустимые значения: | ActivityImplementer, AdvancedOperator, Author, ChangeInitiator, ChangeManager, EndUser, IncidentResolver, ProblemAnalyst, ReadOnlyOperator, ReleaseManager, ServiceRequestAnalyst |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-View
Указывает представления, доступные членам этой роли пользователя, чтобы ограничить доступ только к определенным представлениям. Представления, которые не указаны, недоступны участникам этой роли. Укажите все, чтобы разрешить доступ ко всем представлениям. Если значение не указано, представления недоступны.
Свойства параметра
| Тип: | Microsoft.EnterpriseManagement.Configuration.ManagementPackView[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.
Свойства параметра
| Тип: | System.Management.Automation.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.
Входные данные
None.
Входные данные в этот командлет невозможно передать.
Выходные данные
None.
Этот командлет не создает выходные данные.