Bagikan melalui


New-PSSessionOption

Membuat objek yang berisi opsi tingkat lanjut untuk PSSession.

Sintaks

New-PSSessionOption
   [-MaximumRedirection <Int32>]
   [-NoCompression]
   [-NoMachineProfile]
   [-Culture <CultureInfo>]
   [-UICulture <CultureInfo>]
   [-MaximumReceivedDataSizePerCommand <Int32>]
   [-MaximumReceivedObjectSize <Int32>]
   [-OutputBufferingMode <OutputBufferingMode>]
   [-MaxConnectionRetryCount <Int32>]
   [-ApplicationArguments <PSPrimitiveDictionary>]
   [-OpenTimeout <Int32>]
   [-CancelTimeout <Int32>]
   [-IdleTimeout <Int32>]
   [-ProxyAccessType <ProxyAccessType>]
   [-ProxyAuthentication <AuthenticationMechanism>]
   [-ProxyCredential <PSCredential>]
   [-SkipCACheck]
   [-SkipCNCheck]
   [-SkipRevocationCheck]
   [-OperationTimeout <Int32>]
   [-NoEncryption]
   [-UseUTF16]
   [-IncludePortInSPN]
   [<CommonParameters>]

Deskripsi

Cmdlet New-PSSessionOption membuat objek yang berisi opsi tingkat lanjut untuk sesi yang dikelola pengguna (PSSession). Anda dapat menggunakan objek sebagai nilai dari parameter SessionOption pada cmdlet yang membuat , PSSession, seperti New-PSSession, Enter-PSSession, dan Invoke-Command.

Tanpa parameter, New-PSSessionOption menghasilkan objek yang berisi nilai default untuk semua opsi. Karena setiap properti dapat diedit, Anda dapat menggunakan objek yang dihasilkan sebagai templat dan membuat objek opsi standar untuk perusahaan Anda.

Anda juga dapat menyimpan objek SessionOption dalam variabel preferensi $PSSessionOption. Nilai variabel ini menetapkan nilai default baru untuk opsi sesi. Mereka efektif ketika tidak ada opsi sesi yang diatur untuk sesi dan lebih diutamakan daripada opsi yang diatur dalam konfigurasi sesi. Namun, Anda dapat menggantinya dengan menentukan opsi sesi atau objek SessionOption dalam cmdlet yang membuat sesi. Untuk informasi selengkapnya tentang variabel preferensi $PSSessionOption, lihat about_Preference_Variables.

Saat Anda menggunakan objek SessionOption dalam cmdlet yang membuat sesi, nilai opsi sesi lebih diutamakan daripada nilai default untuk sesi yang diatur dalam variabel preferensi $PSSessionOption dan dalam konfigurasi sesi. Namun, mereka tidak lebih diutamakan daripada nilai, kuota, atau batas maksimum yang ditetapkan dalam konfigurasi sesi. Untuk informasi selengkapnya tentang konfigurasi sesi, lihat about_Session_Configurations.

Contoh

Contoh 1: Buat opsi sesi default

Perintah ini membuat objek SessionOption dengan nilai default.

New-PSSessionOption

MaximumConnectionRedirectionCount : 5
NoCompression                     : False
NoMachineProfile                  : False
ProxyAccessType                   : IEConfig
ProxyAuthentication               : Negotiate
ProxyCredential                   :
SkipCACheck                       : False
SkipCNCheck                       : False
SkipRevocationCheck               : False
OperationTimeout                  : 00:03:00
NoEncryption                      : False
UseUTF16                          : False
Culture                           :
UICulture                         :
MaximumReceivedDataSizePerCommand :
MaximumReceivedObjectSize         :
ApplicationArguments              :
OpenTimeout                       : 00:03:00
CancelTimeout                     : 00:01:00
IdleTimeout                       : 00:04:00

Contoh 2: Mengonfigurasi sesi dengan menggunakan objek opsi sesi

Contoh ini menunjukkan cara menggunakan objek SessionOption untuk mengonfigurasi sesi.

$pso = New-PSSessionOption -Culture "fr-fr" -MaximumReceivedObjectSize 10MB
New-PSSession -ComputerName Server01 -SessionOption $pso

Perintah pertama membuat objek SessionOption baru dan menyimpannya dalam nilai variabel $pso. Perintah kedua menggunakan cmdlet New-PSSession untuk membuat sesi di komputer jarak jauh Server01. Perintah menggunakan objek SessionOption dalam variabel $pso sebagai nilai dari parameter SessionOption dari perintah.

Contoh 3: Memulai sesi interaktif

