Export-ContentExplorerData
이 cmdlet은 보안 및 준수 PowerShell에서만 사용할 수 있습니다. 자세한 내용은 보안 및 준수 PowerShell을 참조하세요.
Export-ContentExplorerData cmdlet을 사용하여 Microsoft Purview 규정 준수에서 데이터 분류 파일 세부 정보를 내보냅니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
구문
Default (기본값)
Export-ContentExplorerData
[-TagName] <String>
[-TagType] <String>
[-Aggregate]
[[-ConfidenceLevel] <String>]
[[-PageCookie] <String>]
[[-PageSize] <Int32>]
[[-SiteUrl] <String>]
[[-UserPrincipalName] <String>]
[[-Workload] <String>]
[<CommonParameters>]
Description
이 cmdlet의 출력에는 다음 정보가 포함됩니다.
- TotalCount: 집계 수입니다. TagName 및 TagType 매개 변수만 사용하는 경우 값은 해당 태그의 총 집계 수입니다. Workload 매개 변수도 사용되는 경우 값은 해당 태그에 대한 워크로드의 집계 수입니다. UserPrincipalName 또는 SiteUrl 매개 변수를 사용하는 경우 값은 해당 특정 폴더의 개수입니다.
- MorePagesAvailable: 내보낼 레코드가 더 있는지 여부를 표시합니다. 값은 True 또는 False입니다.
- RecordsReturned: 쿼리에서 반환된 레코드 수입니다.
- PageCookie: MorePagesAvailable이 True일 때 다음 레코드 집합을 가져오는 데 사용됩니다.
- 데이터 기록: 이 cmdlet의 출력은 배열입니다. 배열 항목 1부터 레코드 데이터가 포함됩니다.
다음 목록에서는 이 cmdlet을 사용하는 스크립트에 대한 모범 사례를 설명합니다.
단일 스크립트를 사용하여 여러 SID/레이블을 내보내지 않는 것이 좋습니다. 대신 한 SIT/Label에 대한 스크립트를 만든 다음 필요에 따라 각 워크로드의 각 SIT/Label에 대해 동일한 스크립트를 다시 사용합니다.
스크립트를 다시 시도할 때 먼저 세션에 다시 연결해야 합니다. 세션의 토큰은 약 1시간 후에 만료되어 cmdlet이 실패할 수 있습니다. 이 문제를 해결하려면 스크립트를 다시 시도하기 전에 세션에 다시 연결합니다. 스크립트가 실패하면 마지막으로 반환된 페이지 쿠키를 사용하여 다시 시작하여 중단된 위치에서 내보내기를 계속합니다.
팁
오랫동안 실행되는 무인 스크립트를 지원하려면 CBA(인증서 기반 인증)를 사용할 수 있습니다.
Azure 앱을 사용하려면 콘텐츠 Explorer 목록 뷰어의 역할 그룹을 서비스 주체 ID에 추가합니다.
이 cmdlet을 사용하려면 보안 및 준수 PowerShell에서 사용 권한을 할당받아야 합니다. 자세한 내용은 Microsoft Purview 규정 준수 포털의 사용 권한을 참조하세요.
예제
예 1
Export-ContentExplorerData -TagType SensitiveInformationType -TagName "Credit Card Number" -Workload EXO -UserPrincipalName erika@contoso.onmicrosoft.com
다음은 에리카의 사서함에서 지정한 중요한 정보 유형에 대한 레코드를 내보내는 예제입니다.
예 2
Export-ContentExplorerData -TagType SensitiveInformationType -TagName "Credit Card Number" -Workload ODB -SiteUrl https://contoso-my.sharepoint.com/personal/erika_contoso_onmicrosoft_com
다음은 에리카의 OneDrive 사이트에서 지정한 중요한 정보 유형에 대한 레코드를 내보내는 예제입니다.
예 3
Export-ContentExplorerData -TagType SensitiveInformationType -TagName "All Full Names"
예 4
$Report = @()
$Content = Export-ContentExplorerData -TagType SensitiveInformationType -TagName "All Full Names" -ConfidenceLevel high -Workload sharepoint -PageSize 1000
[string]$PageCookie = $Content.PageCookie
$Report += $Content[1..$Content[0].RecordsReturned]
while($PageCookie -notlike " * ")
{
$NewContent = Export-ContentExplorerData -TagType SensitiveInformationType -TagName "All Full Names" -ConfidenceLevel high -Workload sharepoint -PageCookie $PageCookie -PageSize 1000
[string]$PageCookie = $NewContent.PageCookie
$Report += $NewContent[1..$NewContent[0].RecordsReturned]
}
$Report | Export-CSV C:\temp\CE_Report-AFN_high.csv -Encoding UTF8 -NoTypeInformation
이 예제에서는 모든 워크로드에 대해 지정된 중요한 정보 유형에 대한 레코드를 내보냅니다.
매개 변수
-Aggregate
적용 가능: 보안 & 규정 준수
메모: 이 매개 변수는 현재 프라이빗 미리 보기에 있으며, 모든 조직에서 사용할 수 없으며 변경될 수 있습니다.
Aggregate 매개 변수 스위치는 항목 수준에서 세부 정보를 반환하는 대신 폴더 수준 집계 번호를 반환합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
이 스위치를 사용하면 내보내기 시간이 크게 줄어듭니다. 폴더의 항목을 다운로드하려면 특정 폴더에 대해 이 cmdlet을 실행합니다.
TagName, TagType 및 Workload 매개 변수와 함께 이 스위치를 사용하는 경우 명령은 다음 정보를 반환합니다.
- SharePoint 및 OneDrive: SiteUlrs 목록입니다.
- Exchange Online 및 Microsoft Teams: UPN 목록입니다.
- 관련 태그가 스탬프된 폴더의 항목 수입니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | False |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-ConfidenceLevel
적용 가능: 보안 & 규정 준수
ConfidenceLevel 매개 변수는 내보낼 파일 세부 정보에 대한 일치 항목의 신뢰도 수준을 지정합니다. 유효한 값은 다음과 같습니다.
- 낮다
- 보통
- 높다
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 허용되는 값: | high, medium, low |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 0 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-PageCookie
적용 가능: 보안 & 규정 준수
PageCookie 매개 변수는 명령 출력의 MorePagesAvailable 속성 값이 True일 때 더 많은 데이터를 가져올지 여부를 지정합니다. PageSize 매개 변수를 사용하지 않으면 최대 100개의 레코드가 반환됩니다. PageSize 매개 변수를 사용하는 경우 최대 1,0000개의 레코드를 반환할 수 있습니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 1 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-PageSize
적용 가능: 보안 & 규정 준수
PageSize 매개 변수는 단일 쿼리에서 반환할 최대 레코드 수를 지정합니다. 이 매개 변수에 대한 유효한 입력은 1에서 10000 사이의 정수입니다. 기본값은 100입니다.
참고: 파일이 거의 없는 빈 폴더 또는 폴더에서 이 매개 변수는 결과의 PageSize 횟수를 얻으려고 할 때 명령이 오랫동안 실행되도록 할 수 있습니다. 이 문제를 방지하기 위해 명령은 먼저 완료되는 5개의 폴더 또는 PageSize 매개 변수에 지정된 레코드의 수를 반환합니다. 예를 들어 각각 레코드가 1개인 폴더가 10개 있는 경우 명령은 상위 5개 폴더의 5개 레코드를 반환합니다. 페이지 쿠키를 사용한 다음 실행에서는 PageSize 값이 10인 경우에도 나머지 5개 폴더에서 5개의 레코드를 반환합니다.
매개 변수 속성
| 형식: | Int32 |
| Default value: | 0 |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 2 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-SiteUrl
적용 가능: 보안 & 규정 준수
SiteUrl 매개 변수는 파일 세부 정보를 내보낼 사이트 URL을 지정합니다.
SharePoint 및 OneDrive 워크로드에 이 매개 변수를 사용합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 3 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-TagName
적용 가능: 보안 & 규정 준수
TagName 매개 변수는 파일 세부 정보를 내보낼 레이블의 이름을 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표로 묶습니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 4 |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-TagType
적용 가능: 보안 & 규정 준수
TagType 매개 변수는 파일 세부 정보를 내보낼 레이블의 형식을 지정합니다. 유효한 값은 다음과 같습니다.
- 보존
- SensitiveInformationType
- Sensitivity
- TrainableClassifier
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 5 |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-UserPrincipalName
적용 가능: 보안 & 규정 준수
UserPrincipalName 매개 변수는 메시지 세부 정보를 내보낼 UPN 형식의 사용자 계정을 지정합니다. UPN 값의 예는 입니다 erika@contoso.onmicrosoft.com.
Exchange 및 Microsoft Teams 워크로드에 이 매개 변수를 사용합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 6 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Workload
적용 가능: 보안 & 규정 준수
Workload 매개 변수는 파일 세부 정보를 내보낼 위치를 지정합니다. 유효한 값은 다음과 같습니다.
- EXO 또는 Exchange
- ODB 또는 OneDrive
- SPO 또는 SharePoint
- Teams
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 7 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.