Clear-History

モジュール:

Microsoft.PowerShell.Core

PowerShell コマンド履歴からエントリを削除します。

構文

Clear-History
     [[-Id] <int[]>]
     [[-Count] <int>]
     [-Newest]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Clear-History
     [[-Count] <int>]
     [-CommandLine <string[]>]
     [-Newest]
     [-WhatIf]
     [-Confirm][<CommonParameters>]

説明

Clear-History は、PowerShell セッションからコマンド履歴を削除します。 各 PowerShell セッションには、独自のコマンド履歴があります。 コマンド履歴を表示するには、 コマンドレットを使用します Get-History 。

既定では、 Clear-History は PowerShell セッションからコマンド履歴全体を削除します。 でパラメーター Clear-History を使用して、選択したコマンドを削除できます。

Clear-History はコマンド履歴ファイルを PSReadLine クリアしません。 モジュールには PSReadLine 、すべての PowerShell セッションのすべての PowerShell コマンドを含む履歴ファイルが格納されます。 PowerShell プロンプトから、キーボードの上下の矢印を使用して、コマンド履歴をスクロールします。 コマンド履歴の構成を PSReadLine 表示するには、 を使用 Get-PSReadLineOptionします。 PSReadLine PowerShell 5.0 以降に付属しています。 詳細については、「 PSReadLine と about_PSReadLine」を参照してください。

例

例 1: PowerShell セッションからコマンド履歴を削除する

このコマンドは、PowerShell セッションの履歴からすべてのコマンドを削除します。

PS> Get-History

  Id CommandLine
  -- -----------
   1 Set-Location .\Test
   2 Update-Help
   3 Set-Location C:\Test\Logs
   4 Get-Location

PS> Clear-History

PS> Get-History

  Id CommandLine
  -- -----------
   5 Clear-History

コマンドレットは Get-History 、PowerShell セッションの履歴を表示します。 Clear-History は、コマンド履歴全体を削除します。 Get-History は、更新されたコマンド履歴を表示し、以前の履歴が削除されたことを確認します。

例 2: 最新のコマンドを削除する

このコマンドでは 、Count パラメーターと Newest パラメーターを使用して、PowerShell セッションの履歴から最新のコマンドを削除します。

PS> Get-History

  Id CommandLine
  -- -----------
   1 Set-Location C:\Test\
   2 Get-Command Clear-History
   3 Get-Command Clear-History -Syntax
   4 Get-Command Clear-History -ShowCommandInfo
   5 Get-Help Get-Alias
   6 Get-Command Get-ChildItem -Syntax
   7 Get-Help Clear-History
   8 Set-Location C:\Test\Logs
   9 Get-Help Get-Variable
  10 Get-Help Get-ChildItem

PS> Clear-History -Count 5 -Newest

PS> Get-History

  Id CommandLine
  -- -----------
   1 Set-Location C:\Test\
   2 Get-Command Clear-History
   3 Get-Command Clear-History -Syntax
   4 Get-Command Clear-History -ShowCommandInfo
   5 Get-Help Get-Alias
  11 Clear-History -Count 5 -Newest

コマンドレットは Get-History 、PowerShell セッションの履歴を表示します。 Clear-History は、コマンド履歴を削除するために使用されます。 Count パラメーターは、削除するコマンドの数 (指定した ID を含む) を指定します。Newest パラメーターは、最新のコマンドを履歴からクリアすることを指定します。 Get-History は、更新されたコマンド履歴を表示し、5 つの最新のコマンド (Id 6 - Id 10) が削除されたことを確認します。

例 3: 特定の条件に一致するコマンドを削除する

このコマンドは、 CommandLine パラメーターで定義されている特定の条件に一致するコマンドを削除します。

PS C:\Test> Get-History

  Id CommandLine
  -- -----------
   1 Set-Location C:\Test\
   2 Get-Command Clear-History
   3 Get-Command Clear-History -Syntax
   4 Get-Command Clear-History -ShowCommandInfo
   5 Get-Help Get-Alias
   6 Get-Command Get-ChildItem -Syntax
   7 Get-Help Clear-History

PS> Clear-History -CommandLine *Help*, *Syntax

PS> Get-History

  Id CommandLine
  -- -----------
   1 Set-Location C:\Test\
   2 Get-Command Clear-History
   4 Get-Command Clear-History -ShowCommandInfo
   8 Clear-History -CommandLine *Help*, *Syntax

コマンドレットは Get-History 、PowerShell セッションの履歴を表示します。 Clear-History コマンド履歴を削除します。 CommandLine パラメーターは、ヘルプを含むコマンド、または構文で終わるコマンドを指定します。 Get-History は、更新されたコマンド履歴を表示し、コマンド ID 3、 ID 5、 ID 6、および ID 7 が削除されたことを確認します。

例 4: ID 番号でコマンドを削除する

このコマンドは 、ID を使用して特定の履歴項目を削除します。複数のコマンドを削除するには、ID 番号のコンマ区切りのリスト を 送信します。

