Удаляет записи из журнала сеанса.

Синтаксис

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

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

Описание

Командлет Clear-History удаляет команды из журнала команд, т. е. из списка команд, введенных за время текущего сеанса.

При вызове без параметров командлет Clear-History удаляет из журнала сеанса все команды, однако для удаления определенных команд необходимо использовать параметры командлета Clear-History.

Параметры

-CommandLine <string[]>

Удаляет команды, содержащие заданные текстовые строки. При вводе нескольких строк командлет Clear-History удалит команды, содержащие любую из введенных строк.

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	true

-Count <int>

Удаляет указанное число записей, начиная с наиболее старой записи, зарегистрированной в журнале.

При использовании параметров Count и Id в одной команде командлет удалит количество записей, заданное параметром Count, начиная с записи, заданной параметром Id. Например, если Count =10, а Id = 30, командлет Clear-History удалит записи 21-30 включительно.

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

Обязательно?	false
Позиция?	2
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-Id <Int32[]>

Удаляет команды с указанными идентификаторами записи.

Чтобы определить идентификатор записи команды, используйте команду Get-History.

Обязательно?	false
Позиция?	1
Значение по умолчанию	нет
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-Newest

Удаляет последние записи из журнала сеанса. По умолчанию Clear-History удаляет из журнала сеанса наиболее старые записи.

Обязательно?	false
Позиция?	named
Значение по умолчанию	False
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-Confirm

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

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-WhatIf

Описывает, что произойдет при выполнении команды, без ее фактического выполнения.

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

<CommonParameters>

Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.

Ввод и вывод

Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.

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

None

Объекты невозможно передать командлету Clear-History по конвейеру.

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

None

Этот командлет не формирует никаких выходных данных.

Примечания

Журнал сеанса представляет собой список команд, введенных за время сеанса. Можно просматривать журнал, добавлять и удалять команды, а также выполнять команды, хранящиеся в журнале. Дополнительные сведения см. в разделе about_History.

Удаление команды из журнала не приводит к изменению идентификаторов остальных записей журнала команд.

Пример 1

C:\PS>clear-history

Описание
-----------
Удаляет все команды в журнале сеанса.

Пример 2

C:\PS>clear-history -id 23, 25

Описание
-----------
Удаляет команды с идентификаторами записи, равными 23 и 25.

Пример 3

C:\PS>clear-history -command *help*, *command

Описание
-----------
Удаляет команды, в которых содержится строка "help" или которые заканчиваются словом "command".

Пример 4

C:\PS>clear-history -count 10 -newest

Описание
-----------
Удаляет 10 последних команд из журнала.

Пример 5

C:\PS>clear-history -id 10 -count 3

Описание
-----------
Удаляет три наиболее старые команды, начиная с записи с идентификатором, равным 10.

Clear-History