Export-ContentExplorerData

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

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

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

次の一覧は、このコマンドレットを使用するスクリプトのベスト プラクティスを示しています。

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

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

  ヒント

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

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

セキュリティ/コンプライアンス PowerShell でこのコマンドレットを使用するには、アクセス許可が割り当てられている必要があります。 詳細については、「Microsoft Purview コンプライアンス センターのアクセス許可」 を参照してください。

Export-ContentExplorerData -TagType SensitiveInformationType -TagName "Credit Card Number" -Workload EXO -UserPrincipalName erika@contoso.onmicrosoft.com

この例では、指定された機密情報の種類のレコードを Erika のメールボックスからエクスポートします。

Export-ContentExplorerData -TagType SensitiveInformationType -TagName "Credit Card Number" -Workload ODB -SiteUrl https://contoso-my.sharepoint.com/personal/erika_contoso_onmicrosoft_com

この例では、Erika の OneDrive サイトで指定された機密情報の種類に関するレコードをエクスポートします。

Export-ContentExplorerData -TagType SensitiveInformationType -TagName "All Full Names"

$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

この例では、すべてのワークロードの指定された機密情報の種類に関するレコードをエクスポートします。

このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。