Perintah ini menggunakan cmdlet Enter-PSSession untuk memulai sesi interaktif dengan komputer Server01.

Enter-PSSession -ComputerName Server01 -SessionOption (New-PSSessionOption -NoEncryption -NoCompression)

Nilai parameter SessionOption adalah perintah New-PSSessionOption yang memiliki parameter NoEncryption dan NoCompression.

Perintah New-PSSessionOption diapit dalam tanda kurung untuk memastikan bahwa perintah berjalan sebelum perintah Enter-PSSession.

Contoh 4: Mengubah objek opsi sesi

Contoh ini menunjukkan bahwa Anda dapat memodifikasi objek SessionOption. Semua properti memiliki nilai dapat dibaca dan ditulis.

$a = New-PSSessionOption
$a.OpenTimeout

Days              : 0
Hours             : 0
Minutes           : 3
Seconds           : 0
Milliseconds      : 0
Ticks             : 1800000000
TotalDays         : 0.00208333333333333
TotalHours        : 0.05
TotalMinutes      : 3
TotalSeconds      : 180
TotalMilliseconds : 180000

$a.UICulture = (Get-UICulture)
$a.OpenTimeout = (New-Timespan -Minutes 4)
$a.MaximumConnectionRedirectionCount = 1
$a

MaximumConnectionRedirectionCount : 1
NoCompression                     : False
NoMachineProfile                  : False
ProxyAccessType                   : IEConfig
ProxyAuthentication               : Negotiate
ProxyCredential                   :
SkipCACheck                       : False
SkipCNCheck                       : False
SkipRevocationCheck               : False
OperationTimeout                  : 00:03:00
NoEncryption                      : False
UseUTF16                          : False
Culture                           :
UICulture                         : en-US
MaximumReceivedDataSizePerCommand :
MaximumReceivedObjectSize         :
ApplicationArguments              :
OpenTimeout                       : 00:04:00
CancelTimeout                     : 00:01:00
IdleTimeout                       : 00:04:00

Gunakan metode ini untuk membuat objek sesi standar untuk perusahaan Anda, lalu buat versi yang disesuaikan untuk penggunaan tertentu.

Contoh 5: Membuat variabel preferensi

Perintah ini membuat variabel preferensi $PSSessionOption.

$PSSessionOption = New-PSSessionOption -OpenTimeOut 120000

Saat variabel preferensi $PSSessionOption diatur dalam sesi, variabel menetapkan nilai default untuk opsi dalam sesi yang dibuat dengan cmdlet New-PSSession, Enter-PSSession, dan Invoke-Command.

Untuk membuat variabel $PSSessionOption tersedia di semua sesi, tambahkan ke sesi PowerShell Anda dan ke profil PowerShell Anda.

Untuk informasi selengkapnya tentang variabel preferensi $PSSessionOption, lihat about_Preference_Variables. Untuk informasi selengkapnya tentang profil, lihat about_Profiles.

Contoh 6: Memenuhi persyaratan untuk konfigurasi sesi jarak jauh

Contoh ini menunjukkan cara menggunakan objek SessionOption untuk memenuhi persyaratan konfigurasi sesi jarak jauh.

$skipCN = New-PSSessionOption -SkipCNCheck
New-PSSession -ComputerName 171.09.21.207 -UseSSL -Credential Domain01\User01 -SessionOption $SkipCN

Perintah pertama menggunakan cmdlet New-PSSessionOption untuk membuat objek SessionOption yang memiliki properti SkipCNCheck. Perintah menyimpan objek sesi yang dihasilkan dalam variabel $skipCN.

Perintah kedua menggunakan cmdlet New-PSSession untuk membuat sesi baru di komputer jarak jauh. Variabel pemeriksaan $skipCN digunakan dalam nilai parameter SessionOption.

Karena komputer diidentifikasi oleh alamat IP-nya, nilai parameter ComputerName tidak cocok dengan salah satu nama umum dalam sertifikat yang digunakan untuk Secure Sockets Layer (SSL). Akibatnya, opsi SkipCNCheck diperlukan.

Contoh 7: Membuat argumen tersedia untuk sesi jarak jauh

Contoh ini menunjukkan cara menggunakan parameter ApplicationArguments cmdlet New-PSSessionOption untuk membuat data tambahan tersedia untuk sesi jarak jauh.

$team = @{Team="IT"; Use="Testing"}
$TeamOption = New-PSSessionOption -ApplicationArguments $team
$s = New-PSSession -ComputerName Server01 -SessionOption $TeamOption
Invoke-Command -Session $s {$PSSenderInfo.ApplicationArguments}

