다음을 통해 공유

Check-PurviewConfig

모듈:
Exchange PowerShell

이 cmdlet은 보안 및 준수 PowerShell에서만 사용할 수 있습니다. 자세한 내용은 보안 및 준수 PowerShell을 참조하세요.

Check-PurviewConfig cmdlet을 사용하여 Microsoft Purview에서 organization 구성 설정의 유효성을 검사하고 검토합니다.

아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.

구문

Default (기본값) 

Check-PurviewConfig

    [[-Component] <PurviewConfigComponent>]
    [-Confirm]
    [[-DateTimeUTC] <String>]
    [[-DeviceName] <String>]
    [[-File] <String>]
    [[-FileAsBytes] <Byte[]>]
    [[-IncidentId] <String>]
    [[-ItemId] <String>]
    [[-MessageId] <String>]
    [[-PolicyName] <String>]
    [-RecipientAddress]
    [[-RecordId] <String>]
    [[-RuleName] <String>]
    [[-SenderAddress] <SmtpAddress>]
    [[-SharepointItemUniqueId] <String>]
    [[-SharepointSiteId] <String>]
    [[-SiteUrl] <String>]
    [[-SitIdentity] <String>]
    [[-TestCases] <String[]>]
    [[-Theme] <PurviewConfigTheme>]
    [[-UserPrincipalName] <SmtpAddress>]
    [-WhatIf]
    [[-Workload] <String>]
    [<CommonParameters>]

Description

Check-PurviewConfig cmdlet을 사용하여 organization 대한 Microsoft Information Protection 진단 테스트 사례를 실행하고 결과를 검사.

조직 구성 역할이 할당된 관리자는 이 cmdlet을 실행하는 데 필요한 권한이 있습니다.

Microsoft Entra ID의 관리자 역할 권한에 대한 자세한 내용은 역할 템플릿 ID를 참조하세요.

중요

Microsoft는 최소 권한 원칙을 강력히 옹호합니다. 계정에 작업을 수행하는 데 필요한 최소 권한만 할당하면 보안 위험을 줄이고 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

-DeviceName

적용 가능: 보안 & 규정 준수

{{ DeviceName 설명 채우기 }}

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:2
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-File

적용 가능: 보안 & 규정 준수

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:2
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-FileAsBytes

적용 가능: 보안 & 규정 준수

{{ Fill FileAsBytes description }}

매개 변수 속성

형식:

Byte[]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:4
필수: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

-PolicyName

적용 가능: 보안 & 규정 준수

{{ Fill PolicyName Description }}

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:8
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-RecipientAddress

적용 가능: 보안 & 규정 준수

{{ Fill RecipientAddress description }}

매개 변수 속성

형식:SmtpAddress
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:9
필수: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

-SenderAddress

적용 가능: 보안 & 규정 준수

{{ SenderAddress 설명 채우기 }}

매개 변수 속성

형식:SmtpAddress
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:12
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-SharepointItemUniqueId

적용 가능: 보안 & 규정 준수

{{ SharepointItemUniqueId 설명 }} 채우기

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:13
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-SharepointSiteId

적용 가능: 보안 & 규정 준수

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:14
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-SiteUrl

적용 가능: 보안 & 규정 준수

{{ Fill SiteUrl Description }}

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:15
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-SitIdentity

적용 가능: 보안 & 규정 준수

{{ Fill SitIdentity Description }}

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:16
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-TestCases

적용 가능: 보안 & 규정 준수

TestCases 매개 변수는 분석할 테스트 사례의 이름을 지정합니다. 사용 가능한 테스트 사례 및 해당 필수 매개 변수는 다음 목록에 설명되어 있습니다.

  • Encryption_EvaluationDetails: 전자 메일 암호화 평가 세부 정보의 유효성을 검사합니다. 다른 매개 변수는 필요하지 않습니다. 검사의 일부로 Test-IRMConfiguration cmdlet을 실행합니다.
  • Encryption_LicenseAvailability: 전자 메일 암호화 구성을 확인합니다. 다른 매개 변수는 필요하지 않습니다. Get-IRMConfiguration, Get-RMSTemplate, Get-TransportRule 및 Get-JournalRule cmdlet을 검사의 일부로 실행합니다.
  • MipLabels_EnabledEntities_ScopedLabels: 사용자에게 적용되는 레이블 및 레이블 설정을 표시합니다. UserPrincipalName 매개 변수가 필요합니다. 검사의 일부로 Get-Label 및 Get-LabelPolicy cmdlet을 실행합니다.
  • 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를 참조하세요.