Bagikan melalui

New-WSManSessionOption

  • Referensi
Modul:
Microsoft.WSMan.Management

Membuat tabel hash opsi sesi untuk digunakan sebagai parameter input untuk cmdlet WS-Management.

Sintaks

New-WSManSessionOption
   [-ProxyAccessType <ProxyAccessType>]
   [-ProxyAuthentication <ProxyAuthentication>]
   [-ProxyCredential <PSCredential>]
   [-SkipCACheck]
   [-SkipCNCheck]
   [-SkipRevocationCheck]
   [-SPNPort <Int32>]
   [-OperationTimeout <Int32>]
   [-NoEncryption]
   [-UseUTF16]
   [<CommonParameters>]

Deskripsi

Cmdlet ini hanya tersedia di platform Windows.

Cmdlet New-WSManSessionOption membuat tabel hash opsi Sesi WSMan yang dapat diteruskan ke cmdlet WSMan:

  • Get-WSManInstance
  • Set-WSManInstance
  • Invoke-WSManAction
  • Connect-WSMan

Contoh

Contoh 1: Membuat koneksi yang menggunakan opsi koneksi

PS C:\> $a = New-WSManSessionOption -OperationTimeout 30000
PS C:\> Connect-WSMan -ComputerName "server01" -SessionOption $a
PS C:\> cd WSMan:
PS WSMan:\> dir

WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan
ComputerName                                  Type
------------                                  ----
localhost                                     Container
server01                                      Container

Contoh ini membuat koneksi ke komputer server01 jarak jauh dengan menggunakan opsi koneksi yang ditentukan oleh New-WSManSessionOption.

Perintah pertama menggunakan New-WSManSessionOption untuk menyimpan sekumpulan opsi pengaturan koneksi dalam variabel $a. Dalam hal ini, opsi sesi mengatur waktu koneksi dari 30 detik (30.000 milidetik).

Perintah kedua menggunakan parameter SessionOption untuk meneruskan kredensial yang disimpan dalam variabel $a untuk Connect-WSMan. Kemudian, Connect-WSMan tersambung ke komputer server01 jarak jauh dengan menggunakan opsi sesi yang ditentukan.

Connect-WSMan umumnya digunakan dalam konteks penyedia WSMan untuk terhubung ke komputer jarak jauh, dalam hal ini komputer server01. Namun, Anda dapat menggunakan cmdlet untuk membuat koneksi ke komputer jarak jauh sebelum Anda mengubah ke penyedia WSMan. Koneksi tersebut muncul di daftar ComputerName.

Parameter

-NoEncryption

Menunjukkan bahwa koneksi tidak menggunakan enkripsi untuk operasi jarak jauh melalui HTTP.

Secara default, lalu lintas yang tidak terenkripsi tidak diaktifkan. Ini harus diaktifkan dalam konfigurasi lokal.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-OperationTimeout

Menentukan waktu habis, dalam milidetik, untuk operasi WS-Management.

Jenis:Int32
Alias:OperationTimeoutMSec
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ProxyAccessType

Menentukan mekanisme tempat server proksi berada. Nilai yang dapat diterima untuk parameter ini adalah:

  • ProxyIEConfig - Gunakan konfigurasi proksi Internet Explorer untuk pengguna saat ini.
  • ProxyWinHttpConfig - Klien WSMan menggunakan pengaturan proksi yang dikonfigurasi untuk WinHTTP, menggunakan utilitas ProxyCfg.exe.
  • ProxyAutoDetect - Paksa deteksi otomatis server proksi.
  • ProxyNoProxyServer - Jangan gunakan server proksi. Atasi semua nama host secara lokal.

Nilai defaultnya adalah ProxyIEConfig.

Jenis:ProxyAccessType
Nilai yang diterima:ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ProxyAuthentication

Menentukan metode autentikasi yang akan digunakan di proksi. Nilai yang dapat diterima untuk parameter ini adalah:

  • Basic - Dasar adalah skema di mana nama pengguna dan kata sandi dikirim dalam teks yang jelas ke server atau proksi.
  • Digest - Digest adalah skema respons tantangan yang menggunakan string data yang ditentukan server untuk tantangan tersebut.
  • Negotiate - Negosiasi adalah skema respons tantangan yang bernegosiasi dengan server atau proksi untuk menentukan skema mana yang akan digunakan untuk autentikasi. Contohnya adalah protokol Kerberos dan NTLM.

Nilai defaultnya adalah Negosiasi.

Jenis:ProxyAuthentication
Nilai yang diterima:Negotiate, Basic, Digest
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ProxyCredential

Menentukan akun pengguna yang memiliki izin untuk mendapatkan akses melalui proksi Web perantara.

Jenis:PSCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-SkipCACheck

Menentukan bahwa, ketika terhubung melalui HTTPS, klien tidak memvalidasi bahwa sertifikat server ditandatangani oleh otoritas sertifikasi tepercaya (CA). Gunakan opsi ini hanya ketika komputer jarak jauh dipercaya oleh metode lain, misalnya, jika komputer jarak jauh adalah bagian dari jaringan yang aman secara fisik dan terisolasi atau komputer jarak jauh terdaftar sebagai host tepercaya dalam konfigurasi WS-Management.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-SkipCNCheck

Menentukan bahwa nama umum sertifikat (CN) server tidak harus cocok dengan nama host server. Ini hanya digunakan dalam operasi jarak jauh menggunakan HTTPS. Opsi ini hanya boleh digunakan untuk komputer tepercaya.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-SkipRevocationCheck

Menunjukkan bahwa koneksi tidak memvalidasi status pencabutan pada sertifikat server.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-SPNPort

Menentukan nomor port untuk ditambahkan ke Nama Prinsipal Layanan (SPN) koneksi server jarak jauh. SPN digunakan ketika mekanisme autentikasi adalah Kerberos atau Negosiasi.

Jenis:Int32
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-UseUTF16

Menunjukkan bahwa koneksi mengodekan permintaan dalam format UTF16 alih-alih format UTF8. Defaultnya adalah pengodean UTF8.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Output

SessionOption

Cmdlet ini mengembalikan opsi sesi WSMan yang dibuat sebagai objek SessionOption.