Get-ComplianceSecurityFilter

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

Get-ComplianceSecurityFilter コマンドレットを使用して、Microsoft Purview コンプライアンス ポータルのコンプライアンス セキュリティ フィルターを表示します。 これらのフィルターを使用すると、指定したユーザーは、Microsoft 365 organization内のメールボックスと SharePoint Online または OneDrive for Business サイトのサブセットのみを検索できます。

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

構文

Get-ComplianceSecurityFilter
   [-Action <ComplianceSecurityFilterActionType>]
   [-Confirm]
   [-FilterName <String>]
   [-User <String>]
   [-WhatIf]
   [<CommonParameters>]

説明

コンプライアンス セキュリティ フィルターは、Exchange Online (*-MailboxSearch コマンドレット) の電子情報開示検索In-Placeではなく、Microsoft Purview コンプライアンス ポータル (*-ComplianceSearch コマンドレット) のコンプライアンス検索で機能します。

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

例 1

Get-ComplianceSecurityFilter | Format-Table -Auto FilterName,Action

この例では、すべてのコンプライアンス セキュリティ フィルターの要約リストを返します。

例 2

Get-ComplianceSecurityFilter -FilterName "HR Filter"

この例では、HR Filter という名前のコンプライアンス セキュリティ フィルターに関する詳細情報を返します。

パラメーター

-Action

Action パラメーターは、フィルターが適用される検索アクションの種類によって結果をフィルター処理します。 有効な値は次のとおりです。

  • エクスポート: フィルターは、検索結果をエクスポートするとき、または電子情報開示 Premium で分析用に準備するときに適用されます。
  • プレビュー: 検索結果をプレビューするときにフィルターが適用されます。
  • 消去: フィルターは、検索結果を消去するときに適用されます。 項目の削除方法は、New-ComplianceSearchAction コマンドレットの PurgeType パラメーター値によって制御されます。 既定値は SoftDelete です。つまり、削除されたアイテムは、削除されたアイテムの保持期間の有効期限が切れるまでユーザーが回復できます。
  • 検索: 検索の実行時にフィルターが適用されます。
  • Search: 検索を実行するときに、フィルターが適用されます。
Type:ComplianceSecurityFilterActionType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-Confirm

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。

  • 破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
  • 他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-FilterName

FilterName パラメーターは、表示するコンプライアンス セキュリティ フィルターの名前を指定します。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-User

User パラメーターは、検索に適用されたフィルターを取得するユーザーによって結果をフィルター処理します。 有効な値は次のとおりです。

  • ユーザーのエイリアスまたは電子メール アドレス。
  • 値 All。
  • 役割グループの名前。
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-WhatIf

WhatIf スイッチは、セキュリティ & コンプライアンス PowerShell では機能しません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance