ใหม่ CimSessionOption (CimCmdlets)

ใหม่ CimSessionOption

โมดูล :: CimCmdlets

ระบุตัวเลือกขั้นสูงสำหรับ New-CimSession cmdlet

ไวยากรณ์

New-CimSessionOption
   [-Protocol] <ProtocolType>
   [-UICulture <CultureInfo>]
   [-Culture <CultureInfo>]
   [<CommonParameters>]

New-CimSessionOption
   [-NoEncryption]
   [-SkipCACheck]
   [-SkipCNCheck]
   [-SkipRevocationCheck]
   [-EncodePortInServicePrincipalName]
   [-Encoding <PacketEncoding>]
   [-HttpPrefix <Uri>]
   [-MaxEnvelopeSizeKB <UInt32>]
   [-ProxyAuthentication <PasswordAuthenticationMechanism>]
   [-ProxyCertificateThumbprint <String>]
   [-ProxyCredential <PSCredential>]
   [-ProxyType <ProxyType>]
   [-UseSsl]
   [-UICulture <CultureInfo>]
   [-Culture <CultureInfo>]
   [<CommonParameters>]

New-CimSessionOption
   [-Impersonation <ImpersonationType>]
   [-PacketIntegrity]
   [-PacketPrivacy]
   [-UICulture <CultureInfo>]
   [-Culture <CultureInfo>]
   [<CommonParameters>]

คำอธิบาย

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

New-CimSessionOption cmdlet สร้างอินสแตนซ์ของวัตถุตัวเลือกเซสชัน CIM คุณใช้ออบเจ็กต์ตัวเลือกเซสชัน CIM เป็นอินพุตใน cmdlet New-CimSession เพื่อระบุตัวเลือกสำหรับเซสชัน CIM

cmdlet นี้มีชุดพารามิเตอร์สองชุด ชุดหนึ่งสำหรับตัวเลือก WsMan และชุดหนึ่งสำหรับตัวเลือก Distributed Component Object Model (DCOM) ขึ้นอยู่กับพารามิเตอร์ที่คุณใช้ cmdlet ส่งคืนอินสแตนซ์ของตัวเลือกเซสชัน DCOM หรือส่งคืนตัวเลือกเซสชัน WsMan

ตัวอย่าง

ตัวอย่างที่ 1: สร้างวัตถุตัวเลือกเซสชัน CIM สำหรับ DCOM

ตัวอย่างนี้สร้างออบเจ็กต์ตัวเลือกเซสชัน CIM สำหรับโปรโตคอล DCOM และจัดเก็บไว้ในตัวแปรชื่อ $so เนื้อหาของตัวแปรจะถูกส่งผ่านไปยัง cmdlet New-CimSession New-CimSession จากนั้นสร้างเซสชัน CIM ใหม่ด้วยเซิร์ฟเวอร์ระยะไกลชื่อ Server01 โดยใช้ตัวเลือกที่กำหนดไว้ในตัวแปร

$so = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server01 -SessionOption $so

ตัวอย่างที่ 2: สร้างออบเจ็กต์ตัวเลือกเซสชัน CIM สำหรับ WsMan

ตัวอย่างนี้สร้างออบเจ็กต์ตัวเลือกเซสชัน CIM สำหรับโปรโตคอล WsMan ออบเจ็กต์มีการกำหนดค่าสำหรับโหมดการตรวจสอบสิทธิ์ของ Kerberos ที่ระบุโดยพารามิเตอร์ ProxyAuthentication ข้อมูลรับรองที่ระบุโดยพารามิเตอร์ ProxyCredential และระบุว่าคำสั่ง คือการข้ามการตรวจสอบ CA ข้ามการตรวจสอบ CN และใช้ SSL

New-CimSessionOption -ProxyAuthentication Kerberos -ProxyCredential $cred -SkipCACheck -SkipCNCheck -UseSsl

ตัวอย่างที่ 3: สร้างออบเจ็กต์ตัวเลือกเซสชัน CIM ด้วยวัฒนธรรมที่ระบุ

New-CimSessionOption -Culture Fr-Fr -Protocol Wsman

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

พารามิเตอร์

-Culture

ระบุวัฒนธรรมส่วนติดต่อผู้ใช้ที่จะใช้สำหรับเซสชัน CIM ระบุค่าสำหรับพารามิเตอร์นี้โดยใช้รูปแบบใดรูปแบบหนึ่งต่อไปนี้:

ชื่อวัฒนธรรมในรูปแบบ < languagecode2>- เช่น "EN-US"
ตัวแปรที่มีออบเจ็กต์ CultureInfo
คำสั่งที่ได้รับออบเจ็กต์ CultureInfo เช่น Get-Culture

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

`-EncodePortInServicePrincipalName`

บ่งชี้ว่าการเชื่อมต่อ Kerberos กำลังเชื่อมต่อกับบริการที่มีชื่อบริการหลัก (SPN) รวมถึงหมายเลขพอร์ตบริการ การเชื่อมต่อประเภทนี้ไม่ธรรมดา

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

`-Encoding`

ระบุการเข้ารหัสที่ใช้สำหรับโปรโตคอล WsMan ค่าที่ยอมรับได้สำหรับพารามิเตอร์นี้คือ: ค่าเริ่มต้น, Utf8 หรือ Utf16

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

`-HttpPrefix`

ระบุส่วนของ HTTP URL หลังชื่อคอมพิวเตอร์และหมายเลขพอร์ต การเปลี่ยนแปลงนี้ไม่ใช่เรื่องธรรมดา ตามค่าเริ่มต้น ค่าของพารามิเตอร์นี้คือ /wsman

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

`-Impersonation`

สร้างเซสชัน DCOM ไปยัง Windows Management Instrumentation (WMI) โดยใช้การเลียนแบบ

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

ค่าเริ่มต้น: DCOM สามารถเลือกระดับการเลียนแบบได้โดยใช้อัลกอริทึมการเจรจาต่อรองด้านความปลอดภัยตามปกติ
ไม่มี: ไคลเอนต์ไม่เปิดเผยชื่อไปยังเซิร์ฟเวอร์ กระบวนการเซิร์ฟเวอร์สามารถเลียนแบบไคลเอ็นต์ได้ แต่โทเค็นการเลียนแบบไม่มีข้อมูลใดๆ และไม่สามารถนำมาใช้ได้
ระบุ: อนุญาตให้วัตถุสอบถามข้อมูลประจำตัวของผู้โทร
เลียนแบบ: อนุญาตให้วัตถุใช้ข้อมูลประจำตัวของผู้โทร
มอบหมาย: อนุญาตให้วัตถุอนุญาตให้วัตถุอื่นใช้ข้อมูลประจำตัวของผู้โทร

หากไม่ได้ระบุ การเลียนแบบ cmdlet New-CimSession จะใช้ค่าของ Impersonate

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

`-MaxEnvelopeSizeKB`

ระบุขีดจำกัดขนาดของข้อความ WsMan XML สำหรับทิศทางใดทิศทางหนึ่ง

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

`-NoEncryption`

ระบุว่าการเข้ารหัสข้อมูลถูกปิด

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

`-PacketIntegrity`

ระบุว่าเซสชัน DCOM ที่สร้างให้กับ WMI ใช้ฟังก์ชันการทำงานของ Component Object Model (COM) PacketIntegrity ตามค่าเริ่มต้น เซสชัน CIM ทั้งหมดที่สร้างโดยใช้ DCOM จะมีพารามิเตอร์ PacketIntegrity ตั้งค่าเป็น True

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

`-PacketPrivacy`

สร้างเซสชัน DCOM ไปยัง WMI โดยใช้ COM PacketPrivacy ตามค่าเริ่มต้น เซสชัน CIM ทั้งหมดที่สร้างโดยใช้ DCOM จะมีพารามิเตอร์ PacketPrivacy ตั้งค่าเป็น true

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

`-Protocol`

ระบุโปรโตคอลที่จะใช้ ค่าที่ยอมรับได้สำหรับพารามิเตอร์นี้คือ: DCOM, ค่าเริ่มต้น หรือ Wsman

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

`-ProxyAuthentication`

ระบุวิธีการรับรองความถูกต้องเพื่อใช้สำหรับการแก้ปัญหาพร็อกซี ค่าที่ยอมรับได้สำหรับพารามิเตอร์นี้คือ: ค่าเริ่มต้น, สรุป, เจรจา, พื้นฐาน, Kerberos, NtlmDomain หรือ CredSsp

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

`-ProxyCertificateThumbprint`

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

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

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

`-ProxyCredential`

ระบุข้อมูลรับรองที่จะใช้สำหรับการตรวจสอบสิทธิ์พร็อกซี ป้อนรายการใดรายการหนึ่งต่อไปนี้:

ตัวแปรที่ประกอบด้วยวัตถุ PSCredential
คำสั่งที่ได้รับวัตถุ PSCredential เช่น Get-Credential

หากไม่ได้ตั้งค่าตัวเลือกนี้ คุณจะไม่สามารถระบุข้อมูลรับรองใดๆ ได้

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

`-ProxyType`

ระบุกลไกการแก้ไขชื่อโฮสต์ที่จะใช้ ค่าที่ยอมรับได้สำหรับพารามิเตอร์นี้คือ: ไม่มี, WinHttp, อัตโนมัติ หรือ InternetExplorer

ค่าเริ่มต้นของพารามิเตอร์นี้คือ InternetExplorer

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

`-SkipCACheck`

ระบุว่าเมื่อเชื่อมต่อผ่าน HTTPS ไคลเอ็นต์ไม่ได้ตรวจสอบว่าใบรับรองเซิร์ฟเวอร์ลงนามโดยผู้ออกใบรับรองที่เชื่อถือได้ (CA)

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

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

`-SkipCNCheck`

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

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

`-SkipRevocationCheck`

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

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

`-UICulture`

ระบุวัฒนธรรมส่วนติดต่อผู้ใช้ที่จะใช้สำหรับเซสชัน CIM ระบุค่าสำหรับพารามิเตอร์นี้โดยใช้รูปแบบใดรูปแบบหนึ่งต่อไปนี้:

ชื่อวัฒนธรรมในรูปแบบ < languagecode2>- เช่น "EN-US"
ตัวแปรที่ประกอบด้วยวัตถุ CultureInfo
คำสั่งที่ได้รับวัตถุ CultureInfo เช่น Get-Culture

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

`-UseSsl`

บ่งชี้ว่าควรใช้ SSL เพื่อสร้างการเชื่อมต่อกับคอมพิวเตอร์ระยะไกล ตามค่าเริ่มต้น จะไม่มีการใช้ SSL WsMan เข้ารหัสเนื้อหาทั้งหมดที่ส่งผ่านเครือข่าย แม้ว่าจะใช้ HTTP ก็ตาม

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

ขอแนะนำให้คุณใช้พารามิเตอร์นี้เมื่อไม่ได้ระบุพารามิเตอร์ PacketPrivacy เท่านั้น

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

`อินพุต`

ไม่มี

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

`เอาท์พุต`

CimSessionOptions

cmdlet นี้ส่งคืนวัตถุที่ประกอบด้วยข้อมูลตัวเลือกเซสชัน CIM

`หมายเหตุ`

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

Windows:

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