Get-ComplianceSecurityFilter
このコマンドレットは、セキュリティ & コンプライアンス PowerShell でのみ機能します。 詳細については、「セキュリティ/コンプライアンス PowerShell」を参照してください。
Get-ComplianceSecurityFilter コマンドレットを使用して、Microsoft Purview コンプライアンス ポータル内のコンプライアンス セキュリティ フィルターを表示します。 これらのフィルターを使用すると、指定されたユーザーは、Microsoft 365 organization内のメールボックスと SharePoint または OneDrive サイトのサブセットのみを検索できます。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
Get-ComplianceSecurityFilter
[-Action <ComplianceSecurityFilterActionType>]
[-Confirm]
[-FilterName <String>]
[-User <String>]
[-WhatIf]
[<CommonParameters>]
説明
コンプライアンス セキュリティ フィルターは、Microsoft Purview コンプライアンス ポータル (*-ComplianceSearch コマンドレット) のコンプライアンス検索で機能しますが、Exchange Online (*-MailboxSearch コマンドレット) の In-Place 電子情報開示検索では動作しません。
セキュリティ/コンプライアンス PowerShell でこのコマンドレットを使用するには、アクセス許可が割り当てられている必要があります。 詳細については、「Microsoft Purview コンプライアンス センターのアクセス許可」 を参照してください。
例
例 1
Get-ComplianceSecurityFilter | Format-Table -Auto FilterName,Action
この例では、すべてのコンプライアンス セキュリティ フィルターの要約リストを返します。
例 2
Get-ComplianceSecurityFilter -FilterName "HR Filter"
この例では、HR Filter という名前のコンプライアンス セキュリティ フィルターに関する詳細情報を返します。
パラメーター
-Action
適用対象: Exchange Server 2016、Exchange Server 2019、Exchange Server SE、セキュリティ & コンプライアンス
アクション パラメーターは、フィルターが適用されている検索アクションのタイプで結果をフィルター処理します。 有効な値は次のとおりです。
- エクスポート: フィルターは、検索結果をエクスポートするとき、または電子情報開示プレミアムでの分析を準備するときに適用されます。
- プレビュー: 検索結果をプレビューするときにフィルターが適用されます。
- 消去: フィルターは検索結果を消去するときに適用されます。 アイテムの削除方法は、New-ComplianceSearchAction コマンドレットの PurgeType パラメーター値によって制御されます。 既定値は SoftDelete です。これは、削除済みアイテムの保持期間が期限切れになるまで、消去されたアイテムをユーザーが回復できることを意味します。
- 検索: 検索の実行時にフィルターが適用されます。
- Search: 検索を実行するときに、フィルターが適用されます。
パラメーターのプロパティ
| 型: | ComplianceSecurityFilterActionType |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
適用対象: Exchange Server 2016、Exchange Server 2019、Exchange Server SE、セキュリティ & コンプライアンス
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | Cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-FilterName
適用対象: Exchange Server 2016、Exchange Server 2019、Exchange Server SE、セキュリティ & コンプライアンス
FilterName パラメーターは、表示するコンプライアンス セキュリティ フィルターの名前を指定します。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-User
適用対象: Exchange Server 2016、Exchange Server 2019、Exchange Server SE、セキュリティ & コンプライアンス
User パラメーターは、検索にフィルターを適用するユーザーによって結果をフィルター処理します。 有効な値は次のとおりです。
- ユーザーのエイリアスまたは電子メール アドレス。
- 値 All。
- 役割グループの名前。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
WhatIf スイッチは、セキュリティ/コンプライアンス PowerShell では機能しません。
[WhatIf] スイッチは、何も変更を加えずにコマンドが実行する内容を表示します。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | wi |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。