Name                 Value
----                 -----
Team                 IT
Use                  Testing
PSVersionTable       {CLRVersion, BuildVersion, PSVersion, WSManStackVersion...}

Invoke-Command -Session $s {
  if ($PSSenderInfo.ApplicationArguments.Use -ne "Testing") {
    .\logFiles.ps1
  }
  else {
    "Just testing."
  }
}

Just testing.

Perintah pertama membuat tabel hash dengan dua kunci, Team dan Gunakan. Perintah menyimpan tabel hash dalam variabel $team. Untuk informasi selengkapnya tentang tabel hash, lihat about_Hash_Tables.

Selanjutnya, cmdlet New-PSSessionOption, menggunakan parameter ApplicationArguments, membuat objek SessionOption yang disimpan dalam variabel $team. Saat New-PSSessionOption membuat objek opsi sesi, ia secara otomatis mengonversi tabel hash dalam nilai parameter ApplicationArguments menjadi PrimitiveDictionary sehingga data dapat ditransmisikan secara andal ke sesi jarak jauh.

Cmdlet New-PSSession memulai sesi di komputer Server01. Ini menggunakan parameter SessionOption untuk menyertakan opsi dalam variabel $teamOption.

Cmdlet Invoke-Command menunjukkan bahwa data dalam variabel $team tersedia untuk perintah dalam sesi jarak jauh. Data muncul di properti ApplicationArguments dari variabel otomatis $PSSenderInfo.

Invoke-Command akhir menunjukkan bagaimana data dapat digunakan.

Parameter

-ApplicationArguments

Menentukan PrimitiveDictionary yang dikirim ke sesi jarak jauh. Perintah dan skrip dalam sesi jarak jauh, termasuk skrip startup dalam konfigurasi sesi, dapat menemukan kamus ini pada properti argumen aplikasi dari variabel otomatis $PSSenderInfo. Anda dapat menggunakan parameter ini untuk mengirim data ke sesi jarak jauh.

Untuk informasi selengkapnya, lihat about_Hash_Tables, about_Session_Configurations, dan about_Automatic_Variables.

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

-CancelTimeout

Menentukan berapa lama PowerShell menunggu operasi pembatalan (CTRL+C) selesai sebelum mengakhirinya. Masukkan nilai dalam milidetik.

Nilai defaultnya adalah 60000 (satu menit). Nilai 0 (nol) berarti tidak ada waktu habis; perintah berlanjut tanpa batas waktu.

Jenis:Int32
Alias:CancelTimeoutMSec
Position:Named
Nilai default:60000
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Culture

Menentukan budaya yang akan digunakan untuk sesi tersebut. Masukkan nama budaya dalam format <languagecode2>-<country/regioncode2> (seperti ja-JP), variabel yang berisi objek CultureInfo, atau perintah yang mendapatkan objek CultureInfo.

Nilai default adalah $Null, dan budaya yang diatur dalam sistem operasi digunakan dalam sesi.

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

-IdleTimeout

Menentukan berapa lama sesi tetap terbuka jika komputer jarak jauh tidak menerima komunikasi apa pun dari komputer lokal. Ini termasuk sinyal detak jantung. Saat interval berakhir, sesi ditutup.

Nilai batas waktu diam sangat penting jika Anda ingin memutuskan sambungan dan menyambungkan kembali ke sesi. Anda dapat tersambung kembali hanya jika sesi belum kehabisan waktu.

Masukkan nilai dalam milidetik. Nilai minimum adalah 60000 (1 menit). Maksimum adalah nilai properti MaxIdleTimeoutMs dari konfigurasi sesi. Nilai default, -1, tidak mengatur batas waktu diam.

Sesi menggunakan batas waktu diam yang diatur dalam opsi sesi, jika ada. Jika tidak ada yang diatur (-1), sesi menggunakan nilai IdleTimeoutMs properti konfigurasi sesi atau nilai batas waktu shell WSMan (WSMan:\<ComputerName>\Shell\IdleTimeout), mana yang terpendek.

Jika batas waktu diam yang ditetapkan dalam opsi sesi melebihi nilai MaxIdleTimeoutMs properti konfigurasi sesi, perintah untuk membuat sesi gagal.

Nilai IdleTimeoutMs konfigurasi sesi Microsoft.PowerShell default 7200000 milidetik (2 jam). Nilai MaxIdleTimeoutMs adalah 2147483647 milidetik (>24 hari). Nilai default batas waktu diam shell WSMan (WSMan:\<ComputerName>\Shell\IdleTimeout) adalah 7200000 milidetik (2 jam).

Nilai batas waktu tidak aktif sesi juga dapat diubah saat memutuskan sambungan dari sesi atau menyambungkan kembali ke sesi. Untuk informasi selengkapnya, lihat Disconnect-PSSession dan Connect-PSSession.

