ชุด PSSessionConfiguration (Microsoft.PowerShell.Core)

ชุด-PSSessionConfiguration

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

เปลี่ยนคุณสมบัติของการกำหนดค่าเซสชันที่ลงทะเบียน

ไวยากรณ์

Set-PSSessionConfiguration
   [-Name] <String>
   [-ApplicationBase <String>]
   [-RunAsCredential <PSCredential>]
   [-ThreadApartmentState <ApartmentState>]
   [-ThreadOptions <PSThreadOptions>]
   [-AccessMode <PSSessionConfigurationAccessMode>]
   [-UseSharedProcess]
   [-StartupScript <String>]
   [-MaximumReceivedDataSizePerCommandMB <Double>]
   [-MaximumReceivedObjectSizeMB <Double>]
   [-SecurityDescriptorSddl <String>]
   [-ShowSecurityDescriptorUI]
   [-Force]
   [-NoServiceRestart]
   [-PSVersion <Version>]
   [-SessionTypeOption <PSSessionTypeOption>]
   [-TransportOption <PSTransportOption>]
   [-ModulesToImport <Object[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-PSSessionConfiguration
   [-Name] <String>
   [-AssemblyName] <String>
   [-ApplicationBase <String>]
   [-ConfigurationTypeName] <String>
   [-RunAsCredential <PSCredential>]
   [-ThreadApartmentState <ApartmentState>]
   [-ThreadOptions <PSThreadOptions>]
   [-AccessMode <PSSessionConfigurationAccessMode>]
   [-UseSharedProcess]
   [-StartupScript <String>]
   [-MaximumReceivedDataSizePerCommandMB <Double>]
   [-MaximumReceivedObjectSizeMB <Double>]
   [-SecurityDescriptorSddl <String>]
   [-ShowSecurityDescriptorUI]
   [-Force]
   [-NoServiceRestart]
   [-PSVersion <Version>]
   [-SessionTypeOption <PSSessionTypeOption>]
   [-TransportOption <PSTransportOption>]
   [-ModulesToImport <Object[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-PSSessionConfiguration
   [-Name] <String>
   [-RunAsCredential <PSCredential>]
   [-ThreadApartmentState <ApartmentState>]
   [-ThreadOptions <PSThreadOptions>]
   [-AccessMode <PSSessionConfigurationAccessMode>]
   [-UseSharedProcess]
   [-StartupScript <String>]
   [-MaximumReceivedDataSizePerCommandMB <Double>]
   [-MaximumReceivedObjectSizeMB <Double>]
   [-SecurityDescriptorSddl <String>]
   [-ShowSecurityDescriptorUI]
   [-Force]
   [-NoServiceRestart]
   [-TransportOption <PSTransportOption>]
   -Path <String>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

คำอธิบาย

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

cmdlet Set-PSSessionConfiguration จะเปลี่ยนคุณสมบัติของการกำหนดค่าเซสชันบนคอมพิวเตอร์เฉพาะที่

ใช้พารามิเตอร์ ชื่อ เพื่อระบุการกำหนดค่าเซสชันที่คุณต้องการเปลี่ยนแปลง ใช้พารามิเตอร์อื่นเพื่อระบุค่าใหม่สำหรับคุณสมบัติของการกำหนดค่าเซสชัน หากต้องการลบค่าคุณสมบัติออกจากการกำหนดค่า และใช้ค่าเริ่มต้น ให้ป้อนสตริงว่าง ("") หรือค่า $Null สำหรับพารามิเตอร์ที่เกี่ยวข้อง

เริ่มต้นใน PowerShell 3.0 คุณสามารถใช้ไฟล์การกำหนดค่าเซสชันเพื่อกำหนดการกำหนดค่าเซสชันได้ คุณลักษณะนี้มีวิธีการที่ง่ายและค้นพบได้สำหรับการตั้งค่าและการเปลี่ยนแปลงคุณสมบัติของเซสชันที่ใช้การกำหนดค่าเซสชัน หากต้องการระบุไฟล์การกำหนดค่าเซสชัน ให้ใช้พารามิเตอร์ Path ของ Set-PSSessionConfiguration สำหรับข้อมูลเกี่ยวกับไฟล์คอนฟิกูเรชันเซสชัน โปรดดูที่ about_Session_Configuration_Files สำหรับข้อมูลเกี่ยวกับวิธีการสร้างและแก้ไขไฟล์การกำหนดค่าเซสชัน โปรดดู cmdlet New-PSSessionConfigurationFile

การกำหนดค่าเซสชันจะกำหนดสภาพแวดล้อมของเซสชันระยะไกล (PSSessions) ที่เชื่อมต่อกับคอมพิวเตอร์ในระบบ PSSession ทุกรายการใช้การกำหนดค่าเซสชัน การกำหนดค่าเซสชันจะกำหนดคุณลักษณะของ PSSession เช่น โมดูลที่มีอยู่ในเซสชัน cmdlets ที่ได้รับอนุญาตให้ทำงาน โหมดภาษา โควต้า และการหมดเวลา ตัวบอกเกี่ยวกับความปลอดภัยของการกำหนดค่าเซสชันจะกำหนดว่าใครสามารถใช้การกำหนดค่าเซสชันเพื่อเชื่อมต่อกับคอมพิวเตอร์ในระบบได้ สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดค่าเซสชัน โปรดดู about_Session_Configurations

หากต้องการดูคุณสมบัติของการกำหนดค่าเซสชัน ให้ใช้ Get-PSSessionConfiguration cmdlet หรือ WSMan Provider สำหรับข้อมูลเพิ่มเติมเกี่ยวกับผู้ให้บริการ WSMan ให้พิมพ์ รับความช่วยเหลือ WSMan

ตัวอย่าง

ตัวอย่างที่ 1: สร้างและเปลี่ยนแปลงการกำหนดค่าเซสชัน

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

คำสั่งแรกจะสร้างการกำหนดค่า AdminShell คำสั่งที่สองจะเพิ่มสคริปต์ AdminConfig.ps1 ให้กับการกำหนดค่า การเปลี่ยนแปลงจะมีผลเมื่อคุณรีสตาร์ท WinRM คำสั่งที่สามจะลบสคริปต์ AdminConfig.ps1 ออกจากการกำหนดค่า

Register-PSSessionConfiguration -Name "AdminShell" -AssemblyName "C:\Shells\AdminShell.dll" -ConfigurationTypeName "AdminClass"
Set-PSSessionConfiguration -Name "AdminShell" -StartupScript "AdminConfig.ps1"
Set-PSSessionConfiguration -Name "AdminShell" -StartupScript $Null

ตัวอย่างที่ 2: แสดงผล

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

Set-PSSessionConfiguration -Name "IncObj" -MaximumReceivedObjectSizeMB 20

WSManConfig: Microsoft.WSMan.Management\WSMan::localhost\Plugin\IncObj\InitializationParameters

ParamName                       ParamValue
---------                       ----------
psmaximumreceivedobjectsizemb   20

"Restart WinRM service"
WinRM service need to be restarted to make the changes effective. Do you want to run the command "restart-service winrm"?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): y

ตัวอย่างที่ 3: แสดงผลลัพธ์ในรูปแบบต่างๆ

ในตัวอย่างนี้ Set-PSSessionConfiguration จะเปลี่ยนสคริปต์เริ่มต้นในการกำหนดค่าเซสชัน MaintenanceShell เป็น Maintenance.ps1 ผลลัพธ์จะแสดงการเปลี่ยนแปลงและแจ้งให้คุณรีสตาร์ทบริการ WinRM การตอบสนองคือ y (ใช่)

Get-PSSessionConfiguration รับการกำหนดค่าเซสชัน MaintenanceShell ตัวดำเนินการไปป์ไลน์ (|) ส่งผลลัพธ์ของคำสั่งไปที่ Format-List ซึ่งแสดงคุณสมบัติทั้งหมดของออบเจ็กต์การกำหนดค่าในรายการ ต่อไป โดยใช้ผู้ให้บริการ WSMan เราจะดูพารามิเตอร์การเริ่มต้นสำหรับการกำหนดค่า MaintenanceShell Get-ChildItem รับรายการย่อยในโหนด InitializationParameters สำหรับปลั๊กอิน MaintenanceShell สำหรับข้อมูลเพิ่มเติมเกี่ยวกับผู้ให้บริการ WSMan ให้พิมพ์ รับความช่วยเหลือ wsman

Set-PSSessionConfiguration -Name "MaintenanceShell" -StartupScript "C:\ps-test\Maintenance.ps1"

WSManConfig: Microsoft.WSMan.Management\WSMan::localhost\Plugin\MaintenanceShell\InitializationParameters

ParamName            ParamValue
---------            ----------
startupscript        c:\ps-test\Mainte...

"Restart WinRM service"
WinRM service need to be restarted to make the changes effective. Do you want to run
the command "restart-service winrm"?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): y

Get-PSSessionConfiguration MaintenanceShell | Format-List -Property *

xmlns            : http://schemas.microsoft.com/wbem/wsman/1/config/PluginConfiguration
Name             : MaintenanceShell
Filename         : %windir%\system32\pwrshplugin.dll
SDKVersion       : 1
XmlRenderingType : text
lang             : en-US
PSVersion        : 2.0
startupscript    : c:\ps-test\Maintenance.ps1
ResourceUri      : http://schemas.microsoft.com/powershell/MaintenanceShell
SupportsOptions  : true
ExactMatch       : true
Capability       : {Shell}
Permission       :

Get-ChildItem WSMan:\localhost\Plugin\MaintenanceShell\InitializationParameters

ParamName     ParamValue
---------     ----------
PSVersion     2.0
startupscript c:\ps-test\Maintenance.ps1

พารามิเตอร์

-AccessMode

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

<รหัส>ปิดการใช้งาน ปิดใช้งานการกำหนดค่าเซสชัน ไม่สามารถใช้สำหรับการเข้าถึงคอมพิวเตอร์จากระยะไกลหรือภายในเครื่องได้ ค่านี้จะตั้งค่าคุณสมบัติ เปิดใช้งาน ของการกำหนดค่าเซสชัน (WSMan:\\PlugIn\\Enabled) เป็น False
<รหัส>ท้องถิ่น เพิ่มรายการ Network_Deny_All ให้กับตัวบอกความปลอดภัยของการกำหนดค่าเซสชัน ผู้ใช้คอมพิวเตอร์เฉพาะที่สามารถใช้การกำหนดค่าเซสชันเพื่อสร้างเซสชันย้อนกลับภายในเครื่องบนคอมพิวเตอร์เครื่องเดียวกัน แต่ผู้ใช้ระยะไกลจะถูกปฏิเสธการเข้าถึง
<รหัส>ระยะไกล ลบรายการ Deny_All และ Network_Deny_All ออกจากตัวบอกความปลอดภัยของการกำหนดค่าเซสชัน ผู้ใช้คอมพิวเตอร์ภายในและระยะไกลสามารถใช้การกำหนดค่าเซสชันเพื่อสร้างเซสชันและเรียกใช้คำสั่งบนคอมพิวเตอร์เครื่องนี้

ค่าเริ่มต้นคือ ระยะไกล

cmdlet อื่นๆ สามารถแทนที่ค่าของพารามิเตอร์นี้ได้ในภายหลัง ตัวอย่างเช่น Enable-PSRemoting cmdlet เปิดใช้งานการกำหนดค่าเซสชันทั้งหมดบนคอมพิวเตอร์ และอนุญาตการเข้าถึงระยะไกล และ cmdlet Disable-PSRemoting อนุญาตเฉพาะการเข้าถึงภายในเครื่องเท่านั้นในการกำหนดค่าเซสชันทั้งหมด บนคอมพิวเตอร์

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

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

-ApplicationBase

ระบุเส้นทางของไฟล์แอสเซมบลี (*.dll) ที่ระบุไว้ในค่าของพารามิเตอร์ AssemblyName

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

-AssemblyName

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

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

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

-ConfigurationTypeName

ระบุประเภทของการกำหนดค่าเซสชันที่กำหนดไว้ในแอสเซมบลีในพารามิเตอร์ AssemblyName ประเภทที่คุณระบุต้องใช้คลาส System.Management.Automation.Remoting.PSSessionConfiguration

พารามิเตอร์นี้จำเป็นเมื่อคุณระบุชื่อแอสเซมบลี

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

-Confirm

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

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

-Force

ระงับการแจ้งผู้ใช้ทั้งหมด และเริ่มบริการ WinRM ใหม่โดยไม่แจ้ง การเริ่มบริการใหม่จะทำให้การเปลี่ยนแปลงการกำหนดค่ามีผล

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

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

-MaximumReceivedDataSizePerCommandMB

ระบุขีดจำกัดของจำนวนข้อมูลที่สามารถส่งไปยังคอมพิวเตอร์เครื่องนี้ได้โดยใช้คำสั่งระยะไกลคำสั่งเดียว ป้อนขนาดข้อมูลเป็นเมกะไบต์ (MB) ค่าเริ่มต้นคือ 50

หากมีการกำหนดขีดจำกัดขนาดข้อมูลในประเภทการกำหนดค่าที่ระบุในพารามิเตอร์ ConfigurationTypeName ขีดจำกัดในประเภทการกำหนดค่าจะถูกนำมาใช้ ค่าของพารามิเตอร์นี้จะถูกละเว้น

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

-MaximumReceivedObjectSizeMB

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

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

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

-ModulesToImport

ระบุโมดูลและสแน็ปอินที่นำเข้าโดยอัตโนมัติไปยังเซสชันที่ใช้การกำหนดค่าเซสชัน ป้อนโมดูลและชื่อสแน็ปอิน

ตามค่าเริ่มต้น เฉพาะโมดูล Microsoft.PowerShell.Core เท่านั้นที่จะถูกนำเข้าในเซสชัน แต่ยกเว้นว่า cmdlets จะถูกแยกออก คุณสามารถใช้ Import-Module และ Add- PSSnapin cmdlets เพื่อเพิ่มโมดูลและสแน็ปอินในเซสชัน

โมดูลที่ระบุในค่าพารามิเตอร์นี้จะถูกนำเข้าเพิ่มเติมจากโมดูลที่ระบุในไฟล์การกำหนดค่าเซสชัน (New-PSSessionConfigurationFile) อย่างไรก็ตาม การตั้งค่าในไฟล์การกำหนดค่าเซสชันสามารถซ่อนคำสั่งที่ส่งออกโดยโมดูลหรือป้องกันไม่ให้ผู้ใช้ใช้งานได้

โมดูลที่ระบุในค่าพารามิเตอร์นี้จะแทนที่รายการโมดูลที่ระบุด้วยพารามิเตอร์ ModulesToImport ของ cmdlet Register-PSSessionConfiguration

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

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

-Name

ระบุชื่อของการกำหนดค่าเซสชันที่คุณต้องการเปลี่ยนแปลง

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

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

-NoServiceRestart

ไม่รีสตาร์ทบริการ WinRM และระงับการแจ้งให้เริ่มบริการใหม่

ตามค่าเริ่มต้น เมื่อคุณเรียกใช้ Set-PSSessionConfiguration คุณจะได้รับแจ้งให้รีสตาร์ทบริการ WinRM เพื่อให้การกำหนดค่าเซสชันใหม่มีประสิทธิภาพ จนกว่าจะเริ่มบริการ WinRM ใหม่ การกำหนดค่าเซสชันใหม่จะไม่มีผล

หากต้องการเริ่มบริการ WinRM ใหม่โดยไม่แจ้ง ให้ใช้พารามิเตอร์ Force หากต้องการรีสตาร์ทบริการ WinRM ด้วยตนเอง ให้ใช้ Restart-Service cmdlet

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

-Path

ระบุเส้นทางของไฟล์การกำหนดค่าเซสชัน (.pssc) เช่น ไฟล์ที่สร้างโดย cmdlet New-PSSessionConfigurationFile หากคุณละเว้นเส้นทาง ค่าเริ่มต้นจะเป็นไดเร็กทอรีปัจจุบัน

สำหรับข้อมูลเกี่ยวกับวิธีการแก้ไขไฟล์การกำหนดค่าเซสชัน โปรดดูหัวข้อวิธีใช้สำหรับ cmdlet New-PSSessionConfigurationFile

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

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

-PSVersion

ระบุเวอร์ชันของ PowerShell ในเซสชันที่ใช้การกำหนดค่าเซสชันนี้

ค่าของพารามิเตอร์นี้มีความสำคัญมากกว่าค่าของคีย์ PowerShellVersion ในไฟล์การกำหนดค่าเซสชัน

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

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

-RunAsCredential

ระบุข้อมูลรับรองสำหรับคำสั่งในเซสชัน ตามค่าเริ่มต้น คำสั่งจะทำงานโดยมีสิทธิ์ของผู้ใช้ปัจจุบัน

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

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

-SecurityDescriptorSddl

ระบุสตริง Security Descriptor Definition Language (SDDL) อื่นสำหรับการกำหนดค่า

สตริงนี้กำหนดสิทธิ์ที่จำเป็นในการใช้การกำหนดค่าเซสชันใหม่ หากต้องการใช้การกำหนดค่าเซสชันในเซสชัน ผู้ใช้ต้องมีสิทธิ์ Execute(Inrigge) เป็นอย่างน้อยสำหรับการกำหนดค่า

หากต้องการใช้ตัวบอกความปลอดภัยเริ่มต้นสำหรับการกำหนดค่า ให้ป้อนสตริงว่าง ("") หรือค่า $Null ค่าเริ่มต้นคือ SDDL รูทในไดรฟ์ WSMan:

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

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

-SessionTypeOption

ระบุตัวเลือกเฉพาะประเภทสำหรับการกำหนดค่าเซสชัน ป้อนออบเจ็กต์ตัวเลือกประเภทเซสชัน เช่น ออบเจ็กต์ PSWorkflowExecutionOption ที่ cmdlet New-PSWorkflowExecutionOption ส่งคืน

ตัวเลือกของเซสชันที่ใช้การกำหนดค่าเซสชันจะถูกกำหนดโดยค่าของตัวเลือกเซสชันและตัวเลือกการกำหนดค่าเซสชัน เว้นแต่จะระบุไว้ ตัวเลือกที่ตั้งค่าไว้ในเซสชัน เช่น ด้วย cmdlet New-PSSessionOption จะมีความสำคัญเหนือกว่าตัวเลือกที่ตั้งค่าในการกำหนดค่าเซสชัน อย่างไรก็ตาม ค่าตัวเลือกเซสชันต้องไม่เกินค่าสูงสุดที่ตั้งไว้ในการกำหนดค่าเซสชัน

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

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

-ShowSecurityDescriptorUI

เมื่อใช้พารามิเตอร์นี้ cmdlet จะเปิดแผ่นคุณสมบัติที่ช่วยคุณสร้าง SDDL ใหม่สำหรับการกำหนดค่าเซสชัน แผ่นคุณสมบัติปรากฏขึ้นหลังจากที่คุณเรียกใช้คำสั่ง Set-PSSessionConfiguration จากนั้นเริ่มบริการ WinRM ใหม่

เมื่อคุณตั้งค่าสิทธิ์ในการกำหนดค่า โปรดจำไว้ว่าผู้ใช้ต้องมีสิทธิ์ Execute(Inake) เป็นอย่างน้อยจึงจะใช้การกำหนดค่าเซสชันในเซสชันได้

คุณไม่สามารถใช้พารามิเตอร์ SecurityDescriptorSDDL และพารามิเตอร์นี้ในคำสั่งเดียวกัน

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

-StartupScript

ระบุสคริปต์เริ่มต้นสำหรับการกำหนดค่า ป้อนเส้นทางแบบเต็มของสคริปต์ PowerShell สคริปต์ที่ระบุทำงานในเซสชันใหม่ที่ใช้การกำหนดค่าเซสชัน

หากต้องการลบสคริปต์เริ่มต้นออกจากการกำหนดค่าเซสชัน ให้ป้อนสตริงว่าง ("") หรือค่า $Null

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

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

-ThreadApartmentState

ระบุสถานะอพาร์ทเมนต์ของโมดูลเธรดที่จะใช้ ค่าที่ยอมรับได้คือ:

Unknown

MTA

STA

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

-ThreadOptions

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

Default

ReuseThread

UseCurrentThread

UseNewThread

ค่าเริ่มต้นคือ UseCurrentThread

สำหรับข้อมูลเพิ่มเติม โปรดดูการแจงนับ PSThreadOptions

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

-TransportOption

ระบุตัวเลือกการขนส่งสำหรับการกำหนดค่าเซสชัน ป้อนวัตถุตัวเลือกการขนส่ง เช่นวัตถุ WSManConfigurationOption ที่ cmdlet New-PSTransportOption ส่งกลับ

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

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

-UseSharedProcess

ใช้เพียงกระบวนการเดียวในการโฮสต์เซสชันทั้งหมดที่เริ่มต้นโดยผู้ใช้คนเดียวกัน และใช้การกำหนดค่าเซสชันเดียวกัน ตามค่าเริ่มต้น แต่ละเซสชันจะโฮสต์อยู่ในกระบวนการของตัวเอง

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

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

-WhatIf

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

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

อินพุต

ไม่มี

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

เอาท์พุต

WSManConfigLeafElement

หมายเหตุ

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

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

Set-PSSessionConfiguration cmdlet ไม่เปลี่ยนชื่อการกำหนดค่าและผู้ให้บริการ WSMan ไม่สนับสนุน cmdlet Rename-Item หากต้องการเปลี่ยนชื่อการกำหนดค่าเซสชัน ให้ใช้ Unregister-PSSessionConfiguration cmdlet เพื่อลบการกำหนดค่า จากนั้นใช้ cmdlet Register-PSSessionConfiguration เพื่อสร้างและลงทะเบียนการกำหนดค่าเซสชันใหม่

คุณสามารถใช้ Set-PSSessionConfiguration cmdlet เพื่อเปลี่ยนการกำหนดค่าเซสชันเริ่มต้นของ Microsoft.PowerShell และ Microsoft.PowerShell32 พวกเขาไม่ได้รับการปกป้อง หากต้องการเปลี่ยนกลับเป็นเวอร์ชันดั้งเดิมของการกำหนดค่าเซสชันเริ่มต้น ให้ใช้ cmdlet Unregister-PSSessionConfiguration เพื่อลบการกำหนดค่าเซสชันเริ่มต้น จากนั้นใช้ cmdlet Enable-PSRemoting เพื่อคืนค่า

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

คุณสามารถใช้คำสั่งในไดรฟ์ WSMan: เพื่อเปลี่ยนคุณสมบัติของการกำหนดค่าเซสชัน อย่างไรก็ตาม คุณไม่สามารถใช้ไดรฟ์ WSMan: ใน PowerShell 2.0 เพื่อเปลี่ยนคุณสมบัติการกำหนดค่าเซสชันที่นำมาใช้ใน PowerShell 3.0 เช่น OutputBufferingMode คำสั่ง Windows PowerShell 2.0 ไม่สร้างข้อผิดพลาด แต่จะไม่มีประสิทธิภาพ หากต้องการเปลี่ยนคุณสมบัติที่แนะนำใน PowerShell 3.0 ให้ใช้ไดรฟ์ WSMan: ใน PowerShell 3.0 หรือใหม่กว่า

ชุด PSSessionConfiguration (Microsoft.PowerShell.Core)