Get-SCSMUserRole
检索在 Service Manager 中定义的用户角色。
语法
Get-SCSMUserRole
[[-DisplayName] <String[]>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>] Get-SCSMUserRole
[-Id] <Guid[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>] Get-SCSMUserRole
[-Name] <String[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>] 说明
Get-SCSMUserRole cmdlet 检索Service Manager中定义的用户角色配置文件。 随后可以使用此列表将用户添加到用户角色配置文件之一。 （可选）可以提供正则表达式以搜索特定用户角色配置文件。
示例
示例 1：获取本地计算机的用户角色
PS C:\>Get-SCSMUserRole
Name Description LastModified LastModifiedBy
---- ----------- ------------ --------------
ChangeManagers The Service Manager Change... 6/14/2010 5:14:16 AM
IncidentResolvers The Service Manager Incide... 6/14/2010 5:14:16 AM
ActivityImplementers The Service Manager Activi... 6/14/2010 5:14:15 AM
Workflows The Service Manager Workfl... 6/14/2010 5:14:16 AM
Administrators The Service Manager Admini... 6/14/2010 5:14:16 AM
ProblemAnalysts The Service Manager Proble... 6/14/2010 5:14:16 AM
AdvancedOperators The Service Manager Advanc... 6/14/2010 5:14:16 AM
Authors The Service Manager Author... 6/14/2010 5:14:16 AM
ChangeInitiators The Service Manager Change... 6/14/2010 5:14:16 AM
ReadOnlyOperators The Service Manager Read-O... 6/14/2010 5:14:16 AM
EndUsers The Service Manager End Us... 6/14/2010 5:14:16 AM此命令从本地计算机检索用户角色的列表。
示例 2：获取管理员角色
PS C:\>Get-SCSMUserRole -Name "Administrators"
Name Description LastModified LastModifiedBy
---- ----------- ------------ --------------
Administrators The Service Manager Admini... 6/14/2010 5:14:16 AM此命令检索 Administrators 用户角色。
示例 3：显示角色的类
PS C:\>$Role = Get-SCSMUserRole -DisplayName "CustomRole"
PS C:\> $Role
DisplayName Description LastModified LastModifiedBy
----------- ----------- ------------ --------------
CustomRole Custom Description 8/6/2010 12:23:46 AM WOODGROVE\Administrator PS C:\>$Role.Classes
Abstract Name DisplayName
-------- ---- -----------
True Microsoft.SystemCenter.ServiceDesigner.Messaging.Storage Storage
True Microsoft.SystemCenter.ServiceDesigner.ServiceComponentGroup Distributed Application Component
False Microsoft.SystemCenter.StorageDevicesGroup Storage Devices Group
True Microsoft.SystemCenter.ServiceDesigner.WebApplication Line of Business Web Application
True Microsoft.SystemCenter.ConfigItemGroup All Groups
False System.WorkItem.Incident Incident
True Microsoft.SystemCenter.ServiceDesigner.Messaging Messaging
True Microsoft.SystemCenter.InstanceGroup All Instance Groups
True Microsoft.SystemCenter.ServiceDesigner.WebApplication.WebSiteGroup Web Application Web Sites
True Microsoft.SystemCenter.ServiceDesigner.WebApplication.DatabaseGroup Web Application Databases
True Microsoft.SystemCenter.ServiceDesigner.GenericService Blank
True Microsoft.SystemCenter.ServiceDesigner.Service User Created Distributed Application
False Microsoft.SystemCenter.BusinessService Business Service第一个命令获取名为 CustomRole 的用户角色，然后将其存储在 $Role 变量中。
第二个命令显示$Role的内容。
第三个命令显示$Role的类。
参数
-ComputerName
指定运行 System Center Data Access 服务的计算机的名称。 Credential 参数中指定的用户帐户必须具有对指定计算机的访问权限。
| Type: | System.String[] |
| Position: | Named |
| Default value: | Localhost |
| 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 |
-DisplayName
指定要检索的用户角色的显示名称。 可以指定正则表达式。
| Type: | System.String[] |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Id
指定要检索的用户角色的 ID。
| Type: | System.Guid[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
指定要检索的用户角色的名称。 可以指定正则表达式。
| Type: | System.String[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| 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 |
输入
System.String
可以通过管道将名称传递给 DisplayName 参数。
System.Guid
可以通过管道将 GUID 传递给 Id 参数。
输出
Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role
UserRole 对象提供有关Service Manager用户角色的信息。 此对象可与 Update-SCSMUserRole cmdlet 结合使用，将用户添加到用户角色。