HOME > History系コマンドレット > Clear-History
Clear-History
Clear-Historyは、履歴をクリアするコマンドです。
エイリアスclhy
解説
PowerShellセッションからコマンド履歴を削除します。
条件を指定して削除する対象を絞ることも可能です。
構文
- （構文）
- Clear-History [[-Id] <int[]>] [[-Count] <int>] [<CommonParameters>] Clear-History [[-Count] <int>] [<CommonParameters>]
| パラメータ | 説明 |
|---|---|
| -Id 履歴ID | 履歴IDを指定してクリアする ※複数のIDをカンマ区切りで指定可 （例）Clear-History -Id 3,5 |
| -CommandLine パターン | 特定の文字列パターンに一致するコマンドを削除する ※ワイルドカードも使用可 （例）Clear-History -CommandLine *Get-* |
| -Count 件数 | 削除する履歴エントリの数を指定する （最も古いエントリから順に削除される） （例）Clear-History -Count 5 |
| -Newest | 最新のエントリからクリアする （例）Clear-History -Count 5 -Newest |
| -WhatIf | 実行はせずに実行結果の確認のみ行う |
| -Confirm | 実行前に確認メッセージの表示を行う |
共通的なパラメータは「共通パラメータ」をご覧ください。
サンプル
すべての履歴を削除する
Clear-History
IDが3と5の履歴を削除する
Clear-History -Id 3, 5
Getで始まるコマンド履歴をすべて削除する
Clear-History -CommandLine *Get-*
最も古い履歴を5件削除する
Clear-History -Count 5
最新の履歴を5件削除する
Clear-History -Count 5 -Newest
コマンドのヘルプを表示する
Get-Help Clear-History
備考
- Clear-HistoryはPowerShellセッションの履歴のみを対象とするため、PSReadLineモジュールの永続的な履歴ファイルには影響しません。
関連項目
- History系コマンドレット
- Get-History：履歴を取得する
- Clear-History：履歴をクリアする
- Add-History：履歴を追加する
- Invoke-History：履歴を実行する
