Check-PurviewConfig
이 cmdlet은 보안 및 준수 PowerShell에서만 사용할 수 있습니다. 자세한 내용은 보안 및 준수 PowerShell을 참조하세요.
Check-PurviewConfig cmdlet을 사용하여 Microsoft Purview에서 organization 구성 설정의 유효성을 검사하고 검토합니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
구문
Default (기본값)
Check-PurviewConfig
[[-Component] <PurviewConfigComponent>]
[[-DateTimeUTC] <String>]
[[-File] <String>]
[[-IncidentId] <String>]
[[-ItemId] <String>]
[[-MessageId] <String>]
[[-RecordId] <String>]
[[-RuleName] <String>]
[[-TestCases] <String[]>]
[[-Theme] <PurviewConfigTheme>]
[[-UserPrincipalName] <SmtpAddress>]
[[-Workload] <String>]
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Description
Check-PurviewConfig cmdlet을 사용하여 organization 대한 Microsoft Information Protection 진단 테스트 사례를 실행하고 결과를 검사.
조직 구성 역할이 할당된 관리자는 이 cmdlet을 실행하는 데 필요한 권한이 있습니다.
Microsoft Entra ID 관리자 역할 권한에 대한 자세한 내용은 역할 템플릿 ID를 참조하세요.
중요
사용 권한이 가장 적은 역할을 사용하는 것이 좋습니다. 사용 권한이 낮은 계정을 사용하면 organization 대한 보안을 개선하는 데 도움이 됩니다. 전역 관리자는 기존 역할을 사용할 수 없는 경우 긴급 시나리오로 제한해야 하는 매우 권한이 높은 역할입니다.
예제
예 1
Check-PurviewConfig
이 예제에서는 추가 매개 변수가 필요하지 않은 모든 Microsoft Information Protection 테스트 사례를 실행합니다.
예 2
Check-PurviewConfig -Component Encryption
이 예제에서는 암호화 구성 요소에 대한 모든 테스트 사례를 실행합니다.
예 3
Check-PurviewConfig -Component Encryption -Theme LicenseAvailability
이 예제에서는 암호화 구성 요소에서 LicenseAvailability 테마에 대한 모든 사례를 실행합니다.
예 4
Check-PurviewConfig -TestCases "MipLabels_EnabledEntities_ScopedLabels" -UserPrincipalName sathya@contoso.onmicrosoft.com
이 예제에서는 userPrincipalName 값이 필요한 MipLabels_EnabledEntities_ScopedLabels 라는 테스트 사례를 실행합니다.
예 5
Check-PurviewConfig -TestCases "MipLabels_EnabledEntities_ScopedLabels","MipLabels_EnabledEntities_CompareSyncStatus" -UserPrincipalName sathya@contoso.onmicrosoft.com
이 예제에서는 지정된 테스트 사례를 실행합니다. MipLabels_EnabledEntities_ScopedLabels 테스트 사례에는 UserPrincipalName 값이 필요합니다.
매개 변수
-Component
적용 가능: 보안 & 규정 준수
Component 매개 변수는 테스트 사례에서 분석할 구성 요소를 지정합니다. 유효한 값은 다음과 같습니다.
- DLP
- DLPAlerts
- 암호화
- MIPLabels
매개 변수 속성
| 형식: | PurviewConfigComponent |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 0 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Confirm
적용 가능: 보안 & 규정 준수
Confirm 스위치는 확인 메시지를 표시할지 여부를 지정합니다. 진행하기 전에 cmdlet이 확인을 요구하는지에 따라 이 스위치가 cmdlet에 미치는 영향이 달라집니다.
- 파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 일시 중지 기능이 기본 제공되어 있습니다. 이러한 cmdlet의 경우 정확한 구문
-Confirm:$false를 사용하여 확인 메시지를 건너뛸 수 있습니다. - 대부분 다른 cmdlets에는 (예:, New-* and Set-* cmdlets) 중단 기능이 기본 제공되지 않습니다. 이러한 cmdlet의 경우 값 없이 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | cf(cf) |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-DateTimeUTC
적용 가능: 보안 & 규정 준수
DateTimeUTC는 UTC(협정 세계시)에서 테스트 사례의 날짜 시간을 지정합니다. 예를 들어 "2025-06-05 14:30:00"입니다.
이 매개 변수는 다음 TestCases 값에 필요합니다.
- DlpAlerts_CheckAlertsCreated
- DlpAlerts_FindAlertForActivity
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 1 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-File
적용 가능: 보안 & 규정 준수
이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 2 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-IncidentId
적용 가능: 보안 & 규정 준수
IncidentId 매개 변수는 테스트 사례에서 분석할 인시던트 를 지정합니다.
IncidentId 속성의 DLPRuleMatch 작업으로 필터링된 감사 로그 검색에서 이 매개 변수의 값을 찾을 수 있습니다.
이 매개 변수는 TestCases 값 DlpAlerts_FindAlertForActivity 필요합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 3 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-ItemId
적용 가능: 보안 & 규정 준수
이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 4 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-MessageId
적용 가능: 보안 & 규정 준수
이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 5 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-RecordId
적용 가능: 보안 & 규정 준수
RuleName 매개 변수는 테스트 사례에서 분석할 레코드를 지정합니다.
RecordId 속성의 활동 유형 DLPRuleMatch로 필터링된 Explorer 활동에서 이 매개 변수에 대한 값을 찾을 수 있습니다.
이 매개 변수는 TestCases 값 DlpAlerts_FindAlertForActivity 선택 사항입니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 6 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-RuleName
적용 가능: 보안 & 규정 준수
RuleName 매개 변수는 테스트 사례에서 분석할 DLP 규칙을 지정합니다.
이 매개 변수는 TestCases 값 DlpAlerts_CheckAlertsCreated 선택 사항입니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 7 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-TestCases
적용 가능: 보안 & 규정 준수
TestCases 매개 변수는 분석할 테스트 사례의 이름을 지정합니다. 사용 가능한 테스트 사례 및 해당 필수 매개 변수는 다음 목록에 설명되어 있습니다.
- Encryption_EvaluationDetails: 전자 메일 암호화 평가 세부 정보의 유효성을 검사합니다. 다른 매개 변수는 필요하지 않습니다.
- Encryption_LicenseAvailability: 전자 메일 암호화 구성을 확인합니다. 다른 매개 변수는 필요하지 않습니다.
- MipLabels_EnabledEntities_ScopedLabels: 사용자에게 적용되는 레이블 및 레이블 설정을 표시합니다. UserPrincipalName 매개 변수가 필요합니다.
- MipLabels_LicenseAvailability: MIP 레이블 기능이 사용하도록 설정되어 있는지 확인합니다. 다른 매개 변수는 필요하지 않습니다.
- DlpAlerts_CheckAlertsCreated: 지난 5일 동안 생성된 경고에 대한 DLP 규칙 구성의 유효성을 검사합니다. DateTimeUTC 매개 변수가 필요합니다. RuleName 매개 변수는 선택 사항입니다.
- DlpAlerts_FindAlertForActivity: 활동에 대한 누락된 경고를 식별합니다. DateTimeUTC 매개 변수가 필요합니다. IncidentId 및 RecordId 매개 변수는 선택 사항입니다.
- DLP_ScopedEntities: 사용자 또는 사이트에 적용되는 모든 DLP 정책 및 규칙을 반환합니다. Workload 매개 변수가 필요합니다. SiteUrl 및 UserPrincipalName 매개 변수는 선택 사항입니다.
쉼표로 구분하여 여러 값을 지정할 수 있습니다.
매개 변수 속성
| 형식: | String[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 8 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Theme
적용 가능: 보안 & 규정 준수
Theme 매개 변수 필터는 테스트 사례에서 분석할 필터를 지정합니다. 유효한 값은 다음과 같습니다.
- EnabledEntities
- EvaluationDetails
- LicenseAvailability
매개 변수 속성
| 형식: | PurviewConfigTheme |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 9 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-UserPrincipalName
적용 가능: 보안 & 규정 준수
UserPrincipalName 매개 변수는 테스트 사례에서 분석할 사용자 계정을 지정합니다(예: sathya@contoso.onmicrosoft.com).
- TestCases 값 MipLabels_EnabledEntities_ScopedLabels 필요합니다.
- TestCases 값 DLP_ScopedEntities 선택 사항입니다.
매개 변수 속성
| 형식: | SmtpAddress |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 10 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-WhatIf
적용 가능: 보안 & 규정 준수
WhatIf 스위치는 보안 및 준수 PowerShell에서 작동하지 않습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | 위스콘신 |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Workload
적용 가능: 보안 & 규정 준수
Workload 매개 변수는 서비스 워크로드를 지정합니다. 값 값은 다음과 같습니다.
- EndpointDevices
- Exchange
- OneDriveForBusiness
- SharePoint
- Teams
이 매개 변수는 TestCases 값 DLP_ScopedEntities 필요합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 11 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.