Metode WSMan.CreateSession

Artikel
06/13/2023

Membuat objek Sesi yang kemudian dapat digunakan untuk operasi jaringan berikutnya.

Sintaks

WSMan.CreateSession( _
  [ ByVal connection ], _
  [ ByVal flags ], _
  [ ByVal connectionOptions ] _
)

Parameter

connection [in, opsional]

Protokol dan layanan yang akan disambungkan, termasuk IPv4 atau IPv6. Format informasi koneksi adalah sebagai berikut: <Akhiran>Alamat><Transportasi><. Misalnya, lihat Komentar. Jika tidak ada informasi koneksi yang disediakan, komputer lokal akan digunakan.

bendera [in, opsional]

Bendera sesi yang menentukan metode autentikasi, seperti Negosiasi autentikasi atau Autentikasi hash, untuk menyambungkan ke komputer jarak jauh. Bendera ini juga menentukan informasi koneksi sesi lainnya, seperti pengodean atau enkripsi. Parameter ini harus berisi satu atau beberapa bendera di __WSManSessionFlags untuk koneksi jarak jauh. Untuk informasi selengkapnya, lihat Konstanta Sesi. Tidak diperlukan pengaturan bendera untuk koneksi ke WinRM di komputer lokal. Defaultnya adalah WSManFlagUseNegotiate.

Untuk informasi selengkapnya, lihat Autentikasi untuk Koneksi Jarak Jauh dan parameter connectionOptions .

connectionOptions [in, opsional]

Penunjuk ke objek ConnectionOptions yang berisi nama pengguna dan kata sandi. Defaultnya adalah NULL.

Nilai kembali

Objek Sesi yang kemudian dapat digunakan untuk melakukan operasi WinRM lokal atau jarak jauh.

Keterangan

Metode CreateSession menginisialisasi objek Sesi dengan mengumpulkan parameter, seperti bendera, kredensial, dan string koneksi untuk parameter koneksi . CreateSession sebenarnya tidak tersambung ke komputer lokal atau jarak jauh. Jika koneksi tidak dapat dibuat, kegagalan terjadi pada operasi Sesi pertama, seperti Dapatkan atau Hitung, setelah panggilan ke CreateSession. Perilaku ini berbeda dari koneksi WMI ke namespace pada komputer jarak jauh. Untuk informasi selengkapnya, lihat Manajemen Jarak Jauh Windows dan WMI.

Contoh kode VBScript berikut digunakan untuk memanggil metode ini.

Set session = _
    wsman.CreateSession("<Transport><Address><Suffix>")

Contoh berikut menunjukkan berbagai format yang digunakan untuk menentukan informasi koneksi dalam parameter koneksi (saat membuat sesi HTTPS, < bidang Alamat> harus cocok dengan nama sertifikat komputer server, jika tidak, kegagalan terjadi):

"https://service"

Menggunakan HTTPS untuk menyambungkan ke lokasi layanan web default.
"https://service.corp.com/websvcs/wsman"

Menggunakan HTTPS untuk menyambungkan ke lokasi layanan web tertentu.
"https://[E3D7:0000:0000:0000:51F4:9BC8:C0A8:6420]"

Menggunakan HTTPS dan IPv6 dengan port default.
"https://[E3D7:0000:0000:0000:51F4:9BC8:C0A8:6420]:9999/wsman"

Menggunakan HTTPS dan IPv6 dengan port yang diberikan.

Contoh

Contoh kode VBScript berikut membuat sesi di komputer lokal.

 Set NewSession = Wsman.CreateSession

Contoh kode VBScript berikut membuat sesi di komputer jarak jauh yang diidentifikasi oleh alamat IP. Skrip ini menyediakan nama pengguna dan kata sandi untuk akun. Bendera WSManFlagCredUserNamePassword dan WSManFlagUseBasic digabungkan untuk menunjukkan bahwa akun tersebut adalah akun lokal di komputer jarak jauh. Jika pembuatan sesi gagal, skrip akan berakhir. Skrip menggunakan metode yang mengembalikan konstanta, seperti WSMan.SessionFlagUseBasic.

Untuk menjalankan skrip ini, ketahuilah bahwa Anda harus mengonfigurasi pengaturan konfigurasi default untuk klien dan server untuk memungkinkan lalu lintas yang tidak terenkripsi dan autentikasi Dasar (AllowUnencrypted diatur ke True dan Basic diatur ke True). Untuk informasi selengkapnya, lihat Penginstalan dan Konfigurasi untuk Manajemen Jarak Jauh Windows.

iFlags = WSMan.SessionFlagUseBasic Or WSMan.SessionFlagCredUsernamePassword
Set Options = Wsman.CreateConnectionOptions
Options.Username = "MyUserName"
Options.Password = "MyPassword"
Set NewSession = WSMan.CreateSession("127.0.51.1", iFlags, _
    Options)

Dalam contoh kode VBScript berikut, akun tersebut adalah akun domain dan Autentikasi negosiasi digunakan. Dengan Negosiasi autentikasi, Anda harus menentukan nama pengguna sebagai computername\username atau ipaddress\username.

iFlags = WSMan.SessionFlagUseNegotiate Or WSMan.SessionFlagCredUsernamePassword
Set Options = Wsman.CreateConnectionOptions
Options.Username = "MyComputer\MyUserName"
Options.Password = "MyPassword"
Set NewSession = WSMan.CreateSession("127.0.51.1", iFlags, _
    Options)

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Header	WSManDisp.h
IDL	WSManDisp.idl
Pustaka	WSManDisp.tlb
DLL	WSMAuto.dll

Lihat juga

WSMan
ConnectionOptions
Sesi
Autentikasi untuk Sambungan Jarak Jauh
Penginstalan dan Konfigurasi untuk Manajemen Jarak Jauh Windows