PS> Get-History

  Id CommandLine
  -- -----------
   1 Set-Location C:\Test\
   2 Get-History
   3 Get-Help Get-Alias
   4 Get-Command Clear-History
   5 Get-Command Clear-History -Syntax
   6 Get-Command Clear-History -ShowCommandInfo

PS C:\> Clear-History -Id 3, 5

PS> Get-History

  Id CommandLine
  -- -----------
   1 Set-Location C:\Test\
   2 Get-History
   4 Get-Command Clear-History
   6 Get-Command Clear-History -ShowCommandInfo
   7 Get-History
   8 Clear-History -Id 3, 5

コマンドレットは Get-History 、PowerShell セッションの履歴を表示します。 Clear-History コマンド履歴を削除します。 Id パラメーターは、削除するコマンドを指定します。 Get-History は、更新されたコマンド履歴を表示し、 ID 3 と ID 5 が削除されたことを確認します。

例 5: ID 番号とカウントでコマンドを削除する

このコマンドでは、 Id パラメーターと Count パラメーターを使用してコマンド履歴を削除します。 コマンドは、指定した ID から 逆の順序で削除されます。新しい順に、最も古いものに変更されます。

PS> Get-History

  Id CommandLine
  -- -----------
   1 Set-Location C:\Test\
   2 Get-Command Clear-History
   3 Get-Command Clear-History -Syntax
   4 Get-Command Clear-History -ShowCommandInfo
   5 Get-Help Get-Alias
   6 Get-Command Get-ChildItem -Syntax
   7 Get-Help Clear-History
   8 Set-Location C:\Test\Logs
   9 Get-Help Get-Variable
  10 Get-Help Get-ChildItem

PS> Clear-History -Id 7 -Count 5

PS> Get-History

  Id CommandLine
  -- -----------
   1 Set-Location C:\Test\
   2 Get-Command Clear-History
   8 Set-Location C:\Test\Logs
   9 Get-Help Get-Variable
  10 Get-Help Get-ChildItem
  11 Clear-History -Id 7 -Count 5

コマンドレットは Get-History 、PowerShell セッションの履歴を表示します。 Clear-History コマンド履歴を削除します。 Id パラメーターは、Id 7 で始まる を指定します。 Count パラメーターは、指定した ID を含む 5 つのコマンドを削除するように指定します。Get-Historyは、更新されたコマンド履歴を表示し、5 つのコマンド (Id 3 - ID 7) が削除されたことを確認します。

パラメーター

-CommandLine

PowerShell セッションからコマンド履歴を削除します。 文字列は、完全一致であるか、ワイルドカードを使用して によって Get-History表示される PowerShell セッション履歴のコマンドと一致する必要があります。 複数の文字列を入力すると、 Clear-History いずれかの文字列に一致するコマンドが削除されます。 CommandLine パラメーターは Count と共に使用できます。

スペースを含む文字列の場合は、単一引用符を使用します。 詳細については、「 about_Quoting_Rules」を参照してください。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます Clear-History 。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Count

削除する履歴エントリの数を Clear-History 指定します。 コマンドは、履歴の最も古いエントリから順に削除されます。

Count パラメーターと Id パラメーターは一緒に使用できます。 Count パラメーターは、削除するコマンドの数 (指定した ID を含む) を指定します。指定した ID から、コマンドは逆順に削除されます。 たとえば、 ID が 30 で Count が 10 の場合、 Clear-History アイテム 21 から 30 が削除されます。

Count パラメーターと CommandLine パラメーターを一緒に使用できます。 Count は、 CommandLine パラメーター値と一致する削除するコマンドの数を指定します。 コマンドは順番に削除されます。

Type:	Int
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

削除するコマンド履歴 ID をClear-History指定します。 ID 番号 を 表示するには、 コマンドレットを使用します Get-History 。 Id 番号はシーケンシャルであり、コマンドは PowerShell セッション全体で ID 番号を保持します。 Id パラメーターは、Count および Newest と共に使用できます。

Type:	Int[]
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Newest

Newest パラメーターを使用すると、Clear-History履歴の最新のエントリが削除されます。 既定では、 Clear-History 履歴の最も古いエントリが削除されます。

Newest パラメーターは、Id と Count と共に使用できます。 Count パラメーターは、削除するコマンドの数 (指定した ID を含む) を指定します。指定した ID から、コマンドは順番に削除されます。 たとえば、 ID が 30 で Count が 10 の場合、 Clear-History アイテム 30 から 39 が削除されます。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

コマンドレットが実行された場合の動作を Clear-History 示します。 このコマンドレットは実行されません。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

None

オブジェクトを に Clear-Historyパイプすることはできません。

出力

None

Clear-History は出力を生成しません。

メモ

PowerShell セッション履歴は、PowerShell セッション中に入力されたコマンドの一覧です。 履歴を表示し、コマンドを追加、削除できます。また履歴からコマンドを実行できます。 詳細については、「 about_History」を参照してください。

関連リンク

• about_History
• about_PSReadLine
• about_Quoting_Rules
• Add-History
• Get-History
• Get-PSReadLineOption
• Invoke-History
• PSReadLine
• Set-PSReadLineOption