New-CimSession
Membuat sesi CIM.
Sintaks
CredentialParameterSet (Default)
New-CimSession
[[-Credential] <PSCredential>]
[[-ComputerName] <String[]>]
[-Authentication <PasswordAuthenticationMechanism>]
[-Name <String>]
[-OperationTimeoutSec <UInt32>]
[-SkipTestConnection]
[-Port <UInt32>]
[-SessionOption <CimSessionOptions>]
[<CommonParameters>]
CertificateParameterSet
New-CimSession
[[-ComputerName] <String[]>]
[-CertificateThumbprint <String>]
[-Name <String>]
[-OperationTimeoutSec <UInt32>]
[-SkipTestConnection]
[-Port <UInt32>]
[-SessionOption <CimSessionOptions>]
[<CommonParameters>]
Deskripsi
Cmdlet ini hanya tersedia di platform Windows.
Cmdlet New-CimSession membuat sesi CIM. Sesi CIM adalah objek sisi klien yang mewakili koneksi ke komputer lokal atau komputer jarak jauh. Sesi CIM berisi informasi tentang koneksi, seperti ComputerName, protokol yang digunakan, atau berbagai pengidentifikasi.
Cmdlet ini mengembalikan objek sesi CIM yang dapat digunakan oleh semua cmdlet CIM lainnya.
Contoh
Contoh 1: Membuat sesi CIM dengan opsi default
Contoh ini membuat sesi CIM lokal dengan opsi default. Jika ComputerName tidak ditentukan, New-CimSession membuat sesi DCOM ke komputer lokal.
New-CimSession
Contoh 2: Membuat sesi CIM ke komputer tertentu
Contoh ini membuat sesi CIM ke komputer yang ditentukan oleh ComputerName.
Secara default, New-CimSession membuat sesi WSMan saat ComputerName ditentukan.
New-CimSession -ComputerName Server01
Contoh 3: Membuat sesi CIM ke beberapa komputer
Contoh ini membuat sesi CIM ke setiap komputer yang ditentukan oleh ComputerName, dalam daftar yang dipisahkan koma.
New-CimSession -ComputerName Server01, Server02, Server03
Contoh 4: Membuat sesi CIM dengan nama yang mudah diingat
Contoh ini membuat sesi CIM jarak jauh ke setiap komputer yang ditentukan oleh ComputerName, dalam daftar yang dipisahkan koma, dan menetapkan nama alias untuk sesi baru dengan menentukan Name.
New-CimSession -ComputerName Server01, Server02 -Name FileServers
Get-CimSession -Name File*
Anda dapat menggunakan nama yang mudah diingat dari sesi CIM untuk merujuk ke sesi di cmdlet CIM lainnya, misalnya, Get-CimSession.
Contoh 5: Membuat sesi CIM ke komputer menggunakan objek PSCredential
Contoh ini membuat sesi CIM ke komputer yang ditentukan oleh ComputerName, menggunakan objek PSCredential yang ditentukan oleh Kredensial, dan jenis autentikasi yang ditentukan oleh Authentication.
New-CimSession -ComputerName Server01 -Credential $cred -Authentication Negotiate
Anda dapat membuat objek PSCredential
Contoh 6: Membuat sesi CIM ke komputer menggunakan port tertentu
Contoh ini membuat sesi CIM ke komputer yang ditentukan oleh ComputerName menggunakan port TCP yang ditentukan oleh Port.
New-CimSession -ComputerName Server01 -Port 1234
Contoh 7: Membuat sesi CIM menggunakan DCOM
Contoh ini membuat sesi CIM menggunakan protokol Distributed COM (DCOM) alih-alih WSMan.
$SessionOption = New-CimSessionOption -Protocol Dcom
New-CimSession -ComputerName Server1 -SessionOption $SessionOption
Parameter
-Authentication
Menentukan jenis autentikasi yang digunakan untuk kredensial pengguna. Nilai yang dapat diterima untuk parameter ini adalah:
- Bawaan
- ringkasan
- Negosiasi
- Dasar
- Kerberos
- NtlmDomain
- CredSsp
Anda tidak dapat menggunakan tipe autentikasi
Caution
Autentikasi Penyedia Layanan Keamanan Kredensial (CredSSP) dirancang untuk perintah yang memerlukan autentikasi pada lebih dari satu sumber daya, seperti mengakses berbagi jaringan jarak jauh. Mekanisme ini meningkatkan risiko keamanan operasi jarak jauh. Jika komputer jarak jauh disusupi, kredensial yang diteruskan ke komputer jarak jauh dapat digunakan untuk mengontrol sesi jaringan.
Properti parameter
| Jenis: | PasswordAuthenticationMechanism |
| Nilai default: | None |
| Nilai yang diterima: | Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
CredentialParameterSet
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-CertificateThumbprint
Menentukan sertifikat kunci publik digital (X.509) dari akun pengguna yang memiliki izin untuk melakukan tindakan ini. Masukkan sidik jari sertifikat.
Sertifikat digunakan dalam autentikasi berbasis sertifikat klien. Mereka hanya dapat dipetakan ke akun pengguna lokal; mereka tidak bekerja dengan akun domain.
Untuk mendapatkan thumbprint sertifikat, gunakan cmdlet Get-Item atau Get-ChildItem di Penyedia Sertifikat PowerShell.
Untuk informasi lebih lanjut, lihat about_Certificate_Provider.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
CertificateParameterSet
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-ComputerName
Menentukan nama komputer untuk membuat sesi CIM. Tentukan satu nama komputer, atau beberapa nama komputer yang dipisahkan oleh koma.
Jika ComputerName tidak ditentukan, sesi CIM ke komputer lokal dibuat. Anda dapat menentukan nilai untuk nama komputer dalam salah satu format berikut:
- Satu atau beberapa nama NetBIOS
- Satu atau beberapa alamat IP
- Satu atau beberapa nama domain yang sepenuhnya memenuhi syarat.
Jika komputer berada di domain yang berbeda dari pengguna, Anda harus menentukan nama domain yang sepenuhnya memenuhi syarat.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | CN, ServerName |
Kumpulan parameter
(All)
| Position: | 1 |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-Credential
Menentukan akun pengguna yang memiliki izin untuk melakukan tindakan ini. Jika Kredensial tidak ditentukan, akun pengguna saat ini digunakan.
Tentukan nilai untuk Kredensial
- Nama pengguna: "User01"
- Nama domain dan nama pengguna: "Domain01\User01"
- Nama prinsipal pengguna: "User@Domain.com"
- Sebuah objek PSCredential, misalnya yang dikembalikan oleh cmdlet
Get-Credential.
Saat Anda mengetik nama pengguna, Anda akan dimintai kata sandi.
Properti parameter
| Jenis: | PSCredential |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
CredentialParameterSet
| Position: | 2 |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Name
Menentukan nama yang mudah diingat untuk sesi CIM.
Anda dapat menggunakan nama untuk merujuk ke sesi CIM saat menggunakan cmdlet lain, seperti cmdlet Get-CimSession. Nama ini tidak diharuskan unik untuk komputer atau sesi saat ini.
Properti parameter
| Jenis: | String |
| 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 |
-OperationTimeoutSec
Durasi cmdlet menunggu respons dari server.
Secara default, nilai parameter ini adalah 0, yang berarti bahwa cmdlet menggunakan nilai batas waktu default untuk server.
Jika parameter OperationTimeoutSec diatur ke nilai yang kurang dari batas waktu coba lagi koneksi yang kuat selama 3 menit, kegagalan jaringan yang berlangsung lebih dari nilai parameter OperationTimeoutSec tidak dapat dipulihkan, karena operasi pada server habis sebelum klien dapat terhubung kembali.
Properti parameter
| Jenis: | UInt32 |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | OT |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-Port
Menentukan port jaringan pada komputer jarak jauh yang digunakan untuk sambungan ini. Untuk tersambung ke komputer jarak jauh, komputer jarak jauh harus mendengarkan porta yang digunakan koneksi. Port default adalah 5985 (port WinRM untuk HTTP) dan 5986 (port WinRM untuk HTTPS).
Sebelum menggunakan port alternatif, Anda harus mengonfigurasi pendengar WinRM di komputer jarak jauh untuk mendengarkan di port tersebut. Gunakan perintah berikut untuk mengonfigurasi listener:
winrm delete winrm/config/listener?Address=*+Transport=HTTP
winrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number>"}
Jangan gunakan parameter Port
Properti parameter
| Jenis: | UInt32 |
| 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 |
-SessionOption
Mengatur opsi tingkat lanjut untuk sesi CIM baru. Masukkan nama objek
Properti parameter
| Jenis: | CimSessionOptions |
| 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 |
-SkipTestConnection
Secara default, cmdlet New-CimSession membuat koneksi dengan titik akhir WS-Management jarak jauh karena dua alasan: untuk memverifikasi bahwa server jarak jauh mendengarkan nomor port yang ditentukan menggunakan parameter Port, dan untuk memverifikasi kredensial akun yang ditentukan. Verifikasi dilakukan menggunakan operasi WS-Identity standar. Anda dapat menambahkan parameter sakelar SkipTestConnection jika titik akhir WS-Management jarak jauh tidak dapat menggunakan WS-Identify, atau untuk mengurangi waktu transmisi data.
Properti parameter
| Jenis: | SwitchParameter |
| 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 |
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
CimSession
Cmdlet ini mengembalikan objek sesi CIM.
Catatan
PowerShell menyertakan alias berikut untuk New-CimSession:
- Windows:
ncms
Cmdlet ini hanya tersedia di platform Windows.
