次の方法で共有


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 パラメーターは、コマンド出力の 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