Get-SCSMUserRole

Service Manager에 정의된 사용자 역할을 검색합니다.

Syntax

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>]

Description

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과 함께 사용하여 사용자를 사용자 역할에 추가할 수 있습니다.