New-WSManSessionOption
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.
New-WSManSessionOption
Cmdlet 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 $a
variabel. 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 $a
variabel ke Connect-WSMan
. Kemudian, Connect-WSMan
menyambungkan 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OperationTimeout
Menentukan waktu habis, dalam milidetik, untuk operasi WS-Management.
Type: | Int32 |
Aliases: | OperationTimeoutMSec |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | ProxyAccessType |
Accepted values: | ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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
- Bernegosiasi 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.
Type: | ProxyAuthentication |
Accepted values: | Negotiate, Basic, Digest |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProxyCredential
Menentukan akun pengguna yang memiliki izin untuk mendapatkan akses melalui proksi Web perantara.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipRevocationCheck
Menunjukkan bahwa koneksi tidak memvalidasi status pencabutan pada sertifikat server.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseUTF16
Menunjukkan bahwa koneksi mengodekan permintaan dalam format UTF16 alih-alih format UTF8. Defaultnya adalah pengodean UTF8.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Output
Cmdlet ini mengembalikan opsi sesi WSMan yang dibuat sebagai objek SessionOption .
Link Terkait
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk