次の方法で共有

Export-ContentExplorerData

モジュール:
ExchangePowerShell
適用対象:
Security & Compliance

注: このコマンドレットは現在プレビュー段階であり、変更される可能性があります。

このコマンドレットは、セキュリティ/コンプライアンス PowerShell でのみ使用できます。 詳細については、「セキュリティ/コンプライアンス PowerShell」を参照してください。

Export-ContentExplorerData コマンドレットを使用して、Microsoft Purview コンプライアンスでデータ分類ファイルの詳細をエクスポートします。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

Export-ContentExplorerData
      [-TagName] <String>
      [-TagType] <String>
      [-Aggregate]
      [[-ConfidenceLevel] <String>]
      [[-PageCookie] <String>]
      [[-PageSize] <Int32>]
      [[-SiteUrl] <String>]
      [[-UserPrincipalName] <String>]
      [[-Workload] <String>]
      [<CommonParameters>]

説明

このコマンドレットの出力には、次の情報が含まれています。

  • TotalCount: 集計カウント。 TagName パラメーターと TagType パラメーターのみを使用する場合、値はそのタグの集計カウントの合計です。 Workload パラメーターも使用する場合、値はそのタグのワークロード内の集計カウントです。 UserPrincipalName パラメーターまたは SiteUrl パラメーターを使用する場合、値はその特定のフォルダーのカウントです。
  • MorePagesAvailable: エクスポートするレコードが残っているかどうかを示します。 値は True または False です。
  • RecordsReturned: クエリで返されるレコードの数。
  • PageCookie: MorePagesAvailable が True の場合に、次のレコード セットを取得するために使用されます。

次の一覧では、このコマンドレットを使用したスクリプトのベスト プラクティスについて説明します。

  • 1 つのスクリプトを使用して複数の SID/ラベルをエクスポートしないことをお勧めします。 代わりに、1 つの SIT/Label 用のスクリプトを作成し、必要に応じて各ワークロードの SIT/Label ごとに同じスクリプトを再利用します。

  • スクリプトを再試行するときは、まずセッションに再接続してください。 セッションのトークンは約 1 時間後に期限切れになり、コマンドレットが失敗する可能性があります。 この問題を解決するには、スクリプトを再試行する前にセッションに再接続します。 スクリプトが失敗した場合は、最後に返されたページ Cookie を使用して再起動し、中断した場所からエクスポートを続行します。

    ヒント

    長時間実行される無人スクリプトをサポートするには、 証明書ベースの認証 (CBA) を使用します。

    Azure アプリを使用するには、コンテンツ エクスプローラー リスト ビューアーの役割グループをサービス プリンシパル ID に追加します。

セキュリティ/コンプライアンス 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"

次の使用例は、すべてのワークロードについて、指定した機密情報の種類のレコードをエクスポートします。

パラメーター

-Aggregate

適用対象: セキュリティ & コンプライアンス

手記： このパラメーターは現在プライベート プレビュー段階であり、すべての組織で使用できるわけではありません。変更される可能性があります。

Aggregate パラメーター スイッチは、アイテム レベルで詳細を返すのではなく、フォルダー レベルの集計された数値を返します。 このスイッチで値を指定する必要はありません。

このスイッチを使用すると、エクスポート時間が大幅に短縮されます。 フォルダー内の項目をダウンロードするには、特定のフォルダーに対してこのコマンドレットを実行します。

このスイッチを TagName、TagType、およびワークロード パラメーターと共に使用すると、コマンドは次の情報を返します。

  • SharePoint と OneDrive: SiteUlrs の一覧。
  • Exchange OnlineとMicrosoft Teams: UPN の一覧。
  • 関連するタグがスタンプされたフォルダー内のアイテムの数。
型:SwitchParameter
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ConfidenceLevel

適用対象: セキュリティ & コンプライアンス

ConfidenceLevel パラメーターは、エクスポートするファイルの詳細に一致する信頼度レベルを指定します。 有効な値は次のとおりです。

  • 低い
  • medium
  • 高い
型:String
指定可能な値:high, medium, low
配置:0
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PageCookie

適用対象: セキュリティ & コンプライアンス

PageCookie パラメーターは、コマンド出力の MorePagesAvailable プロパティの値が True の場合に、より多くのデータを取得するかどうかを指定します。 PageSize パラメーターを使用しない場合は、最大 100 個のレコードが返されます。 PageSize パラメーターを使用する場合は、最大 1,0000 個のレコードを返すことができます。

型:String
配置:1
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PageSize

適用対象: セキュリティ & コンプライアンス

PageSize パラメーターは、1 つのクエリで返されるレコードの最大数を指定します。 このパラメーターの有効な入力は、1 から 10000 までの整数です。 既定値は 100 です。

注: ファイルが少ない空のフォルダーまたはフォルダーでは、このパラメーターを使用すると、結果の PageSize カウントを取得しようとしたときに、コマンドが長時間実行される可能性があります。 この問題を回避するために、コマンドは、5 つのフォルダーまたは PageSize パラメーターで指定されたレコード数のいずれか早い方からデータを返します。 たとえば、10 個のフォルダーがあり、それぞれ 1 つのレコードがある場合、コマンドは上位 5 つのフォルダーの 5 つのレコードを返します。 ページ Cookie を使用した次の実行では、PageSize 値が 10 の場合でも、残りの 5 つのフォルダーから 5 つのレコードが返されます。

型:Int32
配置:2
規定値:0
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SiteUrl

適用対象: セキュリティ & コンプライアンス

SiteUrl パラメーターは、ファイルの詳細をエクスポートするサイト URL を指定します。

このパラメーターは、SharePoint ワークロードと OneDrive ワークロードに使用します。

型:String
配置:3
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-TagName

適用対象: セキュリティ & コンプライアンス

TagName パラメーターは、ファイルの詳細をエクスポートするラベルの名前を指定します。 値にスペースが含まれている場合は、値を引用符で囲んでください。

型:String
配置:4
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-TagType

適用対象: セキュリティ & コンプライアンス

TagType パラメーターは、ファイルの詳細をエクスポートするラベルの種類を指定します。 有効な値は次のとおりです。

  • 保持
  • SensitiveInformationType
  • Sensitivity
  • TrainableClassifier
型:String
配置:5
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-UserPrincipalName

適用対象: セキュリティ & コンプライアンス

UserPrincipalName パラメーターは、メッセージの詳細をエクスポートするユーザー アカウントを UPN 形式で指定します。 UPN 値の例が erika@contoso.onmicrosoft.com。

このパラメーターは、Exchange ワークロードとMicrosoft Teams ワークロードに使用します。

型:String
配置:6
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Workload

適用対象: セキュリティ & コンプライアンス

Workload パラメーターは、ファイルの詳細をエクスポートする場所を指定します。 有効な値は次のとおりです。

  • EXO または Exchange
  • ODB または OneDrive
  • SPO または SharePoint
  • Teams
型:String
配置:7
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False