Remove-ItemProperty (Microsoft.PowerShell.Management)
Remove-ItemProperty
- โมดูล :
- Microsoft.PowerShell.Management
ลบคุณสมบัติและค่าออกจากรายการ
ไวยากรณ์
Remove-ItemProperty
[-Path] <String[]>
[-Name] <String[]>
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Remove-ItemProperty
-LiteralPath <String[]>
[-Name] <String[]>
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]คำอธิบาย
Remove-ItemProperty cmdlet จะลบคุณสมบัติและค่าของมันออกจากรายการ คุณสามารถใช้มันเพื่อลบค่ารีจิสทรีและข้อมูลที่เก็บไว้
ตัวอย่าง
ตัวอย่างที่ 1: ลบค่ารีจิสทรี
คำสั่งนี้จะลบค่ารีจิสทรี "SmpProperty" และข้อมูลออกจากคีย์ย่อย "SmpApplication" ของคีย์รีจิสทรี HKEY_LOCAL_MACHINE\Software
Remove-ItemProperty -Path "HKLM:\Software\SmpApplication" -Name "SmpProperty"เนื่องจากคำสั่งนั้นออกจากไดรฟ์ระบบไฟล์ (PS C:\>) จึงรวมเส้นทางแบบเต็มของคีย์ย่อย "SmpApplication" รวมถึงไดรฟ์ HKLM: และปุ่ม "ซอฟต์แวร์"
ตัวอย่างที่ 2: ลบค่ารีจิสทรีออกจากตำแหน่งที่ตั้ง HKCU
คำสั่งเหล่านี้จะลบค่ารีจิสทรี "ตัวเลือก" และข้อมูลออกจากคีย์ย่อย "MyApp" ของ "HKEY_CURRENT_USER\Software\MyCompany"
PS C:\> Set-Location HKCU:\Software\MyCompany\MyApp
PS HKCU:\Software\MyCompany\MyApp> Remove-ItemProperty -Path . -Name "Options" -Confirm
คำสั่งแรกใช้ Set-Location cmdlet เพื่อเปลี่ยนตำแหน่งปัจจุบันเป็นไดรฟ์ HKEY_CURRENT_USER (HKCU:) และ Software\ คีย์ย่อย MyCompany\MyApp
คำสั่งที่สองใช้ Remove-ItemProperty เพื่อลบค่ารีจิสทรี "Options" และข้อมูลออกจากคีย์ย่อย "MyApp" เนื่องจากจำเป็นต้องมี เส้นทาง คำสั่งจึงใช้จุด (.) เพื่อระบุตำแหน่งปัจจุบัน พารามิเตอร์ ยืนยัน ร้องขอให้ผู้ใช้แจ้งก่อนที่จะลบค่า
ตัวอย่างที่ 3: เอาค่ารีจิสทรีออกโดยใช้ไปป์ไลน์
คำสั่งนี้จะลบค่ารีจิสทรี "NoOfEmployees" และข้อมูลออกจากคีย์รีจิสทรี HKLM\Software\MyCompany
Get-Item -Path HKLM:\Software\MyCompany | Remove-ItemProperty -Name NoOfEmployeesคำสั่งใช้ cmdlet Get-Item เพื่อรับรายการที่แสดงถึงคีย์รีจิสทรี ใช้ตัวดำเนินการไปป์ไลน์ (|) เพื่อส่งวัตถุไปที่ Remove-ItemProperty จากนั้น จะใช้พารามิเตอร์ ชื่อ ของ Remove-ItemProperty เพื่อระบุชื่อของค่ารีจิสทรี
พารามิเตอร์
-Confirm
แจ้งให้คุณยืนยันก่อนเรียกใช้ cmdlet
- พิมพ์ :
SwitchParameter
- นามแฝง :
cf
- ตำแหน่ง:
ตั้งชื่อ
- ค่าเริ่มต้น:
False
- ที่จำเป็น:
False
- ยอมรับอินพุตไปป์ไลน์:
-
False
- ยอมรับอักขระตัวแทน:
False
-Credential
บันทึก
ผู้ให้บริการใดๆ ที่ติดตั้ง PowerShell ไม่รองรับพารามิเตอร์นี้ หากต้องการปลอมตัวเป็นผู้ใช้รายอื่น หรือยกระดับข้อมูลประจำตัวของคุณเมื่อเรียกใช้ cmdlet นี้ ให้ใช้ Inrigg-Command
- พิมพ์ :
PSCredential
- ตำแหน่ง:
ตั้งชื่อ
- ค่าเริ่มต้น:
ผู้ใช้ปัจจุบัน
- ที่จำเป็น:
False
- ยอมรับอินพุตไปป์ไลน์:
True
- ยอมรับอักขระตัวแทน:
False
-Exclude
ระบุเป็นอาร์เรย์สตริง รายการหรือรายการที่ cmdlet นี้ไม่รวมในการดำเนินการ ค่าของพารามิเตอร์นี้มีคุณสมบัติตรงตามพารามิเตอร์ เส้นทาง ป้อนองค์ประกอบเส้นทางหรือรูปแบบ เช่น *.txt อนุญาตให้ใช้อักขระตัวแทนได้ พารามิเตอร์ ยกเว้น จะมีผลเฉพาะเมื่อคำสั่งรวมเนื้อหาของรายการ เช่น C:\Windows\* โดยที่อักขระตัวแทนระบุเนื้อหาของ ไดเรกทอรี C:\Windows
- พิมพ์ :
String[]
- ตำแหน่ง:
ตั้งชื่อ
- ค่าเริ่มต้น:
None
- ที่จำเป็น:
False
- ยอมรับอินพุตไปป์ไลน์:
False
- ยอมรับอักขระตัวแทน:
True
-Filter
ระบุตัวกรองเพื่อรับรองพารามิเตอร์ เส้นทาง ผู้ให้บริการ FileSystem เป็นผู้ให้บริการ PowerShell ที่ติดตั้งเพียงรายเดียวที่รองรับการใช้ตัวกรอง คุณสามารถค้นหาไวยากรณ์สำหรับภาษาตัวกรอง FileSystem ได้ใน about_Wildcards ตัวกรองมีประสิทธิภาพมากกว่าพารามิเตอร์อื่นๆ เนื่องจากผู้ให้บริการนำไปใช้เมื่อ cmdlet ได้รับวัตถุแทนที่จะให้ PowerShell กรองวัตถุหลังจากถูกดึงข้อมูล
- พิมพ์ :
String
- ตำแหน่ง:
ตั้งชื่อ
- ค่าเริ่มต้น:
None
- ที่จำเป็น:
False
- ยอมรับอินพุตไปป์ไลน์:
False
- ยอมรับอักขระตัวแทน:
True
-Force
บังคับให้ cmdlet ลบคุณสมบัติของวัตถุที่ผู้ใช้ไม่สามารถเข้าถึงได้ การใช้งานแตกต่างกันไปในแต่ละผู้ให้บริการ สำหรับข้อมูลเพิ่มเติม โปรดดูที่ about_Providers
- พิมพ์ :
SwitchParameter
- ตำแหน่ง:
ตั้งชื่อ
- ค่าเริ่มต้น:
False
- ที่จำเป็น:
False
- ยอมรับอินพุตไปป์ไลน์:
False
- ยอมรับอักขระตัวแทน:
False
-Include
ระบุเป็นอาร์เรย์สตริง รายการหรือรายการที่ cmdlet นี้รวมไว้ในการดำเนินการ ค่าของพารามิเตอร์นี้มีคุณสมบัติตรงตามพารามิเตอร์ เส้นทาง ป้อนองค์ประกอบเส้นทางหรือรูปแบบ เช่น "*.txt" อนุญาตให้ใช้อักขระตัวแทนได้ พารามิเตอร์ รวม จะมีผลเฉพาะเมื่อคำสั่งรวมเนื้อหาของรายการ เช่น C:\Windows\* โดยที่อักขระตัวแทนระบุเนื้อหาของ ไดเรกทอรี C:\Windows
- พิมพ์ :
String[]
- ตำแหน่ง:
ตั้งชื่อ
- ค่าเริ่มต้น:
None
- ที่จำเป็น:
False
- ยอมรับอินพุตไปป์ไลน์:
False
- ยอมรับอักขระตัวแทน:
True
-LiteralPath
ระบุเส้นทางไปยังสถานที่ตั้งแต่หนึ่งแห่งขึ้นไป ค่าของ LiteralPath จะถูกใช้ตรงตามที่พิมพ์ทุกประการ ไม่มีอักขระใดที่ถูกตีความว่าเป็นไวด์การ์ด หากเส้นทางมีอักขระเลี่ยง ให้ใส่เครื่องหมายคำพูดเดี่ยว เครื่องหมายคำพูดเดี่ยวบอกให้ PowerShell ไม่ต้องตีความอักขระใดๆ เป็นลำดับหลีก
สำหรับข้อมูลเพิ่มเติม โปรดดู about_Quoting_Rules
- พิมพ์ :
String[]
- นามแฝง :
PSPath, LP
- ตำแหน่ง:
ตั้งชื่อ
- ค่าเริ่มต้น:
None
- ที่จำเป็น:
True
- ยอมรับอินพุตไปป์ไลน์:
True
- ยอมรับอักขระตัวแทน:
False
-Name
ระบุชื่อของคุณสมบัติที่ต้องการลบ อนุญาตให้ใช้อักขระตัวแทนได้
- พิมพ์ :
String[]
- นามแฝง :
PSProperty
- ตำแหน่ง:
1
- ค่าเริ่มต้น:
None
- ที่จำเป็น:
True
- ยอมรับอินพุตไปป์ไลน์:
True
- ยอมรับอักขระตัวแทน:
True
-Path
ระบุเส้นทางของรายการที่มีคุณสมบัติที่กำลังจะถูกลบออก อนุญาตให้ใช้อักขระตัวแทนได้
- พิมพ์ :
String[]
- ตำแหน่ง:
0
- ค่าเริ่มต้น:
None
- ที่จำเป็น:
True
- ยอมรับอินพุตไปป์ไลน์:
True
- ยอมรับอักขระตัวแทน:
True
-WhatIf
แสดงสิ่งที่จะเกิดขึ้นหาก cmdlet ทำงาน cmdlet ไม่ทำงาน
- พิมพ์ :
SwitchParameter
- นามแฝง :
wi
- ตำแหน่ง:
ตั้งชื่อ
- ค่าเริ่มต้น:
False
- ที่จำเป็น:
False
- ยอมรับอินพุตไปป์ไลน์:
False
- ยอมรับอักขระตัวแทน:
False
อินพุต
สตริง
คุณสามารถไปป์สตริงที่มีเส้นทาง แต่ไม่ใช่เส้นทางตามตัวอักษรไปยัง cmdlet นี้
เอาท์พุต
ไม่มี
cmdlet นี้ส่งคืนไม่มีผลลัพธ์
หมายเหตุ
PowerShell มีนามแฝงต่อไปนี้สำหรับ Remove-ItemProperty:
ทุกแพลตฟอร์ม:
rp
ในผู้ให้บริการรีจิสทรี PowerShell ค่ารีจิสทรีจะถือเป็นคุณสมบัติของคีย์รีจิสทรีหรือคีย์ย่อย คุณสามารถใช้ ItemProperty cmdlets เพื่อจัดการค่าเหล่านี้
Remove-ItemProperty ได้รับการออกแบบมาเพื่อทำงานกับข้อมูลที่เปิดเผยโดยผู้ให้บริการรายใดก็ตาม หากต้องการแสดงรายการผู้ให้บริการที่มีอยู่ในเซสชันของคุณ ให้พิมพ์ Get-PSProvider สำหรับข้อมูลเพิ่มเติม โปรดดูที่ about_Providers