다음을 통해 공유


Get-CMSecurityRole

보안 역할을 가져옵니다.

구문

Get-CMSecurityRole
   [-Name <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMSecurityRole
   -Id <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

이 cmdlet을 사용하여 Configuration Manager 사이트에서 하나 이상의 보안 역할을 가져옵니다. 보안 역할 및 권한에 대한 자세한 내용은 Configuration Manager에서 역할 기반 관리의 기본 사항을 참조하세요.

계정에 사이트에서 보안 역할을 볼 수 있는 권한이 없는 경우 이 cmdlet은 결과를 반환하지 않습니다.

참고

Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.

예제

예제 1: 모든 보안 역할 가져오기

이 예제에서는 사이트의 모든 역할 및 ID를 나열합니다.

Get-CMSecurityRole | Select-Object RoleID, RoleName

예제 2: 와일드카드를 사용하여 보안 역할 가져오기

이 명령은 앱으로 시작하는 이름이 있는 모든 보안 역할을 가져옵니다.

Get-CMSecurityRole -Name "App*"

예제 3: 모든 사용자 지정 보안 역할 나열

이 명령은 기본 제공되지 않는 모든 보안 역할을 반환합니다.

Get-CMSecurityRole | Where-Object { $_.IsBuiltIn -eq $false }

매개 변수

-DisableWildcardHandling

이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ForceWildcardHandling

이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Id

가져올 보안 역할의 ID를 지정합니다. 이 값은 속성입니다 RoleID (예: SMS000AROS 배포 관리자 역할).

형식:String
별칭:RoleId
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Name

가져올 보안 역할의 이름을 지정합니다.

형식:String
별칭:RoleName
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:True

입력

None

출력

IResultObject[]

IResultObject

참고

이 반환 개체 및 해당 속성에 대한 자세한 내용은 SMS_Role 서버 WMI 클래스를 참조하세요.