Remove-Variable (Microsoft.PowerShell.Utility)

Remove-Variable

โมดูล :: Microsoft.PowerShell.Utility

ลบตัวแปรและค่าของมัน

ไวยากรณ์

Remove-Variable
      [-Name] <String[]>
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-Force]
      [-Scope <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

คำอธิบาย

cmdlet Remove-Variable จะลบตัวแปรและค่าออกจากขอบเขตที่กำหนดไว้ เช่น เซสชันปัจจุบัน คุณไม่สามารถใช้ cmdlet นี้เพื่อลบตัวแปรที่ตั้งค่าเป็นค่าคงที่หรือที่เป็นของระบบ

ตัวอย่าง

ตัวอย่างที่ 1: ลบตัวแปร

Remove-Variable Smp

คำสั่งนี้จะลบตัวแปร $Smp

พารามิเตอร์

-Confirm

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

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

-Exclude

ระบุอาร์เรย์ของรายการที่ cmdlet นี้ละเว้นจากการดำเนินการ ค่าของพารามิเตอร์นี้มีคุณสมบัติตรงตามพารามิเตอร์ ชื่อ ป้อนองค์ประกอบหรือรูปแบบชื่อ เช่น "s*" อนุญาตให้ใช้ไวด์การ์ดได้

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

-Force

บ่งชี้ว่า cmdlet จะลบตัวแปรแม้ว่าจะเป็นแบบอ่านอย่างเดียวก็ตาม แม้จะใช้พารามิเตอร์ Force cmdlet ก็ไม่สามารถลบค่าคงที่ได้

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

-Include

ระบุอาร์เรย์ของรายการที่ cmdlet นี้ลบในการดำเนินการ ค่าของพารามิเตอร์นี้มีคุณสมบัติตรงตามพารามิเตอร์ ชื่อ ป้อนองค์ประกอบหรือรูปแบบชื่อ เช่น s* อนุญาตให้ใช้ไวด์การ์ดได้

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

-Name

ระบุชื่อของตัวแปรที่ต้องการลบออก ชื่อพารามิเตอร์ (ชื่อ) เป็นทางเลือก อนุญาตให้ใช้ไวด์การ์ดได้

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

-Scope

รับเฉพาะตัวแปรในขอบเขตที่ระบุ ค่าที่ยอมรับได้สำหรับพารามิเตอร์นี้คือ:

ทั่วโลก
ท้องถิ่น
สคริปต์
ตัวเลขที่สัมพันธ์กับขอบเขตปัจจุบัน (0 ถึงจำนวนขอบเขต โดยที่ 0 คือขอบเขตปัจจุบัน และ 1 คือระดับบนสุด)

ท้องถิ่นเป็นค่าเริ่มต้น สำหรับข้อมูลเพิ่มเติม โปรดดูที่ about_Scopes

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

-WhatIf

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

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

อินพุต

ตัวแปร PS

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

เอาท์พุต

ไม่มี

cmdlet นี้ส่งคืนไม่มีผลลัพธ์

หมายเหตุ

PowerShell มีนามแฝงต่อไปนี้สำหรับ Remove-Variable:

ทุกแพลตฟอร์ม:
การเปลี่ยนแปลงส่งผลต่อขอบเขตปัจจุบันเท่านั้น เช่น เซสชัน หากต้องการลบตัวแปรออกจากเซสชันทั้งหมด ให้เพิ่มคำสั่ง Remove-Variable ลงในโปรไฟล์ PowerShell ของคุณ