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