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
. Konten 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 |
Required: | False |
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 |
Required: | False |
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 |
Required: | False |
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 |
Required: | False |
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 mengizinkan objek lain untuk 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 |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoEncryption
Menentukan bahwa enkripsi data dimatikan.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | False |
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 |
Required: | False |
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 |
Required: | True |
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 |
Required: | False |
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 |
Required: | False |
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 |
Required: | False |
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 |
Required: | False |
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 |
Required: | False |
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 |
Required: | False |
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 |
Required: | False |
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 |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Input
None
Anda tidak dapat menyalurkan objek ke cmdlet ini.
Output
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.
Link Terkait
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk