Clear-History (Microsoft.PowerShell.Core)

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 cmdlet

ตามค่าเริ่มต้น 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 cmdlet แสดงประวัติของเซสชัน PowerShell Clear-History จะลบประวัติคำสั่งทั้งหมด Get-History แสดงประวัติคำสั่งที่อัปเดตและยืนยันว่าประวัติก่อนหน้าถูกลบไปแล้ว

ตัวอย่างที่ 2: ลบคำสั่งใหม่ล่าสุด

คำสั่งนี้ใช้พารามิเตอร์ นับ และ ใหม่ล่าสุด เพื่อลบคำสั่งใหม่ล่าสุดออกจากประวัติของเซสชัน 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 cmdlet แสดงประวัติของเซสชัน PowerShell Clear-History ใช้เพื่อลบประวัติคำสั่ง พารามิเตอร์ นับ ระบุจำนวนคำสั่งที่จะลบ รวมถึง Id ที่ระบุ พารามิเตอร์ ใหม่ล่าสุด ระบุว่าคำสั่งใหม่ล่าสุดจะถูกล้างออกจากประวัติ 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 cmdlet แสดงประวัติของเซสชัน PowerShell Clear-History ลบประวัติคำสั่ง พารามิเตอร์ CommandLine ระบุคำสั่งที่มี Help หรือลงท้ายด้วย Syntax Get-History แสดงประวัติคำสั่งที่อัปเดตและยืนยันว่าคำสั่ง Id 3, Id 5, Id 6 และ Id 7 ถูกลบแล้ว

ตัวอย่างที่ 4: ลบคำสั่งตามหมายเลขประจำตัว

คำสั่งนี้จะลบรายการประวัติเฉพาะโดยใช้ Id หากต้องการลบหลายคำสั่ง ให้ส่งรายการหมายเลข Id ที่คั่นด้วยเครื่องหมายจุลภาค

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 cmdlet แสดงประวัติของเซสชัน PowerShell Clear-History ลบประวัติคำสั่ง พารามิเตอร์ Id ระบุคำสั่งที่จะลบ Get-History แสดงประวัติคำสั่งที่อัปเดตและยืนยันว่า Id 3 และ Id 5 ถูกลบแล้ว

ตัวอย่างที่ 5: ลบคำสั่งตามหมายเลข Id และนับ

คำสั่งนี้ใช้พารามิเตอร์ Id และ Count เพื่อลบประวัติคำสั่ง คำสั่งจะถูกลบออกจาก 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 cmdlet แสดงประวัติของเซสชัน PowerShell Clear-History ลบประวัติคำสั่ง พารามิเตอร์ Id ระบุว่าเริ่มต้นด้วย Id 7 พารามิเตอร์ นับ ระบุให้ลบห้าคำสั่ง รวมถึง Id ที่ระบุ Get-History แสดงประวัติคำสั่งที่อัปเดตและยืนยันว่าคำสั่งทั้งห้าถูกลบแล้ว Id 3 - Id 7

พารามิเตอร์

-CommandLine

ลบประวัติคำสั่งออกจากเซสชัน PowerShell สตริงจะต้องตรงกันทุกประการหรือใช้ไวด์การ์ดเพื่อจับคู่คำสั่งในประวัติเซสชัน PowerShell ที่แสดงโดย Get-History หากคุณป้อนมากกว่าหนึ่งสตริง Clear-History จะลบคำสั่งที่ตรงกับสตริงใดๆ พารามิเตอร์ CommandLine สามารถใช้กับ Count ได้

สำหรับสตริงที่มีการเว้นวรรค ให้ใช้เครื่องหมายคำพูดเดี่ยว สำหรับข้อมูลเพิ่มเติม โปรดดู about_Quoting_Rules

พิมพ์ :: String[]
ตำแหน่ง:: ตั้งชื่อ
ค่าเริ่มต้น:: None
ที่จำเป็น:: False
ยอมรับอินพุตไปป์ไลน์:: False
ยอมรับอักขระตัวแทน:: True

-Confirm

แจ้งให้คุณยืนยันก่อนเรียกใช้ cmdlet Clear-History

พิมพ์ :: SwitchParameter
นามแฝง :: cf
ตำแหน่ง:: ตั้งชื่อ
ค่าเริ่มต้น:: False
ที่จำเป็น:: False
ยอมรับอินพุตไปป์ไลน์:: False
ยอมรับอักขระตัวแทน:: False

-Count

ระบุจำนวนรายการประวัติที่ Clear-History ลบ คำสั่งจะถูกลบตามลำดับ โดยเริ่มจากรายการที่เก่าที่สุดในประวัติศาสตร์

พารามิเตอร์ นับ และ รหัส สามารถใช้ร่วมกันได้ พารามิเตอร์ นับ ระบุจำนวนคำสั่งที่จะลบ รวมถึง Id ที่ระบุ เริ่มต้นที่ Id ที่ระบุ คำสั่งจะถูกลบในลำดับย้อนกลับ ตัวอย่างเช่น หาก Id คือ 30 และ จำนวน คือ 10 Clear-History จะลบรายการที่ 21 ถึง 30

พารามิเตอร์ นับ และ CommandLine สามารถใช้ร่วมกันได้ นับ ระบุจำนวนคำสั่งที่จะลบซึ่งตรงกับค่าพารามิเตอร์ CommandLine คำสั่งจะถูกลบตามลำดับ

พิมพ์ :: Int32
ตำแหน่ง:: 1
ค่าเริ่มต้น:: None
ที่จำเป็น:: False
ยอมรับอินพุตไปป์ไลน์:: False
ยอมรับอักขระตัวแทน:: False

-Id

ระบุประวัติคำสั่ง Id ที่ Clear-History ลบ หากต้องการแสดงหมายเลข Id ให้ใช้ Get-History cmdlet หมายเลข Id เป็นไปตามลำดับ และคำสั่งจะเก็บหมายเลข Id ไว้ตลอดเซสชัน PowerShell พารามิเตอร์ Id สามารถใช้กับ Count และ Newest

พิมพ์ :: อินที32[]
ตำแหน่ง:: 0
ค่าเริ่มต้น:: None
ที่จำเป็น:: False
ยอมรับอินพุตไปป์ไลน์:: False
ยอมรับอักขระตัวแทน:: False

-Newest

เมื่อใช้พารามิเตอร์ ใหม่ล่าสุด Clear-History จะลบรายการใหม่ล่าสุดในประวัติ ตามค่าเริ่มต้น Clear-History จะลบรายการที่เก่าที่สุดในประวัติศาสตร์

พารามิเตอร์ ใหม่ล่าสุด สามารถใช้กับ Id และ Count พารามิเตอร์ นับ ระบุจำนวนคำสั่งที่จะลบ รวมถึง Id ที่ระบุ เริ่มต้นที่ Id ที่ระบุ คำสั่งจะถูกลบตามลำดับ ตัวอย่างเช่น หาก Id คือ 30 และ จำนวน คือ 10 Clear-History จะลบรายการที่ 30 ถึง 39

พิมพ์ :: SwitchParameter
ตำแหน่ง:: ตั้งชื่อ
ค่าเริ่มต้น:: None
ที่จำเป็น:: False
ยอมรับอินพุตไปป์ไลน์:: False
ยอมรับอักขระตัวแทน:: False

-WhatIf

แสดงสิ่งที่จะเกิดขึ้นหาก Clear-History cmdlet ทำงาน cmdlet ไม่ทำงาน

พิมพ์ :: SwitchParameter
นามแฝง :: wi
ตำแหน่ง:: ตั้งชื่อ
ค่าเริ่มต้น:: False
ที่จำเป็น:: False
ยอมรับอินพุตไปป์ไลน์:: False
ยอมรับอักขระตัวแทน:: False

อินพุต

ไม่มี

คุณไม่สามารถไปป์วัตถุกับ cmdlet นี้

เอาท์พุต