Metode WSMan.CreateSession

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: <TransportAddressSuffix><><>. Misalnya, lihat Keterangan. 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.

Mengembalikan nilai

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 Get atau Enumerate, setelah panggilan ke CreateSession. Perilaku ini berbeda dari koneksi WMI ke namespace pada komputer jarak jauh. Untuk informasi selengkapnya, lihat Windows Remote Management 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 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 Windows Manajemen Jarak Jauh.

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