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 не $Null. Значение All означает, что все элементы доступны, а значение None означает, что элементы недоступны.

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

Тип:

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.

Этот командлет не создает выходные данные.