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

[アーティクル]
10/01/2023

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

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

異なるキーワード (keyword)検索クエリの結果を比較するには、同じコンテンツの場所で実行します。
新しい検索を作成するときに大量のコンテンツの場所を再入力する必要をなくすために。
検索結果のサイズを小さくする。たとえば、返された検索結果が多すぎてエクスポートできない場合は、検索を複製してから、日付範囲に基づいて検索条件を追加し、検索結果の数を減らすことができます。

ヒント

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

スクリプト情報

Exchange Online PowerShell モジュールをインストールする必要があります。手順については、「Exchange Online PowerShell モジュールのインストールと保守」を参照してください。
このトピックで説明するスクリプトを実行するには、Microsoft Purview コンプライアンスポータルの電子情報開示マネージャー役割グループのメンバーである必要があります。
スクリプトには、最小限のエラー処理が含まれています。スクリプトの主な目的は、コンテンツ検索をすばやく複製する方法です。
スクリプトによって新しいコンテンツ検索が作成されますが、開始されません。
このスクリプトでは、複製するコンテンツ検索が電子情報開示ケースに関連付けられているかどうかを考慮します。検索がケースに関連付けられている場合、新しい検索も同じケースに関連付けられます。既存の検索がケースに関連付けられていない場合、新しい検索はMicrosoft Purview コンプライアンスポータルの [コンテンツ検索] ページに一覧表示されます。
このトピックで提供されるサンプルスクリプトは、Microsoft 標準サポートプログラムまたはサービスではサポートされていません。サンプルスクリプトは現状のまま提供され、いかなる保証も伴いません。さらに、Microsoft は、商品性、特定目的への適合性の黙示の保証を含む、一切の黙示の保証をいたしかねます。本サンプルスクリプトおよびドキュメントの使用または性能に起因するすべてのリスクは、お客様が負うものとします。サンプルスクリプトおよびドキュメントを使用したこと、または使用できなかったことに伴って生じるいかなる損害 (業務利益の損失、業務の中断、業務情報の損失、金銭上の損失、その他一切の損害) についても、Microsoft、Microsoft に帰属する作者、スクリプトの作成、製造、または納入に関与したその他のすべての人員は、いかなる場合も責めを負わないものとします。

手順 1: スクリプトを実行して検索を複製する

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

ユーザー資格情報 - スクリプトでは、資格情報を使用して Security & Compliance PowerShell に接続します。前に説明したように、スクリプトを実行するには、Microsoft Purview コンプライアンスポータルの電子情報開示マネージャー役割グループのメンバーである必要があります。
既存の検索の名前 - 複製するコンテンツ検索です。
作成される新しい検索の名前 - この値を空白のままにすると、複製する検索の名前に基づく新しい検索の名前がスクリプトによって作成されます。

検索を複製するには:

.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
}

セキュリティ/コンプライアンス PowerShell に接続します。同じ PowerShell ウィンドウで、スクリプトを保存したフォルダーに移動します。
スクリプトを実行します。例えば：
```
.\CloneSearch.ps1
```
スクリプトによってプロンプトが表示されたら、次の情報を入力します。各情報を入力し、 Enter キーを押します。
- 既存の検索の名前。
- 新しい検索の名前。
スクリプトによって新しいコンテンツ検索が作成されますが、開始されません。これにより、次の手順で検索を編集して実行できます。新しい検索のプロパティを表示するには、Get-ComplianceSearch コマンドレットを実行するか、新しい検索がケースに関連付けられているかどうかに応じて、Microsoft Purview コンプライアンスポータルのコンテンツ検索または電子情報開示ページに移動します。

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

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

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

スクリプト情報

手順 1: スクリプトを実行して検索を複製する

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

フィードバック

フィードバック

その他のリソース

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

スクリプト情報

手順 1: スクリプトを実行して検索を複製する

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

フィードバック

フィードバック

その他のリソース

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