Di Windows PowerShell 2.0, nilai default dari parameter IdleTimeout adalah 240000 (4 menit).

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

-IncludePortInSPN

Termasuk nomor port dalam Nama Prinsipal Layanan (SPN) yang digunakan untuk autentikasi Kerberos, misalnya, HTTP://<ComputerName>:5985. Opsi ini memungkinkan klien yang menggunakan SPN non-default untuk mengautentikasi terhadap komputer jarak jauh yang menggunakan autentikasi Kerberos.

Opsi ini dirancang untuk perusahaan di mana beberapa layanan yang mendukung autentikasi Kerberos berjalan di bawah akun pengguna yang berbeda. Misalnya, aplikasi IIS yang memungkinkan autentikasi Kerberos dapat mengharuskan SPN default didaftarkan ke akun pengguna yang berbeda dari akun komputer. Dalam kasus seperti itu, remoting PowerShell tidak dapat menggunakan Kerberos untuk mengautentikasi karena memerlukan SPN yang terdaftar ke akun komputer. Untuk mengatasi masalah ini, administrator dapat membuat SPN yang berbeda, seperti dengan menggunakan Setspn.exe, yang terdaftar ke akun pengguna yang berbeda dan dapat membedakannya dengan menyertakan nomor port di SPN.

Untuk informasi selengkapnya, lihat Gambaran Umum Setspn.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

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

-MaxConnectionRetryCount

Menentukan berapa kali PowerShell mencoba membuat koneksi ke komputer target jika upaya saat ini gagal karena masalah jaringan. Nilai defaultnya adalah 5.

Parameter ini ditambahkan untuk PowerShell versi 5.0.

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

-MaximumReceivedDataSizePerCommand

Menentukan jumlah maksimum byte yang dapat diterima komputer lokal dari komputer jarak jauh dalam satu perintah. Masukkan nilai dalam byte. Secara default, tidak ada batas ukuran data.

Opsi ini dirancang untuk melindungi sumber daya pada komputer klien.

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

-MaximumReceivedObjectSize

Menentukan ukuran maksimum objek yang dapat diterima komputer lokal dari komputer jarak jauh. Opsi ini dirancang untuk melindungi sumber daya pada komputer klien. Masukkan nilai dalam byte.

Di Windows PowerShell 2.0, jika Anda menghilangkan parameter ini, tidak ada batas ukuran objek. Dimulai di Windows PowerShell 3.0, jika Anda menghilangkan parameter ini, nilai defaultnya adalah 209715200 byte (atau 200MB).

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

-MaximumRedirection

Menentukan berapa kali PowerShell mengalihkan koneksi ke Pengidentifikasi Sumber Daya Seragam (URI) alternatif sebelum koneksi gagal. Nilai defaultnya adalah 5. Nilai 0 (nol) mencegah semua pengalihan.

Opsi ini digunakan dalam sesi hanya ketika parameter AllowRedirection digunakan dalam perintah yang membuat sesi.

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

-NoCompression

Menonaktifkan pemadatan paket dalam sesi. Pemadatan menggunakan lebih banyak siklus prosesor, tetapi membuat transmisi lebih cepat.

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

-NoEncryption

Menonaktifkan enkripsi data.

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

-NoMachineProfile

Mencegah pemuatan profil pengguna Windows. Akibatnya, sesi mungkin dibuat lebih cepat, tetapi pengaturan registri khusus pengguna, item seperti variabel lingkungan, dan sertifikat tidak tersedia dalam sesi.

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

-OpenTimeout

Menentukan berapa lama komputer klien menunggu koneksi sesi dibuat. Ketika interval kedaluwarsa, perintah untuk membuat koneksi gagal. Masukkan nilai dalam milidetik.

Nilai defaultnya adalah 180000 (3 menit). Nilai 0 (nol) berarti tidak ada waktu habis; perintah berlanjut tanpa batas waktu.

Jenis:Int32
Alias:OpenTimeoutMSec
Position:Named
Nilai default:180000 (3 minutes)
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-OperationTimeout

Menentukan waktu maksimum WinRM menunggu pengujian koneksi positif dari koneksi langsung sebelum memulai penghentian koneksi. Untuk informasi selengkapnya tentang WinRM, lihat Dokumentasi Pengelolaan Jarak Jauh Windows.

OperationTimeout tidak tidak memberlakukan batas waktu pada perintah atau proses yang berjalan dalam sesi jarak jauh dan tidak memengaruhi protokol jarak jauh lainnya seperti SSH.

