New-CimSessionOption

Menentukan opsi tingkat lanjut untuk cmdlet New-CimSession.

Sintaks

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>]

Deskripsi

Cmdlet ini hanya tersedia di platform Windows.

New-CimSessionOption Cmdlet membuat instans objek opsi sesi CIM. Anda menggunakan objek opsi sesi CIM sebagai input ke New-CimSession cmdlet untuk menentukan opsi untuk sesi CIM.

Cmdlet ini memiliki dua set parameter, satu untuk opsi WsMan dan satu untuk opsi Model Objek Komponen Terdistribusi (DCOM). Bergantung pada parameter mana yang Anda gunakan, cmdlet mengembalikan instans opsi sesi DCOM atau mengembalikan opsi sesi WsMan.

Contoh

Contoh 1: Membuat objek opsi sesi CIM untuk DCOM

Contoh ini membuat objek opsi sesi CIM untuk protokol DCOM dan menyimpannya dalam variabel bernama $so. Isi variabel kemudian diteruskan ke New-CimSession cmdlet . New-CimSession kemudian membuat sesi CIM baru dengan server jarak jauh bernama Server01, menggunakan opsi yang ditentukan dalam variabel .

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

Contoh 2: Membuat objek opsi sesi CIM untuk WsMan

Contoh ini membuat objek opsi sesi CIM untuk protokol WsMan. Objek berisi konfigurasi untuk mode autentikasi Kerberos yang ditentukan oleh parameter ProxyAuthentication , kredensial yang ditentukan oleh parameter ProxyCredential , dan menentukan bahwa perintahnya adalah melewati pemeriksaan CA, melewati pemeriksaan CN, dan menggunakan SSL.

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

Contoh 3: Membuat objek opsi sesi CIM dengan budaya yang ditentukan

New-CimSessionOption -Culture Fr-Fr -Protocol Wsman

Contoh ini menentukan budaya yang digunakan untuk sesi CIM. Secara default, budaya klien digunakan saat melakukan operasi. Namun, budaya default dapat ditimpa menggunakan parameter Budaya .

Parameter

-Culture

Menentukan budaya antarmuka pengguna yang akan digunakan untuk sesi CIM. Tentukan nilai untuk parameter ini menggunakan salah satu format berikut:

  • Nama budaya dalam <languagecode2>-<country/regioncode2> format seperti "EN-US".
  • Variabel yang berisi objek CultureInfo .
  • Perintah yang mendapatkan objek CultureInfo , seperti Get-Culture
Type:CultureInfo
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-EncodePortInServicePrincipalName

Menunjukkan bahwa koneksi Kerberos terhubung ke layanan yang nama perwakilan layanan (SPN) menyertakan nomor port layanan. Jenis koneksi ini tidak umum.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Encoding

Menentukan pengodean yang digunakan untuk protokol WsMan. Nilai yang dapat diterima untuk parameter ini adalah: Default, Utf8, atau Utf16.

Type:PacketEncoding
Accepted values:Default, Utf8, Utf16
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-HttpPrefix

Menentukan bagian URL HTTP setelah nama komputer dan nomor port. Mengubah ini tidak umum. Secara default, nilai parameter ini adalah /wsman.

Type:Uri
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Impersonation

Membuat sesi DCOM ke Windows Management Instrumentation (WMI) menggunakan peniruan identitas.

Nilai yang valid untuk parameter ini adalah:

  • Default: DCOM dapat memilih tingkat peniruan menggunakan algoritma negosiasi keamanan normalnya.
  • Tidak ada: Klien bersifat anonim ke server. Proses server dapat meniru klien, tetapi token peniruan tidak berisi informasi apa pun dan tidak dapat digunakan.
  • Identifikasi: Memungkinkan objek untuk mengkueri kredensial pemanggil.
  • Meniru: Memungkinkan objek untuk menggunakan kredensial pemanggil.
  • Delegasi: Memungkinkan objek untuk mengizinkan objek lain menggunakan kredensial pemanggil.

Jika Peniruan tidak ditentukan, New-CimSession cmdlet menggunakan nilai Impersonate.

Type:ImpersonationType
Accepted values:Default, None, Identify, Impersonate, Delegate
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MaxEnvelopeSizeKB

Menentukan batas ukuran pesan XML WsMan untuk kedua arah.

Type:UInt32
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-NoEncryption

Menentukan bahwa enkripsi data dimatikan.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PacketIntegrity

Menentukan bahwa sesi DCOM yang dibuat untuk WMI menggunakan fungsionalitas PacketIntegrity Model Objek Komponen (COM). Secara default, semua sesi CIM yang dibuat menggunakan DCOM memiliki parameter PacketIntegrity yang diatur ke True.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PacketPrivacy

