New-CimSessionOption

Referensi

Modul:: CimCmdlets

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.

cmdlet New-CimSessionOption membuat instans objek opsi sesi CIM. Anda menggunakan objek opsi sesi CIM sebagai input ke cmdlet New-CimSession 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. Konten variabel kemudian diteruskan ke cmdlet New-CimSession. 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.

$option = @{
    ProxyAuthentication = 'Kerberos'
    ProxyCredential = $cred
    SkipCACheck = $true
    SkipCNCheck = $true
    UseSsl = $true
}
New-CimSessionOption @option

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 format <languagecode2>-<country/regioncode2> seperti "en-US".
Variabel yang berisi objek CultureInfo.
Perintah yang mendapatkan objek CultureInfo, seperti Get-Culture

Jenis:	CultureInfo
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	False

-EncodePortInServicePrincipalName

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

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	False

-Encoding

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

Jenis:	PacketEncoding
Nilai yang diterima:	Default, Utf8, Utf16
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	False

-HttpPrefix

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

Jenis:	Uri
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	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 mengizinkan objek lain untuk menggunakan kredensial pemanggil.

Jika peniruan tidak ditentukan, cmdlet New-CimSession menggunakan nilai Meniru.

Jenis:	ImpersonationType
Nilai yang diterima:	Default, None, Identify, Impersonate, Delegate
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-MaxEnvelopeSizeKB

Menentukan batas ukuran pesan XML WsMan untuk kedua arah.

Jenis:	UInt32
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	False

-NoEncryption

Menentukan bahwa enkripsi data dimatikan.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-PacketIntegrity

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

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-PacketPrivacy

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

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Protocol

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

Jenis:	ProtocolType
Nilai yang diterima:	Dcom, Default, Wsman
Position:	1
Nilai default:	None
Diperlukan:	True
Terima input alur:	True
Terima karakter wildcard:	False

-ProxyAuthentication

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

Jenis:	PasswordAuthenticationMechanism
Nilai yang diterima:	Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	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 cmdlet Get-Item atau Get-ChildItem di drive PowerShell Cert: .

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	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.

Jenis:	PSCredential
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	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.

Jenis:	ProxyType
Nilai yang diterima:	None, WinHttp, Auto, InternetExplorer
Position:	Named
Nilai default:	InternetExplorer
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	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.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	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.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	False

-SkipRevocationCheck

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

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	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 format <languagecode2>-<country/regioncode2> seperti "en-US".
Variabel yang berisi objek CultureInfo.
Perintah yang mendapatkan objek CultureInfo, seperti Get-Culture.

Jenis:	CultureInfo
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	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.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	False

Input

None

Anda tidak dapat menyalurkan objek ke cmdlet ini.

Output

CimSessionOptions

Cmdlet ini mengembalikan objek yang berisi informasi opsi sesi CIM.

Catatan

PowerShell menyertakan alias berikut untuk New-CimSessionOption:

Windows:
- ncso

Cmdlet ini hanya tersedia di platform Windows.

Bagikan melalui