เอา-WSManInstance (Microsoft.WSMan.Management)

เอา-WSManInstance

โมดูล :: Microsoft.WSMan.Management

ลบอินสแตนซ์ทรัพยากรการจัดการ

ไวยากรณ์

Remove-WSManInstance
      [-ApplicationName <String>]
      [-ComputerName <String>]
      [-OptionSet <Hashtable>]
      [-Port <Int32>]
      [-ResourceURI] <Uri>
      [-SelectorSet] <Hashtable>
      [-SessionOption <SessionOption>]
      [-UseSSL]
      [-Credential <PSCredential>]
      [-Authentication <AuthenticationMechanism>]
      [-CertificateThumbprint <String>]
      [<CommonParameters>]

Remove-WSManInstance
      [-ConnectionURI <Uri>]
      [-OptionSet <Hashtable>]
      [-ResourceURI] <Uri>
      [-SelectorSet] <Hashtable>
      [-SessionOption <SessionOption>]
      [-Credential <PSCredential>]
      [-Authentication <AuthenticationMechanism>]
      [-CertificateThumbprint <String>]
      [<CommonParameters>]

คำอธิบาย

cmdlet นี้ใช้ได้เฉพาะบนแพลตฟอร์ม Windows เท่านั้น

Remove-WSManInstance cmdlet จะลบอินสแตนซ์ของทรัพยากรการจัดการที่ระบุไว้ในพารามิเตอร์ ResourceURI และ SelectorSet

cmdlet นี้ใช้เลเยอร์การขนส่งการเชื่อมต่อ WinRM เพื่อลบอินสแตนซ์ทรัพยากรการจัดการ

ตัวอย่าง

ตัวอย่างที่ 1: ลบผู้ฟัง

Remove-WSManInstance -ResourceUri winrm/config/Listener -SelectorSet @{
    Address   = 'test.fabrikam.com'
    Transport = 'http'
}

คำสั่งนี้จะลบ Listener HTTP ของ WS-Management บนคอมพิวเตอร์

พารามิเตอร์

-ApplicationName

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

<Transport>://<Server>:<Port>/<ApplicationName>

ตัวอย่างเช่น:

http://server01:8080/WSMAN

บริการข้อมูลทางอินเทอร์เน็ต (IIS) ซึ่งโฮสต์เซสชัน ส่งต่อคำขอที่มีตำแหน่งข้อมูลนี้ไปยังแอปพลิเคชันที่ระบุ การตั้งค่าเริ่มต้นของ WSMAN นี้เหมาะสมกับการใช้งานส่วนใหญ่ พารามิเตอร์นี้ได้รับการออกแบบเพื่อใช้ถ้าคอมพิวเตอร์หลายเครื่องสร้างการเชื่อมต่อระยะไกลไปยังคอมพิวเตอร์เครื่องหนึ่งที่กำลังเรียกใช้ Windows PowerShell ในกรณีนี้ IIS จะโฮสต์ Web Services for Management (WS-Management) เพื่อประสิทธิภาพ

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

-Authentication

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

พื้นฐาน - พื้นฐานคือรูปแบบที่ชื่อผู้ใช้และรหัสผ่านถูกส่งในรูปแบบข้อความที่ชัดเจนไปยังเซิร์ฟเวอร์หรือพร็อกซี
ค่าเริ่มต้น - ใช้วิธีการรับรองความถูกต้องที่ใช้โดยโปรโตคอล WS-Management นี่คือค่าเริ่มต้น
Digest - Digest เป็นรูปแบบการตอบสนองต่อความท้าทายที่ใช้สตริงข้อมูลที่ระบุโดยเซิร์ฟเวอร์สำหรับความท้าทาย
Kerberos - คอมพิวเตอร์ไคลเอนต์และเซิร์ฟเวอร์รับรองความถูกต้องร่วมกันโดยใช้ใบรับรอง Kerberos
เจรจา - เจรจาเป็นรูปแบบการตอบสนองต่อความท้าทายที่เจรจากับเซิร์ฟเวอร์หรือพร็อกซีเพื่อกำหนดรูปแบบที่จะใช้สำหรับการตรวจสอบสิทธิ์ ตัวอย่างเช่น ค่าพารามิเตอร์นี้อนุญาตให้มีการเจรจาเพื่อกำหนดว่าจะใช้โปรโตคอล Kerberos หรือ NTLM หรือไม่
CredSSP - ใช้การตรวจสอบสิทธิ์ Credential Security Support Provider (CredSSP) ซึ่งอนุญาตให้ผู้ใช้มอบหมายข้อมูลรับรอง ตัวเลือกนี้ออกแบบมาสำหรับคำสั่งที่ทำงานบนคอมพิวเตอร์ระยะไกลเครื่องหนึ่ง แต่รวบรวมข้อมูลจากหรือเรียกใช้คำสั่งเพิ่มเติมบนคอมพิวเตอร์ระยะไกลเครื่องอื่น

คำเตือน

CredSSP มอบหมายข้อมูลประจำตัวผู้ใช้จากเครื่องคอมพิวเตอร์ไปยังคอมพิวเตอร์ระยะไกล แนวทางปฏิบัตินี้เพิ่มความเสี่ยงด้านความปลอดภัยของการดำเนินการระยะไกล ถ้าคอมพิวเตอร์ระยะไกลถูกบุกรุก เมื่อข้อมูลประจำตัวถูกส่งไป ข้อมูลประจำตัวนั้นสามารถใช้เพื่อควบคุมเซสชันเครือข่ายได้

พิมพ์ :: AuthenticationMechanism
นามแฝง :: auth, am
ค่าที่ยอมรับ:: ไม่มี ค่าเริ่มต้น แยกย่อย เจรจา พื้นฐาน Kerberos ClientCertificate Credssp
ตำแหน่ง:: ตั้งชื่อ
ค่าเริ่มต้น:: None
ที่จำเป็น:: False
ยอมรับอินพุตไปป์ไลน์:: False
ยอมรับอักขระตัวแทน:: False

-CertificateThumbprint

ระบุใบรับรองคีย์สาธารณะดิจิทัล (X509) ของบัญชีผู้ใช้ที่ได้รับอนุญาตให้ดำเนินการนี้ ป้อนรหัสประจำตัวใบรับรองของใบรับรอง

ใบรับรองใช้ในการตรวจสอบความถูกต้องตามใบรับรองไคลเอ็นต์ สามารถแมปกับบัญชีผู้ใช้ภายในเครื่องเท่านั้น ใบรับรองใช้งานไม่ได้กับบัญชีโดเมน

หากต้องการรับรหัสประจำตัวของใบรับรอง ให้ใช้คำสั่ง Get-Item หรือ Get-ChildItem ในไดรฟ์ PowerShell Cert:

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

-ComputerName

ระบุคอมพิวเตอร์ที่จะใช้รันการดำเนินการจัดการ ค่าอาจเป็นชื่อโดเมนแบบเต็ม ชื่อ NetBIOS หรือที่อยู่ IP ใช้ชื่อเครื่องคอมพิวเตอร์ ใช้ localhost หรือใช้จุด (.) เพื่อระบุเครื่องคอมพิวเตอร์ คอมพิวเตอร์ท้องถิ่นเป็นค่าเริ่มต้น เมื่อคอมพิวเตอร์ระยะไกลอยู่ในโดเมนที่แตกต่างจากผู้ใช้ คุณต้องใช้ชื่อโดเมนแบบเต็มจึงจะถูกนำมาใช้ คุณสามารถไปป์ค่าสำหรับพารามิเตอร์นี้ไปที่ cmdlet

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

-ConnectionURI

ระบุจุดสิ้นสุดการเชื่อมต่อ รูปแบบของสตริงนี้เป็นดังนี้:

<Transport>://<Server>:<Port>/<ApplicationName>

สตริงต่อไปนี้เป็นค่าที่มีรูปแบบถูกต้องสำหรับพารามิเตอร์นี้:

http://Server01:8080/WSMAN

URI จะต้องมีคุณสมบัติครบถ้วน

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

-Credential

ระบุบัญชีผู้ใช้ที่ได้รับอนุญาตให้ดำเนินการนี้ ค่าเริ่มต้นคือผู้ใช้ปัจจุบัน พิมพ์ชื่อผู้ใช้ เช่น User01, Domain01\User01 หรือ User@Domain.com หรือป้อนออบเจ็กต์ PSCredential เช่น ออบเจ็กต์ที่ส่งคืนโดย cmdlet Get-Credential เมื่อคุณพิมพ์ชื่อผู้ใช้ cmdlet นี้จะพร้อมท์ให้คุณใส่รหัสผ่าน

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

-OptionSet

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

ตัวอย่างต่อไปนี้สาธิตไวยากรณ์ที่ส่งผ่านค่า 1, 2 และ 3 สำหรับพารามิเตอร์ a, b และ c:

-OptionSet @{a=1;b=2;c=3}

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

-Port

ระบุพอร์ตที่จะใช้เมื่อไคลเอ็นต์เชื่อมต่อกับบริการ WinRM เมื่อการขนส่งเป็น HTTP พอร์ตเริ่มต้นคือ 80 เมื่อการขนส่งเป็น HTTPS พอร์ตเริ่มต้นคือ 443

เมื่อคุณใช้ HTTPS เป็นการขนส่ง ค่าของพารามิเตอร์ ComputerName จะต้องตรงกับชื่อทั่วไปของใบรับรอง (CN) ของเซิร์ฟเวอร์ อย่างไรก็ตาม หากมีการระบุพารามิเตอร์ SkipCNCheck เป็นส่วนหนึ่งของพารามิเตอร์ SessionOption ชื่อทั่วไปของใบรับรองของเซิร์ฟเวอร์ไม่จำเป็นต้องตรงกับชื่อโฮสต์ของเซิร์ฟเวอร์ ควรใช้พารามิเตอร์ SkipCNCheck สำหรับคอมพิวเตอร์ที่เชื่อถือได้เท่านั้น

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

-ResourceURI

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

URI ประกอบด้วยคำนำหน้าและเส้นทางของทรัพยากร ตัวอย่างเช่น:

http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk

http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor

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

-SelectorSet

ระบุชุดของคู่ค่าที่ใช้เพื่อเลือกอินสแตนซ์ทรัพยากรการจัดการเฉพาะ พารามิเตอร์ SelectorSet ถูกใช้เมื่อมีทรัพยากรมากกว่าหนึ่งอินสแตนซ์ ค่าของ SelectorSet ต้องเป็นตารางแฮช

ตัวอย่างต่อไปนี้แสดงวิธีการป้อนค่าสำหรับพารามิเตอร์นี้:

-SelectorSet @{Name="WinRM";ID="yyy"}

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

-SessionOption

ระบุตัวเลือกเพิ่มเติมสำหรับเซสชัน WS-Management ป้อนวัตถุ SessionOption ที่คุณสร้างโดยใช้ New-WSManSessionOption cmdlet สำหรับข้อมูลเพิ่มเติมเกี่ยวกับตัวเลือกที่มีอยู่ ให้พิมพ์ Get-Help New-WSManSessionOption

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

-UseSSL

ระบุว่ามีการใช้โปรโตคอล Secure Sockets Layer (SSL) เพื่อสร้างการเชื่อมต่อกับคอมพิวเตอร์ระยะไกล ตามค่าเริ่มต้น จะไม่มีการใช้ SSL

WS-Management เข้ารหัสเนื้อหา Windows PowerShell ทั้งหมดที่ส่งผ่านเครือข่าย พารามิเตอร์ UseSSL ช่วยให้คุณระบุการป้องกันเพิ่มเติมของ HTTPS แทน HTTP หากไม่มี SSL บนพอร์ตที่ใช้สำหรับการเชื่อมต่อ และคุณระบุพารามิเตอร์นี้ คำสั่งจะล้มเหลว

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

อินพุต

ไม่มี

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

เอาท์พุต

ไม่มี

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

หมายเหตุ

cmdlet ในโมดูล CimCmdlets จะคล้ายกัน พวกเขาใช้เลเยอร์การเชื่อมต่อ/การขนส่ง DCOM เพื่อสร้างหรืออัปเดตอินสแตนซ์ WMI

เอา-WSManInstance (Microsoft.WSMan.Management)