Export-ActivityExplorerData
이 cmdlet은 보안 & 준수 PowerShell에서만 사용할 수 있습니다. 자세한 내용은 보안 & 준수 PowerShell을 참조하세요.
Export-ActivityExplorerData cmdlet을 사용하여 Microsoft 365 Purview 규정 준수 포털의 데이터 분류 > 작업 Explorer 활동을 내보냅니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
Syntax
Export-ActivityExplorerData
-EndTime <DateTime>
-OutputFormat <String>
-StartTime <DateTime>
[-Filter1 <String[]>]
[-Filter2 <String[]>]
[-Filter3 <String[]>]
[-Filter4 <String[]>]
[-Filter5 <String[]>]
[-PageCookie <String>]
[-PageSize <Int32>]
[<CommonParameters>]
Description
보안 & 준수 PowerShell에서 이 cmdlet을 사용하려면 권한이 할당되어야 합니다. 자세한 내용은 Microsoft Purview 규정 준수 포털의 사용 권한을 참조하세요.
예제
예 1
Export-ActivityExplorerData -StartTime "07/08/2022 07:15 AM" -EndTime "07/08/2022 11:08 AM" -PageSize 5000 -OutputFormat Json
이 예제에서는 지정된 날짜 범위에 대해 최대 5,000개의 레코드를 JSON 형식으로 내보냅니다.
예 2
Export-ActivityExplorerData -StartTime "07/08/2022 07:15 AM" -EndTime "07/08/2022 11:08 AM" -OutputFormat Json
이 예제에서는 지정된 날짜 범위에 대해 최대 100개의 레코드를 Json 형식으로 내보냅니다. 100개 이상의 레코드를 사용할 수 있는 경우 명령 출력의 LastPage 속성 값은 False가 됩니다. 새 쿼리에서 Watermark 속성 값을 PageCookie 매개 변수 값으로 사용하여 다음 레코드 집합을 가져옵니다.
예 3
Export-ActivityExplorerData -StartTime "07/08/2022 07:15 AM" -EndTime "07/08/2022 11:08 AM" -OutputFormat Json -PageCookie 'JZDRkpowAEV%2fZYfn6hIQCr4tCwEdoQWT4OalAyQVJEAKUtRO%2f31ZvM%2fnnjtz%2fyneTVb9HVUNV7bK91frVVM17cXaaputAV7eQuWbEmZFWbU8yham002jkqxqs0Y1V3xgq2lcqWA98eE6Dtq6EN3IMinX2WPs%2bbromllxLPpOiJ07990WAnraG8QvRV5Twfyoe3%2f7itOO00rCNvmJsfiDvOmKBbsyYNeFb7gUwzKsvYX0urPNHKpyLNNEdxxM4DUjyQWJ0mB%2bskMqdJ7KR3ojQ3pSuyk87VGcAoQacCUtxQWCQe6Rmk0LCLP9jsBWxETsKUkTF5%2fYiT3KmHvgB65hEAbFonxfyYPu0JoHSYhg0hUkGnJUlhG0jBRTk7el%2fgQPpe2H6YF8qDGgt%2bhBk7zxjNw9qxglkqCoi%2bOF7P0dl7CBAgOWRb74i5ubSC%2bJ%2bQG6eyxgE7XP7fAC6S9n3kjl7yOQPYb7KdYsIwJ2gC5n4%2bjZzvx2kA0lZ%2fHI%2b%2ft8uK5urM3Gtk1L%2bf8J'
이 예제는 100개가 넘는 레코드를 사용할 수 있었던 이전 예제와 관련이 있습니다(해당 명령의 LastPage 속성 값은 False임). 동일한 날짜 범위를 사용하지만 이번에는 이 명령의 PageCookie 매개 변수에 대한 이전 명령의 Watermark 속성 값을 사용하여 나머지 결과를 가져옵니다.
예 4
Export-ActivityExplorerData -StartTime "07/06/2022 07:15 AM" -EndTime "07/08/2022 11:08 AM" -Filter1 @("Activity", "FileArchived") -OutputFormat Csv
이 예제에서는 지정된 날짜 범위에 대해 최대 100개의 레코드를 CSV 형식으로 내보내고 작업 값 FileArchived로 출력을 필터링합니다.
예 5
Export-ActivityExplorerData -StartTime "07/06/2022 07:15 AM" -EndTime "07/08/2022 11:08 AM" -Filter1 @("Activity", "FileArchived", "ArchiveCreated") -OutputFormat Json
이 예제에서는 지정된 날짜 범위에 대해 최대 100개의 레코드를 JSON 형식으로 내보내고 작업 값 FileArchived 또는 ArchiveCreated로 출력을 필터링합니다.
예 6
Export-ActivityExplorerData -StartTime "07/06/2022 07:15 AM" -EndTime "07/08/2022 11:08 AM" -Filter1 @("Activity", "FileArchived", "ArchiveCreated") -Filter2 @("Workload","Endpoint") -OutputFormat Json
이 예제에서는 지정된 날짜 범위에 대해 최대 100개의 레코드를 JSON 형식으로 내보내고 FileArchived 또는 ArchiveCreated 작업에 대한 워크로드 값 Enpoint로 출력을 필터링합니다.
매개 변수
-EndTime
EndTime 매개 변수는 날짜 범위의 종료 날짜를 지정합니다.
명령이 실행되는 컴퓨터 구성에 설정된 국가별 옵션에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어 mm/dd/yyyy의 간단한 날짜 형식을 사용하도록 컴퓨터가 구성된 경우 09/01/2018를 입력하여 2018년 9월 1일을 지정할 수 있습니다. 날짜만 입력하거나 날짜와 시간을 입력할 수도 있습니다. 날짜와 시간을 입력하는 경우 큰따옴표(")로 값을 묶어야 합니다. 예: "09/01/2018 5:00 PM".
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Filter1
Filter1 매개 변수는 내보낼 데이터를 필터링합니다. 이 매개 변수는 최소 두 개의 값을 입력으로 사용합니다. 필터 이름과 필터 값은 하나 이상입니다. 예를 들어 는 @("Activity", "LabelApplied")
활동 값이 인 레코드를 반환합니다 LabelApplied
.
동일한 매개 변수에 대해 여러 필터 값을 지정하면 OR 동작이 사용됩니다. 예를 들어 는 @("Activity", "LabelApplied", "LabelRemoved")
활동 값 또는 LabelRemoved
가 있는 레코드를 반환합니다LabelApplied
.
다른 필터 매개 변수와 함께 이 매개 변수를 사용하는 경우 AND 동작은 매개 변수 간에 사용됩니다. 예를 들어:
-Filter1 @("Activity", "LabelApplied", "LabelRemoved") -Filter2 = @("Workload", "Exchange")
는 작업 값 LabelApplied
또는 LabelRemoved
워크로드에 대한 레코드를 반환합니다 Exchange
. 즉, ((Activity eq LabelApplied
) OR (Activity eq LabelRemoved
)) AND (Workload eq Exchange
).
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Filter2
Filter2 매개 변수는 내보낼 데이터를 필터링합니다. 이 매개 변수에는 Filter1 매개 변수와 동일한 구문 요구 사항, 동일한 매개 변수의 여러 값에 대해 동일한 OR 동작 및 여러 필터 매개 변수에 대한 동일한 AND 동작이 있습니다.
동일한 명령에서 Filter1 매개 변수를 사용하는 경우에만 이 매개 변수를 사용합니다.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Filter3
Filter3 매개 변수는 내보낼 데이터를 필터링합니다. 이 매개 변수에는 Filter1 매개 변수와 동일한 구문 요구 사항, 동일한 매개 변수의 여러 값에 대해 동일한 OR 동작 및 여러 필터 매개 변수에 대한 동일한 AND 동작이 있습니다.
동일한 명령에서 Filter2 및 Filter1 매개 변수를 사용하는 경우에만 이 매개 변수를 사용합니다.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Filter4
Filter4 매개 변수는 내보낼 데이터를 필터링합니다. 이 매개 변수에는 Filter1 매개 변수와 동일한 구문 요구 사항, 동일한 매개 변수의 여러 값에 대해 동일한 OR 동작 및 여러 필터 매개 변수에 대한 동일한 AND 동작이 있습니다.
동일한 명령에서 Filter3, Filter2 및 Filter1 매개 변수를 사용하는 경우에만 이 매개 변수를 사용합니다.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Filter5
Filter5 매개 변수는 내보낼 데이터를 필터링합니다. 이 매개 변수에는 Filter1 매개 변수와 동일한 구문 요구 사항, 동일한 매개 변수의 여러 값에 대해 동일한 OR 동작 및 여러 필터 매개 변수에 대한 동일한 AND 동작이 있습니다.
동일한 명령에서 Filter4, Filter3, Filter2 및 Filter1 매개 변수를 사용하는 경우에만 이 매개 변수를 사용합니다.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-OutputFormat
OutputFormat 매개 변수는 출력 형식을 지정합니다. 유효한 값은 다음과 같습니다.
- Csv
- Json
Type: | String |
Accepted values: | csv, json |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-PageCookie
PageCookie 매개 변수는 명령 출력의 LastPage 속성 값이 False일 때 더 많은 데이터를 가져올지 여부를 지정합니다. PageSize 매개 변수를 사용하지 않으면 최대 100개의 레코드가 반환됩니다. PageSize 매개 변수를 사용하는 경우 최대 5,000개의 레코드를 반환할 수 있습니다. 현재 명령에서 반환된 것보다 더 많은 레코드를 얻으려면 현재 명령의 출력에서 Watermark 속성 값을 동일한 날짜 범위와 필터가 있는 새 명령의 PageCookie 매개 변수 값으로 사용합니다.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-PageSize
PageSize 매개 변수는 페이지당 최대 항목 수를 지정합니다. 이 매개 변수에는 1에서 5,000 사이의 정수를 입력할 수 있습니다. 기본값은 100입니다.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-StartTime
StartTime 매개 변수는 날짜 범위의 시작 날짜를 지정합니다.
명령이 실행되는 컴퓨터 구성에 설정된 국가별 옵션에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어 mm/dd/yyyy의 간단한 날짜 형식을 사용하도록 컴퓨터가 구성된 경우 09/01/2018를 입력하여 2018년 9월 1일을 지정할 수 있습니다. 날짜만 입력하거나 날짜와 시간을 입력할 수도 있습니다. 날짜와 시간을 입력하는 경우 큰따옴표(")로 값을 묶어야 합니다. 예: "09/01/2018 5:00 PM".
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |