เปิดใช้งาน-PSSessionConfiguration (Microsoft.PowerShell.Core)

เปิดใช้งาน-PSSessionConfiguration

โมดูล :

Microsoft.PowerShell.Core

เปิดใช้งานการกำหนดค่าเซสชันบนเครื่องคอมพิวเตอร์

ไวยากรณ์

Enable-PSSessionConfiguration
      [[-Name] <String[]>]
      [-Force]
      [-SecurityDescriptorSddl <String>]
      [-SkipNetworkProfileCheck]
      [-NoServiceRestart]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

คำอธิบาย

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

Enable-PSSessionConfiguration cmdlet เปิดใช้งานการกำหนดค่าเซสชันที่ลงทะเบียนที่ถูกปิดใช้งาน เช่นโดยใช้ cmdlets Disable-PSSessionConfiguration หรือ Disable-PSRemoting หรือ พารามิเตอร์ AccessMode ของ Register-PSSessionConfiguration นี่คือ cmdlet ขั้นสูงที่ผู้ดูแลระบบออกแบบมาเพื่อใช้ในการจัดการการกำหนดค่าเซสชันที่กำหนดเองสำหรับผู้ใช้

หากไม่มีพารามิเตอร์ Enable-PSSessionConfiguration จะเปิดใช้งานการกำหนดค่า Microsoft.PowerShell ซึ่งเป็นการกำหนดค่าเริ่มต้นที่ใช้สำหรับเซสชัน

Enable-PSSessionConfiguration ลบการตั้งค่า Deny_All ออกจากตัวบอกความปลอดภัยของการกำหนดค่าเซสชันที่ได้รับผลกระทบ เปิด Listener ที่ยอมรับคำขอเกี่ยวกับที่อยู่ IP ใด ๆ และเริ่มบริการ WinRM ใหม่ เริ่มต้นใน PowerShell 3.0 Enable-PSSessionConfiguration ยังตั้งค่าของคุณสมบัติ Enabled ของการกำหนดค่าเซสชัน (WSMan:\\PlugIn\ \Enabled) เป็น True อย่างไรก็ตาม Enable-PSSessionConfiguration จะไม่ลบหรือเปลี่ยนแปลงการตั้งค่าตัวบอกเกี่ยวกับความปลอดภัย Network_Deny_All (AccessMode=Local) ที่อนุญาตให้เฉพาะผู้ใช้เครื่องคอมพิวเตอร์เฉพาะที่เท่านั้นที่สามารถ ใช้ในการกำหนดค่าเซสชัน

ตัวอย่าง

ตัวอย่างที่ 1: เปิดใช้งานเซสชันเริ่มต้นอีกครั้ง

ตัวอย่างนี้เปิดใช้งานการกำหนดค่าเซสชันเริ่มต้นของ Microsoft.PowerShell บนคอมพิวเตอร์อีกครั้ง

Enable-PSSessionConfiguration

ตัวอย่างที่ 2: เปิดใช้งานเซสชันที่ระบุอีกครั้ง

ตัวอย่างนี้จะเปิดใช้งานการกำหนดค่าเซสชัน MaintenanceShell และ AdminShell บนคอมพิวเตอร์อีกครั้ง

Enable-PSSessionConfiguration -Name MaintenanceShell, AdminShell

ตัวอย่างที่ 3: เปิดใช้งานเซสชันทั้งหมดอีกครั้ง

ตัวอย่างนี้เปิดใช้งานการกำหนดค่าเซสชันทั้งหมดบนคอมพิวเตอร์อีกครั้ง คำสั่งเหล่านี้เทียบเท่ากัน ดังนั้นคุณสามารถใช้อย่างใดอย่างหนึ่งได้

Enable-PSSessionConfiguration -Name *
Get-PSSessionConfiguration | Enable-PSSessionConfiguration

Enable-PSSessionConfiguration ไม่สร้างข้อผิดพลาดหากคุณเปิดใช้งานการกำหนดค่าเซสชันที่เปิดใช้งานอยู่แล้ว

ตัวอย่างที่ 4: เปิดใช้งานเซสชันอีกครั้งและระบุตัวบอกเกี่ยวกับความปลอดภัยใหม่

ตัวอย่างนี้จะเปิดใช้งานการกำหนดค่าเซสชัน MaintenanceShell อีกครั้ง และระบุตัวบอกเกี่ยวกับความปลอดภัยใหม่สำหรับการกำหนดค่า

$sddl = "O:NSG:BAD:P(A;;GXGWGR;;;BA)(A;;GAGR;;;S-1-5-21-123456789-188441444-3100496)S:P"
Enable-PSSessionConfiguration -Name MaintenanceShell -SecurityDescriptorSDDL $sddl

พารามิเตอร์

-Confirm

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

พิมพ์ :

SwitchParameter

นามแฝง :

cf

ตำแหน่ง:

ตั้งชื่อ

ค่าเริ่มต้น:

False

ที่จำเป็น:

False

ยอมรับอินพุตไปป์ไลน์:

False

ยอมรับอักขระตัวแทน:

False

-Force

บ่งชี้ว่า cmdlet ไม่พร้อมท์ให้คุณยืนยัน และเริ่มบริการ WinRM ใหม่โดยไม่พร้อมท์ การเริ่มบริการใหม่จะทำให้การเปลี่ยนแปลงการกำหนดค่ามีผล

เพื่อป้องกันการรีสตาร์ทและระงับพรอมต์การรีสตาร์ท ให้ใช้พารามิเตอร์ NoServiceRestart

พิมพ์ :

SwitchParameter

ตำแหน่ง:

ตั้งชื่อ

ค่าเริ่มต้น:

None

ที่จำเป็น:

False

ยอมรับอินพุตไปป์ไลน์:

False

ยอมรับอักขระตัวแทน:

False

-Name

ระบุชื่อของการกำหนดค่าเซสชันที่จะเปิดใช้งาน ป้อนชื่อการกำหนดค่าอย่างน้อยหนึ่งชื่อ อนุญาตให้ใช้อักขระตัวแทนได้

คุณยังสามารถไปป์สตริงที่มีชื่อการกำหนดค่าหรือออบเจ็กต์การกำหนดค่าเซสชันเพื่อ Enable-PSSessionConfiguration

หากคุณละเว้นพารามิเตอร์นี้ Enable-PSSessionConfiguration จะเปิดใช้งานการกำหนดค่าเซสชัน Microsoft.PowerShell

พิมพ์ :

String[]

ตำแหน่ง:

0

ค่าเริ่มต้น:

None

ที่จำเป็น:

False

ยอมรับอินพุตไปป์ไลน์:

True

ยอมรับอักขระตัวแทน:

True

-NoServiceRestart

บ่งชี้ว่า cmdlet ไม่เริ่มบริการใหม่

พิมพ์ :

SwitchParameter

ตำแหน่ง:

ตั้งชื่อ

ค่าเริ่มต้น:

None

ที่จำเป็น:

False

ยอมรับอินพุตไปป์ไลน์:

False

ยอมรับอักขระตัวแทน:

False

-SecurityDescriptorSddl

ระบุตัวบอกเกี่ยวกับความปลอดภัยที่ cmdlet นี้แทนที่ตัวบอกเกี่ยวกับความปลอดภัยในการกำหนดค่าเซสชัน

หากคุณละเว้นพารามิเตอร์นี้ Enable-PSSessionConfiguration จะลบเฉพาะรายการปฏิเสธจากตัวบอกเกี่ยวกับความปลอดภัยเท่านั้น

พิมพ์ :

String

ตำแหน่ง:

ตั้งชื่อ

ค่าเริ่มต้น:

None

ที่จำเป็น:

False

ยอมรับอินพุตไปป์ไลน์:

False

ยอมรับอักขระตัวแทน:

False

-SkipNetworkProfileCheck

บ่งชี้ว่า cmdlet นี้เปิดใช้งานการกำหนดค่าเซสชันเมื่อคอมพิวเตอร์อยู่บนเครือข่ายสาธารณะ พารามิเตอร์นี้เปิดใช้งานกฎไฟร์วอลล์สำหรับเครือข่ายสาธารณะที่อนุญาตการเข้าถึงระยะไกลจากคอมพิวเตอร์ในเครือข่ายย่อยท้องถิ่นเดียวกันเท่านั้น ตามค่าเริ่มต้น Enable-PSSessionConfiguration ล้มเหลวบนเครือข่ายสาธารณะ

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

หากต้องการลบข้อจำกัดเครือข่ายย่อยภายในเครื่องและเปิดใช้งานการเข้าถึงระยะไกลจากทุกตำแหน่งบนเครือข่ายสาธารณะ ให้ใช้ Set-NetFirewallRule cmdlet ในโมดูล NetSecurity สำหรับข้อมูลเพิ่มเติม โปรดดู <รหัส>เปิดใช้งาน-PSRemoting

พารามิเตอร์นี้ถูกนำมาใช้ใน PowerShell 3.0

พิมพ์ :

SwitchParameter

ตำแหน่ง:

ตั้งชื่อ

ค่าเริ่มต้น:

None

ที่จำเป็น:

False

ยอมรับอินพุตไปป์ไลน์:

False

ยอมรับอักขระตัวแทน:

False

-WhatIf

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

พิมพ์ :

SwitchParameter

นามแฝง :

wi

ตำแหน่ง:

ตั้งชื่อ

ค่าเริ่มต้น:

False

ที่จำเป็น:

False

ยอมรับอินพุตไปป์ไลน์:

False

ยอมรับอักขระตัวแทน:

False

อินพุต

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

คุณสามารถไพพ์วัตถุการกำหนดค่าเซสชันไปที่ cmdlet นี้

สตริง

คุณสามารถไปป์สตริงที่ประกอบด้วยชื่อของการกำหนดค่าเซสชันไปยัง cmdlet นี้

เอาท์พุต

ไม่มี

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

หมายเหตุ

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

หากต้องการใช้ cmdlet นี้ คุณต้องเริ่ม PowerShell โดยใช้ตัวเลือก เรียกใช้ในฐานะผู้ดูแลระบบ