New-CimSessionOption

Modul:

CimCmdlets Module

Menentukan opsi tingkat lanjut untuk cmdlet New-CimSession.

Sintaks

ProtocolTypeSet (Default)

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

WSManParameterSet

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

DcomParameterSet

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

Properti parameter

Jenis:	CultureInfo
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-EncodePortInServicePrincipalName

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

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

WSManParameterSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-Encoding

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

Properti parameter

Jenis:	PacketEncoding
Nilai default:	None
Nilai yang diterima:	Default, Utf8, Utf16
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

WSManParameterSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-HttpPrefix

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

Properti parameter

Jenis:	Uri
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

WSManParameterSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	ImpersonationType
Nilai default:	None
Nilai yang diterima:	Default, None, Identify, Impersonate, Delegate
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

DcomParameterSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-MaxEnvelopeSizeKB

Menentukan batas ukuran pesan XML WsMan untuk kedua arah.

Properti parameter

Jenis:	UInt32
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

WSManParameterSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-NoEncryption

Menentukan bahwa enkripsi data dimatikan.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

WSManParameterSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

DcomParameterSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

DcomParameterSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Protocol

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

Properti parameter

Jenis:	ProtocolType
Nilai default:	None
Nilai yang diterima:	Dcom, Default, Wsman
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

ProtocolTypeSet

Position:	1
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	PasswordAuthenticationMechanism
Nilai default:	None
Nilai yang diterima:	Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

WSManParameterSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-ProxyCertificateThumbprint

Menentukan sertifikat kunci publik digital (x.509) dari akun pengguna untuk autentikasi proksi. Masukkan sidik jari 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: .

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

WSManParameterSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	PSCredential
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

WSManParameterSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	ProxyType
Nilai default:	InternetExplorer
Nilai yang diterima:	None, WinHttp, Auto, InternetExplorer
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

WSManParameterSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

WSManParameterSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

WSManParameterSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-SkipRevocationCheck

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

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

WSManParameterSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	CultureInfo
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	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.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

WSManParameterSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

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.

Link Terkait

• Get-ChildItem
• Get-Credential
• Get-Culture
• Get-Item
• New-CimSession