Nilai defaultnya adalah 180000 (3 menit). Nilai 0 (nol) berarti tidak ada batas waktu.

Jenis:Int32
Alias:OperationTimeoutMSec
Position:Named
Nilai default:180000 (3 minutes)
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-OutputBufferingMode

Menentukan bagaimana output perintah dikelola dalam sesi yang terputus saat buffer output menjadi penuh.

Jika mode buffering output tidak diatur dalam sesi atau dalam konfigurasi sesi, nilai defaultnya adalah Block. Pengguna juga dapat mengubah mode buffering output saat memutuskan sambungan sesi.

Jika Anda menghilangkan parameter ini, nilai dari OutputBufferingMode dari objek SessionOption adalah None. Nilai Block atau Drop mengambil alih opsi transportasi mode buffering output yang diatur dalam konfigurasi sesi. Nilai yang dapat diterima untuk parameter ini adalah:

  • Block. Ketika buffer output penuh, eksekusi ditangguhkan hingga buffer jelas.
  • Drop. Ketika buffer output penuh, eksekusi berlanjut. Saat output baru disimpan, output terlama dibuang.
  • None. Tidak ada mode buffering output yang ditentukan.

Untuk informasi selengkapnya tentang opsi transportasi mode buffering output, lihat New-PSTransportOption.

Parameter ini diperkenalkan di Windows PowerShell 3.0.

Jenis:OutputBufferingMode
Nilai yang diterima:None, Drop, Block
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ProxyAccessType

Menentukan mekanisme mana yang digunakan untuk menyelesaikan nama host. Nilai yang dapat diterima untuk parameter ini adalah:

  • IEConfig
  • WinHttpConfig
  • AutoDetect
  • NoProxyServer
  • None

Nilai defaultnya adalah None.

Untuk informasi tentang nilai parameter ini, lihat Enumeration ProxyAccessType.

Jenis:ProxyAccessType
Nilai yang diterima:None, IEConfig, WinHttpConfig, AutoDetect, NoProxyServer
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ProxyAuthentication

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

  • Basic
  • Digest
  • Negotiate

Nilai defaultnya adalah Negotiate.

Untuk informasi selengkapnya tentang nilai parameter ini, lihat AuthenticationMechanism Enumeration.

Jenis:AuthenticationMechanism
Nilai yang diterima:Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Position:Named
Nilai default:Negotiate
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ProxyCredential

Menentukan kredensial yang akan digunakan untuk autentikasi proksi. Masukkan variabel yang mengandung objek PSCredential atau sebuah perintah yang memperoleh objek PSCredential , seperti perintah Get-Credential. Jika opsi ini tidak diatur, tidak ada kredensial yang ditentukan.

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 dengan menggunakan mekanisme lain, seperti ketika komputer jarak jauh adalah bagian dari jaringan yang aman secara fisik dan terisolasi atau ketika komputer jarak jauh terdaftar sebagai host tepercaya dalam konfigurasi WinRM.

Jenis:SwitchParameter
Position:Named
Nilai default:False
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. Opsi ini hanya digunakan dalam operasi jarak jauh yang menggunakan protokol HTTPS.

Gunakan opsi ini hanya untuk komputer tepercaya.

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

-SkipRevocationCheck

Tidak memvalidasi status pencabutan sertifikat server.

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

-UICulture

Menentukan budaya UI yang akan digunakan untuk sesi tersebut.

Nilai yang valid meliputi:

  • Nama budaya dalam format <languagecode2>-<country/regioncode2>, seperti ja-JP
  • Variabel yang berisi objek CultureInfo
  • Perintah yang mendapatkan objek CultureInfo, seperti Get-Culture

Nilai defaultnya adalah $null, dan budaya antarmuka pengguna (UI) yang diatur dalam sistem operasi ketika sesi dibuat.

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

-UseUTF16

Menunjukkan bahwa cmdlet ini mengodekan permintaan dalam format UTF16 alih-alih format UTF8.

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

Input

None

Anda tidak dapat menyalurkan objek ke cmdlet ini.

Output

PSSessionOption

Catatan

Jika parameter SessionOption tidak digunakan dalam perintah untuk membuat PSSession, opsi sesi akan ditentukan oleh nilai-nilai properti dari variabel preferensi $PSSessionOption, jika telah diatur. Untuk informasi selengkapnya tentang variabel $PSSessionOption, lihat about_Preference_Variables.

Properti objek konfigurasi sesi bervariasi menurut opsi yang diatur untuk konfigurasi sesi dan nilai opsi tersebut. Selain itu, konfigurasi sesi yang menggunakan file konfigurasi sesi memiliki properti tambahan.