New-WSManSessionOption
Membuat tabel hash opsi sesi untuk digunakan sebagai parameter input untuk cmdlet WS-Management.
Sintaks
Default (Default)
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-WSManInstanceSet-WSManInstanceInvoke-WSManActionConnect-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
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.
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: | False |
| Nilai dari argumen yang tersisa: | False |
-OperationTimeout
Menentukan waktu habis, dalam milidetik, untuk operasi WS-Management.
Properti parameter
| Jenis: | Int32 |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | OperationTimeoutMSec |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | 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.
Properti parameter
| Jenis: | ProxyAccessType |
| Nilai default: | None |
| Nilai yang diterima: | ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | 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.
Properti parameter
| Jenis: | ProxyAuthentication |
| Nilai default: | None |
| Nilai yang diterima: | Negotiate, Basic, Digest |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-ProxyCredential
Menentukan akun pengguna yang memiliki izin untuk mendapatkan akses melalui proksi Web perantara.
Properti parameter
| Jenis: | PSCredential |
| 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: | False |
| Nilai dari argumen yang tersisa: | 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.
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: | False |
| Nilai dari argumen yang tersisa: | 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.
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: | False |
| Nilai dari argumen yang tersisa: | False |
-SkipRevocationCheck
Menunjukkan bahwa koneksi tidak memvalidasi status pencabutan pada sertifikat server.
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: | False |
| Nilai dari argumen yang tersisa: | 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.
Properti parameter
| Jenis: | Int32 |
| 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: | False |
| Nilai dari argumen yang tersisa: | False |
-UseUTF16
Menunjukkan bahwa koneksi mengodekan permintaan dalam format UTF16 alih-alih format UTF8. Defaultnya adalah pengodean UTF8.
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: | False |
| 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.
Output
SessionOption
Cmdlet ini mengembalikan opsi sesi WSMan yang dibuat sebagai objek SessionOption.
