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 cmdlet 在 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"此命令创建一个只读操作员角色，该角色仅有权访问窗体和视图。 新角色中唯一的成员是 Patti Fuller。
参数
-CatalogGroup
指定此用户角色的成员可用的目录项组，以限定对特定目录项组的访问权限。 未指定的组中的目录项不适用于此角色的成员。
指定 All 以允许访问所有组。 如果未指定任何值，则没有任何目录项组可用。
| 类型: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Class
指定用户角色有权访问的管理包类的实例。 这仅适用于“作者”角色。
| 类型: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ComputerName
指定运行 System Center Data Access 服务的计算机的名称。 Credential 参数中指定的用户帐户必须具有对指定计算机的访问权限。
| 类型: | System.String[] |
| Position: | Named |
| 默认值: | Localhost |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Confirm
在运行 cmdlet 之前，提示你进行确认。
| 类型: | System.Management.Automation.SwitchParameter |
| 别名: | cf |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Credential
指定此 cmdlet 用于连接到运行 System Center Data Access 服务的服务器的凭据。 指定的用户帐户必须有权访问该服务器。
| 类型: | System.Management.Automation.PSCredential |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Description
指定用户角色的说明。
| 类型: | System.String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DisplayName
指定用户角色的名称。
| 类型: | System.String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-FormTemplate
指定此用户角色中可供用户使用的表单模板。 未指定窗体不适用于此角色中的用户。 指定“无”可使模板不可用。 指定 All 以使所有模板都可用。
| 类型: | Microsoft.EnterpriseManagement.Configuration.ManagementPackObjectTemplate[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Group
指定可用于此用户角色成员的组，以仅限定对特定配置项目组的访问权限。 未指定的组中的配置项目不适用于此角色的成员。 指定 All 以允许访问所有组。 如果未指定任何值，则没有可用的组。
| 类型: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PassThru
指示此 cmdlet 返回它创建的用户角色。 可以将此对象传递给其他 cmdlet。
| 类型: | System.Management.Automation.SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Queue
指定可用于此用户角色成员的队列，以限定对工作项特定队列的访问权限。 未指定的队列中的工作项不适用于此用户角色的成员。 指定 All 以允许访问所有队列。 如果未指定任何值，则没有可用的队列。
| 类型: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SCSession
指定一个对象，该对象表示与 Service Manager 管理服务器的会话。
| 类型: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Task
指定管理包控制台任务。 仅当未$Null ManagementPack 属性时，才指定此参数。 值 All 表示所有元素都可访问，值 None 表示不可访问任何元素。
| 类型: | Microsoft.EnterpriseManagement.Configuration.ManagementPackConsoleTask[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-User
指定将成为新用户角色成员的用户。
| 类型: | System.String[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-UserRoleType
指定要创建的用户角色的类型。 有效值为：
- ActivityImplementers
- 管理员
- AdvancedOperators
- 作者
- ChangeInitiators
- ChangeManagers
- EndUsers
- IncidentResolvers
- ProblemAnalysts
- ReadOnlyOperators
- 工作流
| 类型: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.UserRoleTypeEnum |
| 接受的值: | ActivityImplementer, AdvancedOperator, Author, ChangeInitiator, ChangeManager, EndUser, IncidentResolver, ProblemAnalyst, ReadOnlyOperator, ReleaseManager, ServiceRequestAnalyst |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-View
指定可用于此用户角色成员的视图，以限定对特定视图的访问权限。 未指定视图不适用于此角色的成员。 指定 All 以允许访问所有视图。 如果未指定任何值，则没有任何视图可用。
| 类型: | Microsoft.EnterpriseManagement.Configuration.ManagementPackView[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。
| 类型: | System.Management.Automation.SwitchParameter |
| 别名: | wi |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
None.
不能通过管道将输入传递给此 cmdlet。
输出
None.
此 cmdlet 不生成任何输出。