Поделиться через

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 и выше. Дополнительные сведения см. в разделе about_PSReadLine.

Примеры

Пример 1. Удаление журнала команд из сеанса PowerShell

Эта команда удаляет все команды из журнала сеанса PowerShell.

Get-History

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

Clear-History
Get-History

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

Командлет Get-History отображает журнал сеанса PowerShell. Clear-History удаляет всю историю команд. Get-History отображает обновленную историю команд и подтверждает удаление предыдущей истории.

Пример 2. Удаление новых команд

Эта команда использует параметры Count и Newest для удаления новых команд из журнала сеанса PowerShell.

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

Clear-History -Count 5 -Newest
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 отображает обновленную историю команд и подтверждает, что были удалены пять самых новых команд, Id 6 - Id 10.

Пример 3. Удаление команд, соответствующих определенным критериям

Эта команда удаляет команды, соответствующие определенным критериям, определенным параметром commandLine .

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

Clear-History -CommandLine *Help*, *Syntax
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 указывает команды, содержащие Справка или заканчивающиеся на Syntax. Get-History отображает обновленную историю команд и подтверждает, что команды id 3, id 5, id 6и id 7 были удалены.

Пример 4. Удаление команд по номеру идентификатора

Эта команда удаляет определенные элементы журнала с помощью идентификатора. Чтобы удалить несколько команд, отправьте разделенный запятыми список чисел идентификатора.

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

Clear-History -Id 3, 5
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 отображает обновленную историю команд и подтверждает удаление идентификатора 3 и идентификатора 5.

Пример 5. Удаление команд по номеру и количеству идентификаторов

Эта команда использует идентификатора и параметры счетчика для удаления журнала команд. Команды удаляются из указанного Id в обратном порядке, от самых новых до самых старых.

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

Clear-History -Id 7 -Count 5
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 удаляет журнал команд. Параметр идентификатора указывает, что начинается с идентификатора 7. Параметр Count указывает удалить пять команд, включая указанный Id. Get-History отображает обновленную историю команд и подтверждает, что пять команд были удалены, Id 3 - Id 7.

Параметры

-CommandLine

Удаляет журнал команд из сеанса PowerShell. Строка должна точно совпадать или использовать подстановочные знаки для сопоставления команд в журнале сеансов PowerShell, отображаемого Get-History. Если ввести несколько строк, Clear-History удаляет команды, соответствующие любой из строк. Параметр commandLine можно использовать с count.

Для строк с пробелом используйте одинарные кавычки. Дополнительные сведения см. в about_Quoting_Rules.

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:True

-Confirm

Запрашивает подтверждение перед выполнением командлета Clear-History.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Count

Указывает количество записей журнала, которые Clear-History удаляет. Команды удаляются в порядке, начиная с самой старой записи в журнале.

Параметры count и id можно использовать вместе. Параметр Count указывает количество команд, которые необходимо удалить, включая указанный идентификатор Id. Начиная с указанного идентификатора Id, команды удаляются в обратном порядке. Например, если идентификатор равен 30, а число равно 10, Clear-History удаляет элементы с 21 по 30.

Параметры Count и CommandLine можно использовать вместе. Счетчик указывает количество команд для удаления, которые соответствуют значению параметра CommandLine. Команды удаляются в последовательном порядке.

Тип:Int32
Position:1
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Id

Указывает идентификатор журнала команд , который удаляется Clear-History. Чтобы отобразить номера Id , используйте командлет Get-History. Идентификаторы идут последовательно, и команды удерживают свой идентификатор в течение сеанса PowerShell. Параметр идентификатора можно использовать с счетчика и новейших.

Тип:Int32[]
Position:0
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Newest

Когда используется параметр Newest, Clear-History удаляет самые новые записи в журнале. По умолчанию Clear-History удаляет самые старые записи в журнале.

Параметр newest можно использовать с идентификатором и count. Параметр Count указывает количество команд, которые необходимо удалить, включительно с указанным идентификатором id. Начиная с указанного идентификаторакоманды удаляются последовательно. Например, если идентификатор равен 30, а счетчик равен 10, Clear-History удаляет элементы с 30 по 39.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет, если выполняется командлет Clear-History. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

None

Невозможно передать объекты в этот командлет.

Выходные данные

None

Этот командлет не возвращает выходные данные.

Примечания

PowerShell включает следующие псевдонимы для Clear-History:

  • Все платформы:
    • clhy

Журнал сеансов PowerShell — это список команд, введенных во время сеанса PowerShell. Вы можете просматривать журнал, добавлять и удалять команды, а также выполнять команды из журнала. Дополнительные сведения см. в разделе about_History.

Журнал сеансов управляется отдельно от журнала, поддерживаемого модулем PSReadLine. Обe истории доступны в тех сеансах, где загружен PSReadLine. Этот командлет работает только с историей сеансов. Дополнительные сведения см. в about_PSReadLine.