Clear-History
Удаляет записи из журнала команд 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 указывает количество удаляемых команд, включая указанный идентификатор. Параметр Newest указывает, что новейшие команды удаляются из журнала. Get-History
отображает обновленный журнал команд и подтверждает удаление пяти новых команд с идентификатором 6 - и идентификатором 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
отображает обновленный журнал команд и подтверждает удаление команд с идентификаторами 3, Идентификатором 5, Идентификатором 6 и Идентификатором 7 .
Пример 4. Удаление команд по идентификатору
Эта команда удаляет определенные элементы журнала с помощью идентификатора. Чтобы удалить несколько команд, отправьте разделенный запятыми список номеров идентификаторов .
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
отображает обновленный журнал команд и подтверждает удаление идентификаторов 3 и 5 .
Пример 5. Удаление команд по номеру идентификатора и количеству
Эта команда использует параметры Id и Count для удаления журнала команд. Команды удаляются из указанного идентификатора в обратном порядке, от новых к старым.
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 указывает, что значение начинается с идентификатора 7. Параметр Count указывает на удаление пяти команд, включая указанный идентификатор. Get-History
отображает обновленный журнал команд и подтверждает удаление пяти команд с идентификатором 3 - id 7.
Параметры
-CommandLine
Удаляет журнал команд из сеанса PowerShell. Строка должна иметь точное соответствие или использовать подстановочные знаки для сопоставления команд в журнале сеанса PowerShell, отображаемом .Get-History
Если ввести несколько строк, удаляет команды, 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 указывает количество удаляемых команд, включая указанный идентификатор. Начиная с указанного идентификатора команды удаляются в обратном последовательном порядке. Например, если идентификатор равен 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
Указывает идентификатор журнала команд, который Clear-History
удаляется. Чтобы отобразить номера идентификаторов , используйте Get-History
командлет . Номера идентификаторов являются последовательными, а команды сохраняют свой идентификатор на протяжении всего сеанса PowerShell. Параметр Id можно использовать с Count и Newest.
Type: | Int[] |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Newest
При использовании Clear-History
параметра Newest удаляет новейшие записи в журнале. По умолчанию Clear-History
удаляет самые старые записи в журнале.
Параметр Newest можно использовать с Идентификатором и Числом. Параметр Count указывает количество удаляемых команд, включая указанный идентификатор. Начиная с указанного идентификатора команды удаляются в последовательном порядке. Например, если идентификатор равен 30, а число — 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.