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