次の方法で共有


コンテンツ検索をコピーする

ヒント

新しい Microsoft Purview ポータルで電子情報開示 (プレビュー) を使用できるようになりました。 新しい電子情報開示エクスペリエンスの使用の詳細については、「電子 情報開示 (プレビュー)」を参照してください。

Microsoft 365 の Microsoft Purview コンプライアンス ポータルで、多くのメールボックスまたは SharePoint および OneDrive for Business サイトを検索するコンテンツ検索を作成するには、しばらく時間がかかる場合があります。 検索するサイトを指定すると、URL を誤って入力するとエラーが発生する可能性もあります。 これらの問題を回避するには、この記事の Windows PowerShell スクリプトを使用して、既存のコンテンツ検索をすばやく複製できます。 検索を複製すると、元の検索と同じプロパティ (コンテンツの場所や検索クエリなど) を含む新しい検索 (別の名前) が作成されます。 次に、キーワード クエリまたは日付範囲を変更して新しい検索を編集し、それを実行できます。

コンテンツ検索を複製する理由

  • 異なるキーワード検索クエリの結果を比較するには、同じコンテンツの場所でを実行します。

  • 新しい検索を作成するときに大量のコンテンツの場所を再入力する必要をなくすために。

  • 検索結果のサイズを小さくする。 たとえば、返された検索結果が多すぎてエクスポートできない場合は、検索を複製してから、日付範囲に基づいて検索条件を追加し、検索結果の数を減らすことができます。

ヒント

E5 のお客様でない場合は、90 日間の Microsoft Purview ソリューション試用版を使用して、Purview の追加機能が組織のデータ セキュリティとコンプライアンスのニーズの管理にどのように役立つかを確認してください。 Microsoft Purview コンプライアンス ポータルのトライアル ハブで今すぐ開始してください。 サインアップと試用期間の詳細については、こちらをご覧ください。

スクリプト情報

  • Exchange Online PowerShell モジュールをインストールする必要があります。 手順については、「 Exchange Online PowerShell モジュールのインストールと保守」を参照してください。

  • このトピックで説明するスクリプトを実行するには、Microsoft Purview コンプライアンス ポータルの電子情報開示マネージャー役割グループのメンバーである必要があります。

  • スクリプトには、最小限のエラー処理が含まれています。 スクリプトの主な目的は、コンテンツ検索をすばやく複製する方法です。

  • スクリプトによって新しいコンテンツ検索が作成されますが、開始されません。

  • このスクリプトでは、複製するコンテンツ検索が電子情報開示ケースに関連付けられているかどうかを考慮します。 検索がケースに関連付けられている場合、新しい検索も同じケースに関連付けられます。 既存の検索がケースに関連付けられていない場合、新しい検索は Microsoft Purview コンプライアンス ポータルの [コンテンツ検索 ] ページに一覧表示されます。

  • このトピックで提供されるサンプル スクリプトは、Microsoft 標準サポート プログラムまたはサービスではサポートされていません。 サンプル スクリプトは現状のまま提供され、いかなる保証も伴いません。 さらに、Microsoft は、商品性、特定目的への適合性の黙示の保証を含む、一切の黙示の保証をいたしかねます。 本サンプル スクリプトおよびドキュメントの使用または性能に起因するすべてのリスクは、お客様が負うものとします。 サンプル スクリプトおよびドキュメントを使用したこと、または使用できなかったことに伴って生じるいかなる損害 (業務利益の損失、業務の中断、業務情報の損失、金銭上の損失、その他一切の損害) についても、Microsoft、Microsoft に帰属する作者、スクリプトの作成、製造、または納入に関与したその他のすべての人員は、いかなる場合も責めを負わないものとします。

この手順のスクリプトでは、既存のコンテンツ検索を複製して新しいコンテンツ検索を作成します。 このスクリプトを実行すると、次の情報の入力を求められます。

  • ユーザー資格情報 - スクリプトでは、資格情報を使用して Security & Compliance PowerShell に接続します。 前に説明したように、スクリプトを実行するには、Microsoft Purview コンプライアンス ポータルの電子情報開示マネージャー役割グループのメンバーである必要があります。

  • 既存の検索の名前 - 複製するコンテンツ検索です。

  • 作成される新しい検索の名前 - この値を空白のままにすると、複製する検索の名前に基づく新しい検索の名前がスクリプトによって作成されます。

