New-CimSession

  • Referensi
Modul:
CimCmdlets

Membuat sesi CIM.

Sintaks

New-CimSession
   [-Authentication <PasswordAuthenticationMechanism>]
   [[-Credential] <PSCredential>]
   [[-ComputerName] <String[]>]
   [-Name <String>]
   [-OperationTimeoutSec <UInt32>]
   [-SkipTestConnection]
   [-Port <UInt32>]
   [-SessionOption <CimSessionOptions>]
   [<CommonParameters>]
New-CimSession
   [-CertificateThumbprint <String>]
   [[-ComputerName] <String[]>]
   [-Name <String>]
   [-OperationTimeoutSec <UInt32>]
   [-SkipTestConnection]
   [-Port <UInt32>]
   [-SessionOption <CimSessionOptions>]
   [<CommonParameters>]

Deskripsi

Cmdlet ini hanya tersedia di platform Windows.

New-CimSession Cmdlet 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 buat 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 yang mudah diingat ke sesi baru, dengan menentukan Nama.

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 Autentikasi.

New-CimSession -ComputerName Server01 -Credential $cred -Authentication Negotiate

Anda dapat membuat objek PSCredential menggunakan Get-Credential cmdlet.

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:

  • Default
  • digest
  • Negosiasi
  • Dasar
  • Kerberos
  • NtlmDomain
  • CredSsp

Anda tidak dapat menggunakan tipe autentikasi NtlmDomain untuk koneksi ke komputer lokal. Autentikasi CredSSP hanya tersedia di Windows Vista, Windows Server 2008, dan versi Windows yang lebih baru.

Perhatian

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.

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

-CertificateThumbprint

Menentukan sertifikat kunci publik digital (X.509) dari akun pengguna yang memiliki izin untuk melakukan tindakan ini. Masukkan thumbprint sertifikat 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 Get-Item cmdlet atau Get-ChildItem di Penyedia Sertifikat PowerShell.

Untuk informasi selengkapnya, lihat about_Certificate_Provider.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Credential

Menentukan akun pengguna yang memiliki izin untuk melakukan tindakan ini. Jika Kredensial tidak ditentukan, akun pengguna saat ini akan digunakan.

Tentukan nilai untuk Kredensial menggunakan salah satu format berikut:

  • Nama pengguna: "User01"
  • Nama domain dan nama pengguna: "Domain01\User01"
  • Nama prinsipal pengguna: "User@Domain.com"
  • Objek PSCredential, seperti yang dikembalikan oleh Get-Credential cmdlet.

Saat Anda mengetik nama pengguna, Anda akan dimintai kata sandi.

Type:PSCredential
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 tersambung kembali.

Type:UInt32
Aliases:OT
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 kecuali Anda harus. Pengaturan port dalam perintah berlaku untuk semua komputer atau sesi tempat perintah dijalankan. Pengaturan port alternatif mungkin mencegah perintah berjalan pada semua komputer.

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

-SessionOption

Mengatur opsi tingkat lanjut untuk sesi CIM baru. Masukkan nama objek CimSessionOption yang dibuat menggunakan New-CimSessionOption cmdlet.

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

-SkipTestConnection

Secara default, New-CimSession cmdlet membuat koneksi dengan titik akhir WS-Management jarak jauh karena dua alasan: untuk memverifikasi bahwa server jarak jauh mendengarkan pada 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 SkipTest Koneksi ion jika titik akhir WS-Management jarak jauh tidak dapat menggunakan WS-Identifi, atau untuk mengurangi beberapa waktu transmisi data.

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

CimSession

Cmdlet ini mengembalikan objek sesi CIM.

Catatan

PowerShell menyertakan alias berikut untuk New-CimSession:

  • Windows:
    • ncms

Cmdlet ini hanya tersedia di platform Windows.