ชื่อพารามิเตอร์ทั่วไป

พารามิเตอร์ที่อธิบายในหัวข้อนี้เรียกว่า พารามิเตอร์ทั่วไป สิ่งเหล่านี้ถูกเพิ่มลงใน cmdlet โดยรันไทม์ของ PowerShell และ cmdlet ไม่สามารถประกาศได้

พารามิเตอร์ทั่วไปทั่วไป

พารามิเตอร์ต่อไปนี้จะถูกเพิ่มลงใน cmdlet ทั้งหมด และสามารถเข้าถึงได้ทุกครั้งที่เรียกใช้ cmdlet พารามิเตอร์เหล่านี้ถูกกำหนดโดยคลาส CommonParameters

ดีบั๊ก (นามแฝง: db)

ประเภทข้อมูล: พารามิเตอร์สวิตช์

พารามิเตอร์นี้ระบุว่าข้อความดีบักระดับโปรแกรมเมอร์ที่สามารถแสดงที่บรรทัดคำสั่งได้หรือไม่ ข้อความเหล่านี้มีไว้สำหรับการแก้ไขปัญหาการดำเนินการของ cmdlet และถูกสร้างขึ้นโดยการเรียกไปยังเมธอด WriteDebug ข้อความแก้ไขข้อบกพร่องไม่จำเป็นต้องแปลเป็นภาษาท้องถิ่น

ErrorAction (นามแฝง: ea)

ประเภทข้อมูล: การแจงนับ

พารามิเตอร์นี้ระบุการดำเนินการที่ควรเกิดขึ้นเมื่อเกิดข้อผิดพลาด ค่าที่เป็นไปได้สำหรับพารามิเตอร์นี้ถูกกำหนดโดยการแจงนับ ActionPreference

ErrorVariable (นามแฝง: ev)

ประเภทข้อมูล: สตริง

พารามิเตอร์นี้ระบุตัวแปรที่จะวางอ็อบเจ็กต์เมื่อเกิดข้อผิดพลาด หากต้องการเพิ่มตัวแปรนี้ ให้ใช้ +varname แทนที่จะล้างและตั้งค่าตัวแปร

InformationAction (นามแฝง: อินฟา)

ประเภทข้อมูล: การแจงนับ

พารามิเตอร์นี้ระบุการดำเนินการที่ควรเกิดขึ้นเมื่อเอาต์พุตถูกส่งไปยังสตรีม ข้อมูล ค่าที่เป็นไปได้สำหรับพารามิเตอร์นี้ถูกกำหนดโดยการแจงนับ ActionPreference

InformationVariable (นามแฝง: iv)

ประเภทข้อมูล: สตริง

พารามิเตอร์นี้ระบุตัวแปรที่จะบันทึกออบเจ็กต์เอาต์พุตที่เขียนลงในสตรีม ข้อมูล หากต้องการเพิ่มตัวแปรนี้ ให้ใช้ +varname แทนที่จะล้างและตั้งค่าตัวแปร

OutBuffer (นามแฝง: ob)

ประเภทข้อมูล: Int32

พารามิเตอร์นี้กำหนดจำนวนของอ็อบเจ็กต์ที่จะจัดเก็บไว้ในบัฟเฟอร์เอาต์พุตก่อนที่อ็อบเจ็กต์ใดๆ จะถูกส่งผ่านไปป์ไลน์ ตามค่าเริ่มต้น ออบเจ็กต์จะถูกส่งผ่านไปป์ไลน์ทันที

OutVariable (นามแฝง: ov)

ประเภทข้อมูล: สตริง

พารามิเตอร์นี้ระบุตัวแปรที่จะวางวัตถุผลลัพธ์ทั้งหมดที่สร้างโดย cmdlet หากต้องการเพิ่มตัวแปรนี้ ให้ใช้ +varname แทนที่จะล้างและตั้งค่าตัวแปร

PipelineVariable (นามแฝง: pv)

ประเภทข้อมูล: สตริง

