Get-SCSMUserRole

参考

模块:: System.Center.Service.Manager

检索 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

此命令检索管理员用户角色。

示例 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 参数中指定的用户帐户必须具有对指定计算机的访问权限。

类型:	System.String[]
Position:	Named
默认值:	Localhost
必需:	False
接受管道输入:	False
接受通配符:	False

-Credential

指定此 cmdlet 用于连接到运行 System Center Data Access 服务的服务器的凭据。指定的用户帐户必须有权访问该服务器。

类型:	System.Management.Automation.PSCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisplayName

指定要检索的用户角色的显示名称。可以指定正则表达式。

类型:	System.String[]
Position:	0
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-Id

指定要检索的用户角色的 ID。

类型:	System.Guid[]
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Name

指定要检索的用户角色的名称。可以指定正则表达式。

类型:	System.String[]
Position:	0
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-SCSession

指定一个对象，该对象表示与 Service Manager 管理服务器的会话。

类型:	Microsoft.SystemCenter.Core.Connection.Connection[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

System.String

可以通过管道将名称传递给 DisplayName 参数。

System.Guid

可以通过管道将 GUID 传递给 Id 参数。

输出

Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role

UserRole 对象提供有关 Service Manager 用户角色的信息。此对象可与 Update-SCSMUserRole cmdlet 结合使用，将用户添加到用户角色。

通过