Export-ActivityExplorerData
このコマンドレットは、セキュリティ & コンプライアンス PowerShell でのみ使用できます。 詳細については、「 セキュリティ & コンプライアンス PowerShell」を参照してください。
Export-ActivityExplorerData コマンドレットを使用して、Microsoft 365 Purview コンプライアンス ポータルのデータ分類>アクティビティ エクスプローラーからアクティビティをエクスポートします。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Export-ActivityExplorerData
-EndTime <DateTime>
-OutputFormat <String>
-StartTime <DateTime>
[-Filter1 <String[]>]
[-Filter2 <String[]>]
[-Filter3 <String[]>]
[-Filter4 <String[]>]
[-Filter5 <String[]>]
[-PageCookie <String>]
[-PageSize <Int32>]
[<CommonParameters>] 説明
セキュリティ & コンプライアンス PowerShell でこのコマンドレットを使用するには、アクセス許可を割り当てる必要があります。 詳細については、「Microsoft Purview コンプライアンス センターのアクセス許可」 を参照してください。
例
例 1
Export-ActivityExplorerData -StartTime "07/08/2022 07:15 AM" -EndTime "07/08/2022 11:08 AM" -PageSize 5000 -OutputFormat Json次の使用例は、指定した日付範囲の最大 5000 レコードを 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 になります。 新しいクエリで PageCookie パラメーターの値として Watermark プロパティの値を使用して、次のレコードセットを取得します。
例 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 パラメーターは、エクスポートするデータをフィルター処理します。 このパラメーターは、少なくとも 2 つの値を入力として受け取ります。フィルター名と少なくとも 1 つのフィルター値です。 たとえば、 @("Activity", "LabelApplied") アクティビティ値 LabelAppliedを持つレコードを返します。
同じパラメーターに複数のフィルター値を指定した場合、OR 動作が使用されます。 たとえば、 @("Activity", "LabelApplied", "LabelRemoved") アクティビティ値 LabelApplied または LabelRemovedを含むレコードを返します。
このパラメーターを他のフィルター パラメーターと共に使用する場合、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 ～ 5000 の整数です。 既定値は 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 |