検索を複製するには:

  1. .ps1 のファイル名サフィックスを使用して、次のテキストを Windows PowerShell スクリプト ファイルに保存します。たとえば、 CloneSearch.ps1

    # This PowerShell script clones an existing content search in Microsoft Purview compliance.
    
    # Ask for the name of the search you want to clone
    $searchName = Read-Host 'Enter the name of the search that you want to clone'
    # Ask for the name of the new search
    $newSearchName = Read-Host 'Enter a name for the new search [leave blank to automatically generate a name]'
    $originalSearch = Get-ComplianceSearch $searchName -EA SilentlyContinue
    # Make sure we have a valid search before continuing
    if(!$originalSearch)
    {
        Write-Error "Couldn't find search: $searchName"
        return
    }
    $searchNameCounter = 1
    # Find a suitable name for the new search
    while(!$newSearchName)
    {
        $newSearchName = $originalSearch.Name + "_" + $searchNameCounter
        $tempSearch = Get-ComplianceSearch $newSearchName -EA SilentlyContinue
        if ($tempSearch)
        {
            $newSearchName = $null
            $searchNameCounter++
        }
    }
    $caseName
    # Determine if the search is part of a case; if so get the case name
    if ($originalSearch.CaseId)
    {
        $searchCase = Get-ComplianceCase $originalSearch.CaseId
        $caseName = $searchCase.Name
    }
    # Need to cast this value as a Boolean the old fashion way
    $allowNotFoundExchangeLocationsEnabled = $false
    if ($originalSearch.AllowNotFoundExchangeLocationsEnabled)
    {
        $allowNotFoundExchangeLocationsEnabled = $true
    }
    $newSearch = New-ComplianceSearch -Name $newSearchName -AllowNotFoundExchangeLocationsEnabled $allowNotFoundExchangeLocationsEnabled -Case $caseName -ContentMatchQuery $originalSearch.ContentMatchQuery -Description $originalSearch.Description -ExchangeLocation $originalSearch.ExchangeLocation -ExchangeLocationExclusion $originalSearch.ExchangeLocationExclusion -Language $originalSearch.Language -SharePointLocation $originalSearch.SharePointLocation -SharePointLocationExclusion $originalSearch.SharePointLocationExclusion -PublicFolderLocation $originalSearch.PublicFolderLocation
    if ($newSearch)
    {
        Write-Host $newSearch.Name "was successfully created" -ForegroundColor Yellow
    }
    
  2. セキュリティ/コンプライアンス PowerShell に接続します。 同じ PowerShell ウィンドウで、スクリプトを保存したフォルダーに移動します。

  3. スクリプトを実行します。例えば:

    .\CloneSearch.ps1
    
  4. スクリプトによってプロンプトが表示されたら、次の情報を入力します。 各情報を入力し、 Enter キーを押します。

    • 既存の検索の名前。
    • 新しい検索の名前。

    スクリプトによって新しいコンテンツ検索が作成されますが、開始されません。 これにより、次の手順で検索を編集して実行できます。 新しい検索のプロパティを表示するには、 Get-ComplianceSearch コマンドレットを実行するか、新しい検索がケースに関連付けられているかどうかに応じて、Microsoft Purview コンプライアンス ポータルの コンテンツ検索 または 電子情報開示 ページに移動します。

手順 2: Microsoft Purview コンプライアンス ポータルで複製された検索を編集して実行する

スクリプトを実行して既存のコンテンツ検索を複製した後、次の手順は Microsoft Purview コンプライアンス ポータルに移動して、新しい検索を編集して実行することです。 前述のように、キーワード検索クエリを変更し、検索条件を追加または削除することで、検索を編集できます。 詳しくは、次のトピックを参照してください。