Membuat sesi DCOM ke WMI menggunakan COM PacketPrivacy. Secara default, semua sesi CIM yang dibuat menggunakan DCOM memiliki parameter PacketPrivacy yang diatur ke true.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Protocol

Menentukan protokol yang akan digunakan. Nilai yang dapat diterima untuk parameter ini adalah: DCOM, Default, atau Wsman.

Type:ProtocolType
Accepted values:Dcom, Default, Wsman
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-ProxyAuthentication

Menentukan metode autentikasi yang akan digunakan untuk resolusi proksi. Nilai yang dapat diterima untuk parameter ini adalah: Default, Digest, Negosiasi, Basic, Kerberos, NtlmDomain, atau CredSsp.

Type:PasswordAuthenticationMechanism
Accepted values:Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-ProxyCertificateThumbprint

Menentukan sertifikat kunci publik digital (x.509) dari akun pengguna untuk autentikasi proksi. Masukkan thumbprint sertifikat sertifikat. Sertifikat digunakan dalam autentikasi berbasis sertifikat klien. Mereka hanya dapat dipetakan ke akun pengguna lokal dan mereka tidak berfungsi dengan akun domain.

Untuk mendapatkan thumbprint sertifikat, gunakan Get-Item cmdlet atau Get-ChildItem di drive PowerShell Cert: .

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-ProxyCredential

Menentukan kredensial yang akan digunakan untuk autentikasi proksi. Masukkan salah satu hal berikut ini:

  • Variabel yang berisi objek PSCredential.
  • Perintah yang mendapatkan objek PSCredential, seperti Get-Credential

Jika opsi ini tidak diatur, maka Anda tidak dapat menentukan kredensial apa pun.

Type:PSCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ProxyType

Menentukan mekanisme resolusi nama host yang akan digunakan. Nilai yang dapat diterima untuk parameter ini adalah: None, WinHttp, Auto, atau InternetExplorer.

Nilai default parameter ini adalah InternetExplorer.

Type:ProxyType
Accepted values:None, WinHttp, Auto, InternetExplorer
Position:Named
Default value:InternetExplorer
Accept pipeline input:True
Accept wildcard characters:False

-SkipCACheck

Menunjukkan bahwa saat menyambungkan melalui HTTPS, klien tidak memvalidasi bahwa sertifikat server ditandatangani oleh otoritas sertifikasi tepercaya (CA).

Gunakan parameter ini hanya ketika komputer jarak jauh dipercaya menggunakan mekanisme lain, seperti ketika komputer jarak jauh adalah bagian dari jaringan yang aman secara fisik dan terisolasi, atau ketika komputer jarak jauh terdaftar sebagai host tepercaya dalam konfigurasi WinRM.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-SkipCNCheck

Menunjukkan bahwa nama umum sertifikat (CN) server tidak perlu cocok dengan nama host server. Gunakan parameter ini untuk operasi jarak jauh hanya dengan komputer tepercaya yang menggunakan protokol HTTPS.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-SkipRevocationCheck

Menunjukkan bahwa pemeriksaan pencabutan untuk sertifikat server dilewati. Gunakan parameter ini hanya untuk komputer tepercaya.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-UICulture

Menentukan budaya antarmuka pengguna yang akan digunakan untuk sesi CIM. Tentukan nilai untuk parameter ini menggunakan salah satu format berikut:

  • Nama budaya dalam <languagecode2>-<country/regioncode2> format seperti "EN-US".
  • Variabel yang berisi objek CultureInfo.
  • Perintah yang mendapatkan objek CultureInfo, seperti Get-Culture.
Type:CultureInfo
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-UseSsl

Menunjukkan bahwa SSL harus digunakan untuk membuat koneksi ke komputer jarak jauh. Secara default, SSL tidak digunakan. WsMan mengenkripsi semua konten yang dikirimkan melalui jaringan, bahkan saat menggunakan HTTP.

Parameter ini memungkinkan Anda menentukan perlindungan tambahan HTTPS alih-alih HTTP. Jika SSL tidak tersedia pada port yang digunakan untuk koneksi dan Anda menentukan parameter ini, maka perintah gagal.

Disarankan agar Anda menggunakan parameter ini hanya ketika parameter PacketPrivacy tidak ditentukan.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

Input

None

Cmdlet ini tidak menerima objek input.

Output

CIMSessionOption

Cmdlet ini mengembalikan objek yang berisi informasi opsi sesi CIM.