พารามิเตอร์นี้เก็บค่าขององค์ประกอบไปป์ไลน์ปัจจุบันเป็นตัวแปรสำหรับคำสั่งที่มีชื่อใดๆ ขณะไหลผ่านไปป์ไลน์

ProgressAction (นามแฝง: proga)

ประเภทข้อมูล: การแจงนับ

กำหนดวิธีที่ PowerShell ตอบสนองต่อการอัปเดตความคืบหน้าที่สร้างโดยสคริปต์ cmdlet หรือผู้ให้บริการ เช่น แถบความคืบหน้าที่สร้างโดย cmdlet Write-Progress

พารามิเตอร์นี้ถูกเพิ่มใน PowerShell 7.4

ละเอียด (นามแฝง: vb)

ประเภทข้อมูล: พารามิเตอร์สวิตช์

พารามิเตอร์นี้ระบุว่า cmdlet เขียนข้อความอธิบายที่สามารถแสดงได้ที่บรรทัดคำสั่งหรือไม่ ข้อความเหล่านี้มีวัตถุประสงค์เพื่อให้ความช่วยเหลือเพิ่มเติมแก่ผู้ใช้ และสร้างขึ้นโดยการเรียกเมธอด WriteVerbose

WarningAction (นามแฝง: wa)

ประเภทข้อมูล: การแจงนับ

พารามิเตอร์นี้ระบุการดำเนินการที่ควรเกิดขึ้นเมื่อ cmdlet เขียนข้อความเตือน ค่าที่เป็นไปได้สำหรับพารามิเตอร์นี้ถูกกำหนดโดยการแจงนับ ActionPreference

WarningVariable (นามแฝง: wv)

ประเภทข้อมูล: สตริง

พารามิเตอร์นี้ระบุตัวแปรที่สามารถบันทึกข้อความเตือนได้ หากต้องการเพิ่มตัวแปรนี้ ให้ใช้ +varname แทนที่จะล้างและตั้งค่าตัวแปร

พารามิเตอร์การลดความเสี่ยง

พารามิเตอร์ต่อไปนี้จะถูกเพิ่มลงใน cmdlets ที่ร้องขอการยืนยันก่อนที่จะดำเนินการ สำหรับข้อมูลเพิ่มเติมเกี่ยวกับคำขอยืนยัน โปรดดูที่การขอการยืนยัน พารามิเตอร์เหล่านี้ถูกกำหนดโดยคลาส shouldProcessParameters

ยืนยัน (นามแฝง: cf)

ประเภทข้อมูล: พารามิเตอร์สวิตช์

พารามิเตอร์นี้ระบุว่า cmdlet จะแสดงพร้อมท์ที่ถามว่าผู้ใช้แน่ใจว่าต้องการดำเนินการต่อหรือไม่

WhatIf (นามแฝง: wi)

ประเภทข้อมูล: พารามิเตอร์สวิตช์

พารามิเตอร์นี้ระบุว่า cmdlet เขียนข้อความที่อธิบายผลกระทบของการเรียกใช้ cmdlet โดยไม่ต้องดำเนินการใดๆ จริงๆ หรือไม่

พารามิเตอร์การทำธุรกรรม

มีเพิ่มพารามิเตอร์ต่อไปนี้ใน cmdlets ที่รองรับธุรกรรม พารามิเตอร์เหล่านี้ถูกกำหนดโดยคลาส TransactionParameters

การสนับสนุนธุรกรรมถูกนำมาใช้ใน PowerShell 3.0 และถูกยกเลิกใน PowerShell 6.0

UseTransaction (นามแฝง: usetx)

ประเภทข้อมูล: พารามิเตอร์สวิตช์

พารามิเตอร์นี้ระบุว่า cmdlet ใช้ธุรกรรมปัจจุบันเพื่อดำเนินการหรือไม่

ดูเพิ่มเติม

• about_CommonParameters
• System.Management.Automation.Internal.CommonParameters
• System.Management.Automation.Internal.ShouldProcessParameters
• System.Management.Automation.Internal.TransactionParameters
• การเขียน Windows PowerShell Cmdlet
• Windows PowerShell SDK