Set-PSReadLineOption

  • Referensi
Modul:
PSReadLine

Menyesuaikan perilaku pengeditan baris perintah di PSReadLine.

Sintaks

Set-PSReadLineOption
   [-EditMode <EditMode>]
   [-ContinuationPrompt <string>]
   [-HistoryNoDuplicates]
   [-AddToHistoryHandler <Func[string,Object]>]
   [-CommandValidationHandler <Action[CommandAst]>]
   [-HistorySearchCursorMovesToEnd]
   [-MaximumHistoryCount <int>]
   [-MaximumKillRingCount <int>]
   [-ShowToolTips]
   [-ExtraPromptLineCount <int>]
   [-DingTone <int>]
   [-DingDuration <int>]
   [-BellStyle <BellStyle>]
   [-CompletionQueryItems <int>]
   [-WordDelimiters <string>]
   [-HistorySearchCaseSensitive]
   [-HistorySaveStyle <HistorySaveStyle>]
   [-HistorySavePath <string>]
   [-AnsiEscapeTimeout <int>]
   [-PromptText <string[]>]
   [-ViModeIndicator <ViModeStyle>]
   [-ViModeChangeHandler <scriptblock>]
   [-PredictionSource <PredictionSource>]
   [-PredictionViewStyle <PredictionViewStyle>]
   [-Colors <hashtable>]
   [-TerminateOrphanedConsoleApps]
   [<CommonParameters>]

Deskripsi

Set-PSReadLineOption Cmdlet menyesuaikan perilaku modul PSReadLine saat Anda mengedit baris perintah. Untuk melihat pengaturan PSReadLine , gunakan Get-PSReadLineOption.

Opsi yang diatur oleh perintah ini hanya berlaku untuk sesi saat ini. Untuk mempertahankan opsi apa pun, tambahkan opsi ke skrip profil. Untuk informasi selengkapnya, lihat about_Profiles dan Menyesuaikan lingkungan shell Anda.

Contoh

Contoh 1: Mengatur warna latar depan dan latar belakang

Contoh ini mengatur PSReadLine untuk menampilkan token Komentar dengan teks latar depan hijau di latar belakang abu-abu. Dalam urutan escape yang digunakan dalam contoh, 32 mewakili warna latar depan dan 47 mewakili warna latar belakang.

Set-PSReadLineOption -Colors @{ "Comment"="`e[32;47m" }

Anda dapat memilih untuk mengatur hanya warna teks latar depan. Misalnya, warna teks latar depan hijau cerah untuk token Komentar : "Comment"="`e[92m".

Contoh 2: Mengatur gaya bel

Dalam contoh ini, PSReadLine akan merespons kesalahan atau kondisi yang memerlukan perhatian pengguna. BellStyle diatur untuk memancarkan bip yang dapat didengar pada 1221 Hz selama 60 ms.

Set-PSReadLineOption -BellStyle Audible -DingTone 1221 -DingDuration 60

Catatan

Fitur ini mungkin tidak berfungsi di semua host pada platform.

Contoh 3: Mengatur beberapa opsi

Set-PSReadLineOption dapat mengatur beberapa opsi dengan tabel hash.

$PSReadLineOptions = @{
    EditMode = "Emacs"
    HistoryNoDuplicates = $true
    HistorySearchCursorMovesToEnd = $true
    Colors = @{
        "Command" = "#8181f7"
    }
}
Set-PSReadLineOption @PSReadLineOptions

Tabel $PSReadLineOptions hash mengatur kunci dan nilai. Set-PSReadLineOption menggunakan kunci dan nilai dengan @PSReadLineOptions untuk memperbarui opsi PSReadLine .

Anda dapat melihat kunci dan nilai yang memasukkan nama tabel hash, $PSReadLineOptions pada baris perintah PowerShell.

Contoh 4: Mengatur beberapa opsi warna

Contoh ini menunjukkan cara mengatur lebih dari satu nilai warna dalam satu perintah.

Set-PSReadLineOption -Colors @{
  Command            = 'Magenta'
  Number             = 'DarkGray'
  Member             = 'DarkGray'
  Operator           = 'DarkGray'
  Type               = 'DarkGray'
  Variable           = 'DarkGreen'
  Parameter          = 'DarkGreen'
  ContinuationPrompt = 'DarkGray'
  Default            = 'DarkGray'
}

Contoh 5: Mengatur nilai warna untuk beberapa jenis

Contoh ini menunjukkan tiga metode berbeda untuk cara mengatur warna token yang ditampilkan di PSReadLine.

Set-PSReadLineOption -Colors @{
 # Use a ConsoleColor enum
 "Error" = [ConsoleColor]::DarkRed

 # 24 bit color escape sequence
 "String" = "$([char]0x1b)[38;5;100m"

 # RGB value
 "Command" = "#8181f7"
}

Contoh 6: Gunakan ViModeChangeHandler untuk menampilkan perubahan mode Vi

Contoh ini memancarkan kursor mengubah escape VT sebagai respons terhadap perubahan mode Vi .

function OnViModeChange {
    if ($args[0] -eq 'Command') {
        # Set the cursor to a blinking block.
        Write-Host -NoNewLine "`e[1 q"
    } else {
        # Set the cursor to a blinking line.
        Write-Host -NoNewLine "`e[5 q"
    }
}
Set-PSReadLineOption -ViModeIndicator Script -ViModeChangeHandler $Function:OnViModeChange

Fungsi OnViModeChange mengatur opsi kursor untuk mode Vi : sisipkan dan perintah. ViModeChangeHandler menggunakan Function: penyedia untuk mereferensikan OnViModeChange sebagai objek blok skrip.

Untuk informasi selengkapnya, lihat about_Providers.

Contoh 7: Gunakan HistoryHandler untuk memfilter perintah yang ditambahkan ke riwayat

Contoh berikut menunjukkan cara menggunakan AddToHistoryHandler untuk mencegah penyimpanan perintah git apa pun ke riwayat.

$ScriptBlock = {
    Param([string]$line)

    if ($line -match "^git") {
        return $false
    } else {
        return $true
    }
}

Set-PSReadLineOption -AddToHistoryHandler $ScriptBlock

Blokir skrip mengembalikan $false jika perintah dimulai dengan git. Ini memiliki efek yang sama dengan mengembalikan SkipAddingenum AddToHistory . Jika perintah tidak dimulai dengan git, handler mengembalikan $true dan PSReadLine menyimpan perintah dalam riwayat.

Contoh 8: Gunakan CommandValidationHandler untuk memvalidasi perintah sebelum dijalankan

Contoh ini menunjukkan cara menggunakan parameter CommandValidationHandler untuk menjalankan perintah validasi sebelum dijalankan. Contoh secara khusus memeriksa perintah git dengan sub perintah cmt dan menggantinya dengan nama commitlengkap . Dengan cara ini Anda dapat membuat alias singkat untuk sub-perintah.

# Load the namespace so you can use the [CommandAst] object type
using namespace System.Management.Automation.Language

Set-PSReadLineOption -CommandValidationHandler {
    param([CommandAst]$CommandAst)

    switch ($CommandAst.GetCommandName()) {
        'git' {
            $gitCmd = $CommandAst.CommandElements[1].Extent
            switch ($gitCmd.Text) {
                'cmt' {
                    [Microsoft.PowerShell.PSConsoleReadLine]::Replace(
                        $gitCmd.StartOffset, $gitCmd.EndOffset - $gitCmd.StartOffset, 'commit')
                }
            }
        }
    }
}
# This checks the validation script when you hit enter
Set-PSReadLineKeyHandler -Chord Enter -Function ValidateAndAcceptLine

Contoh 9: Menggunakan parameter PromptText

Ketika ada kesalahan penguraian, PSReadLine mengubah bagian dari perintah merah. Parameter PromptText memberi tahu PSReadLine bagian dari string prompt untuk membuat warna merah.

Misalnya, contoh berikut membuat perintah yang berisi jalur saat ini diikuti oleh karakter yang lebih besar dari (>) dan spasi.

function prompt { "PS $pwd> " }`
Set-PSReadLineOption -PromptText '> ' # change the '>' character red
Set-PSReadLineOption -PromptText '> ', 'X ' # replace the '>' character with a red 'X'

String pertama adalah bagian dari string prompt yang ingin Anda jadikan merah saat ada kesalahan penguraian. String kedua adalah string alternatif yang digunakan ketika ada kesalahan penguraian.

Parameter

-AddToHistoryHandler

Menentukan ScriptBlock yang mengontrol bagaimana perintah ditambahkan ke riwayat PSReadLine.

ScriptBlock menerima baris perintah sebagai input.

ScripBlock harus mengembalikan anggota enum AddToHistoryOption, nama string salah satu anggota tersebut, atau nilai boolean. Daftar di bawah ini menjelaskan kemungkinan nilai dan efeknya.

  • MemoryAndFile - Tambahkan perintah ke file riwayat dan sesi saat ini.
  • MemoryOnly - Tambahkan perintah ke riwayat untuk sesi saat ini saja.
  • SkipAdding - Jangan tambahkan perintah ke file riwayat untuk sesi saat ini.
  • $false - Sama seperti jika nilainya adalah SkipAdding.
  • $true - Sama seperti jika nilainya adalah MemoryAndFile.
Type:Func<T,TResult>[System.String,System.Object]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AnsiEscapeTimeout

Opsi ini khusus untuk Windows ketika input dialihkan, misalnya, saat berjalan di bawah tmux atau screen.

Dengan input yang dialihkan pada Windows, banyak kunci dikirim sebagai urutan karakter yang dimulai dengan karakter escape. Tidak mungkin membedakan antara satu karakter escape diikuti oleh lebih banyak karakter dan urutan escape yang valid.

Asumsinya adalah bahwa terminal dapat mengirim karakter lebih cepat daripada jenis pengguna. PSReadLine menunggu batas waktu ini sebelum menyimpulkan bahwa PSReadLine telah menerima urutan escape lengkap.

Jika Anda melihat karakter acak atau tidak terduga saat mengetik, Anda dapat menyesuaikan batas waktu ini.

Type:Int32
Position:Named
Default value:100
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BellStyle

Menentukan bagaimana PSReadLine merespons berbagai kesalahan dan kondisi ambigu.

Nilai yang valid adalah sebagai berikut:

  • Dapat didengar: Bip pendek.
  • Visual: Teks berkedip sebentar.
  • Tidak ada: Tidak ada umpan balik.
Type:BellStyle
Position:Named
Default value:Audible
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Colors

Parameter Warna menentukan berbagai warna yang digunakan oleh PSReadLine.

Argumen adalah tabel hash di mana kunci menentukan elemen dan nilai menentukan warna. Untuk informasi selengkapnya, lihat about_Hash_Tables.

Warna dapat berupa nilai dari ConsoleColor, misalnya [ConsoleColor]::Red, atau urutan escape ANSI yang valid. Urutan escape yang valid tergantung pada terminal Anda. Di PowerShell 5.0, contoh urutan escape untuk teks merah adalah $([char]0x1b)[91m. Di PowerShell 6 dan yang lebih baru, urutan escape yang sama adalah `e[91m. Anda dapat menentukan urutan escape lainnya termasuk jenis berikut:

Dua pengaturan warna ditambahkan untuk mendukung kustomisasi ListView di PSReadLine 2.2.0:

  • ListPredictionColor - atur warna untuk karakter utama > dan nama sumber berikutnya, seperti [History]. Secara default, ini menggunakan DarkYellow sebagai warna latar depan.

  • ListPredictionSelectedColor - atur warna untuk menunjukkan item daftar dipilih. Secara default, ini menggunakan DarkBlack sebagai warna latar belakang.

  • 256 warna

  • Warna 24-bit

  • Latar depan, latar belakang, atau keduanya

  • Terbalik, tebal

Untuk informasi selengkapnya tentang kode warna ANSI, lihat artikel Wikipedia KODE escape ANSI.

Kunci yang valid meliputi:

  • ContinuationPrompt: Warna prompt kelanjutan.
  • Penekanan: Warna penekanan. Misalnya, teks yang cocok saat mencari riwayat.
  • Kesalahan: Warna kesalahan. Misalnya, dalam perintah.
  • Pilihan: Warna untuk menyoroti pilihan menu atau teks yang dipilih.
  • Default: Warna token default.
  • Komentar: Warna token komentar.
  • Kata kunci: Warna token kata kunci.
  • String: Warna token string.
  • Operator: Warna token operator.
  • Variabel: Warna token variabel.
  • Perintah: Warna token perintah.
  • Parameter: Warna token parameter.
  • Jenis: Warna token jenis.
  • Angka: Warna token angka.
  • Anggota: Warna token nama anggota.
  • InlinePrediction: Warna untuk tampilan sebaris saran prediktif.
  • ListPrediction: Warna untuk karakter utama > dan nama sumber prediksi.
  • ListPredictionSelected: Warna untuk prediksi yang dipilih dalam tampilan daftar.
Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CommandValidationHandler

Menentukan ScriptBlock yang dipanggil dari ValidateAndAcceptLine. Jika pengecualian dilemparkan, validasi gagal dan kesalahan dilaporkan.

Sebelum melemparkan pengecualian, handler validasi dapat menempatkan kursor pada titik kesalahan untuk membuatnya lebih mudah diperbaiki. Handler validasi juga dapat mengubah baris perintah untuk memperbaiki kesalahan tipografi umum.

ValidateAndAcceptLine digunakan untuk menghindari kekacauan riwayat Anda dengan perintah yang tidak dapat berfungsi.

Type:Action<T>[CommandAst]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CompletionQueryItems

Menentukan jumlah maksimum item penyelesaian yang ditampilkan tanpa meminta.

Jika jumlah item yang ditampilkan lebih besar dari nilai ini, PSReadLine akan meminta ya/tidak sebelum menampilkan item penyelesaian.

Type:Int32
Position:Named
Default value:100
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContinuationPrompt

Menentukan string yang ditampilkan di awal baris berikutnya saat input multibaris dimasukkan. Defaultnya adalah tanda ganda lebih besar dari (>>). String kosong valid.

Type:String
Position:Named
Default value:>>
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DingDuration

Menentukan durasi bip saat BellStyle diatur ke Audible.

Type:Int32
Position:Named
Default value:50ms
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DingTone

Menentukan nada di Hertz (Hz) bip ketika BellStyle diatur ke Audible.

Type:Int32
Position:Named
Default value:1221
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EditMode

Menentukan mode pengeditan baris perintah. Menggunakan parameter ini mengatur ulang pengikatan kunci apa pun yang ditetapkan oleh Set-PSReadLineKeyHandler.

Nilai yang valid adalah sebagai berikut:

  • Windows: Pengikatan kunci meniru PowerShell, cmd, dan Visual Studio.
  • Emacs: Pengikatan utama meniru Bash atau Emacs.
  • Vi: Pengikatan kunci meniru Vi.

Gunakan Get-PSReadLineKeyHandler untuk melihat pengikatan kunci untuk EditMode yang saat ini dikonfigurasi.

Type:EditMode
Position:Named
Default value:Windows
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExtraPromptLineCount

Menentukan jumlah baris tambahan.

Jika permintaan Anda mencakup lebih dari satu baris, tentukan nilai untuk parameter ini. Gunakan opsi ini saat Anda ingin baris tambahan tersedia saat PSReadLine menampilkan perintah setelah menampilkan beberapa output. Misalnya, PSReadLine mengembalikan daftar penyelesaian.

Opsi ini diperlukan kurang dari versi PSReadLine sebelumnya, tetapi berguna saat InvokePrompt fungsi digunakan.

Type:Int32
Position:Named
Default value:0
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HistoryNoDuplicates

Opsi ini mengontrol perilaku pengenalan. Perintah duplikat masih ditambahkan ke file riwayat. Saat opsi ini diatur, hanya pemanggilan terbaru yang muncul saat memanggil kembali perintah. Perintah berulang ditambahkan ke riwayat untuk mempertahankan pengurutan selama pengenalan. Namun, Anda biasanya tidak ingin melihat perintah beberapa kali saat memanggil kembali atau mencari riwayat.

Secara default, properti HistoryNoDuplicates dari objek PSConsoleReadLineOptions global diatur ke True. Untuk mengubah nilai properti, Anda harus menentukan nilai SwitchParameter sebagai berikut: -HistoryNoDuplicates:$False. Anda dapat mengatur kembali dengan True hanya menggunakan SwitchParameter, -HistoryNoDuplicates.

Dengan menggunakan perintah berikut, Anda dapat mengatur nilai properti secara langsung:

(Get-PSReadLineOption).HistoryNoDuplicates = $False

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HistorySavePath

Menentukan jalur ke file tempat riwayat disimpan. Komputer yang menjalankan platform Windows atau non-Windows menyimpan file di lokasi yang berbeda. Nama file disimpan dalam variabel $($Host.Name)_history.txt, misalnya ConsoleHost_history.txt.

Jika Anda tidak menggunakan parameter ini, jalur defaultnya adalah sebagai berikut:

Windows

  • $env:APPDATA\Microsoft\Windows\PowerShell\PSReadLine\$($Host.Name)_history.txt

non-Windows

  • $env:XDG_DATA_HOME/powershell/PSReadLine/$($Host.Name)_history.txt
  • $HOME/.local/share/powershell/PSReadLine/$($Host.Name)_history.txt
Type:String
Position:Named
Default value:A file named $($Host.Name)_history.txt in $env:APPDATA\Microsoft\Windows\PowerShell\PSReadLine on Windows and $env:XDG_DATA_HOME/powershell/PSReadLine or $HOME/.local/share/powershell/PSReadLine on non-Windows platforms
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HistorySaveStyle

Menentukan bagaimana PSReadLine menyimpan riwayat.

Nilai yang valid adalah sebagai berikut:

  • SaveIncrementally: Simpan riwayat setelah setiap perintah dijalankan dan bagikan di beberapa instans PowerShell.
  • SaveAtExit: Tambahkan file riwayat saat PowerShell keluar.
  • SaveNothing: Jangan gunakan file riwayat.

Catatan

Jika Anda mengatur HistorySaveStyle ke SaveNothing lalu mengaturnya ke SaveIncrementally nanti dalam sesi yang sama, PSReadLine menyimpan semua perintah yang sebelumnya dijalankan dalam sesi.

Type:HistorySaveStyle
Position:Named
Default value:SaveIncrementally
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HistorySearchCaseSensitive

Menentukan bahwa pencarian riwayat peka huruf besar/kecil dalam fungsi seperti ReverseSearchHistory atau HistorySearchBackward.

Secara default, properti HistorySearchCaseSensitive dari objek PSConsoleReadLineOptions global diatur ke False. Menggunakan SwitchParameter ini mengatur nilai properti ke True. Untuk mengubah nilai properti kembali, Anda harus menentukan nilai SwitchParameter sebagai berikut: -HistorySearchCaseSensitive:$False.

Dengan menggunakan perintah berikut, Anda dapat mengatur nilai properti secara langsung:

(Get-PSReadLineOption).HistorySearchCaseSensitive = $False

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HistorySearchCursorMovesToEnd

Menunjukkan bahwa kursor berpindah ke akhir perintah yang Anda muat dari riwayat dengan menggunakan pencarian. Ketika parameter ini diatur ke $False, kursor tetap pada posisi saat Anda menekan panah atas atau bawah.

Secara default, properti HistorySearchCursorMovesToEnd dari objek PSConsoleReadLineOptions global diatur ke False. Menggunakan SwitchParameter ini atur nilai properti ke True. Untuk mengubah nilai properti kembali, Anda harus menentukan nilai SwitchParameter sebagai berikut: -HistorySearchCursorMovesToEnd:$False.

Dengan menggunakan perintah berikut, Anda dapat mengatur nilai properti secara langsung:

(Get-PSReadLineOption).HistorySearchCursorMovesToEnd = $False

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaximumHistoryCount

Menentukan jumlah maksimum perintah yang akan disimpan dalam riwayat PSReadLine .

Riwayat PSReadLine terpisah dari riwayat PowerShell.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaximumKillRingCount

Menentukan jumlah maksimum item yang disimpan dalam cincin mati.

Type:Int32
Position:Named
Default value:10
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PredictionSource

Menentukan sumber untuk PSReadLine untuk mendapatkan saran prediktif.

Nilai yang valid adalah:

  • None - nonaktifkan fitur IntelliSense prediktif (default).
  • Riwayat - aktifkan fitur IntelliSense prediktif dan gunakan riwayat PSReadLine sebagai satu-satunya sumber.
  • Plugin - aktifkan fitur IntelliSense prediktif dan gunakan plugin (CommandPrediction) sebagai satu-satunya sumber. Nilai ini ditambahkan di PSReadLine 2.2.0
  • HistoryAndPlugin - aktifkan fitur IntelliSense prediktif dan gunakan riwayat dan plugin sebagai sumbernya. Nilai ini ditambahkan di PSReadLine 2.2.0
Type:Microsoft.PowerShell.PredictionSource
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PredictionViewStyle

Mengatur gaya untuk tampilan teks prediktif. Defaultnya adalah InlineView.

  • InlineView - gaya seperti yang ada saat ini, mirip seperti pada fish shell dan zsh. (default)
  • ListView - saran dirender dalam daftar drop-down, dan pengguna dapat memilih menggunakan UpArrow dan DownArrow.

Parameter ini ditambahkan dalam PSReadLine 2.2.0

Type:Microsoft.PowerShell.PredictionViewStyle
Position:Named
Default value:InlineView
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PromptText

Parameter ini menetapkan nilai properti PromptText . Nilai defaultnya adalah "> ".

PSReadLine menganalisis fungsi prompt Anda untuk menentukan cara mengubah hanya warna bagian dari perintah Anda. Analisis ini tidak 100% dapat diandalkan. Gunakan opsi ini jika PSReadLine mengubah permintaan Anda dengan cara yang tidak terduga. Sertakan spasi kosong berikutnya.

Nilai parameter ini dapat berupa string tunggal atau array dari dua string. String pertama adalah bagian dari string prompt yang ingin Anda ubah menjadi merah saat ada kesalahan penguraian. String kedua adalah string alternatif yang digunakan ketika ada kesalahan penguraian.

Type:String[]
Position:Named
Default value:>
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ShowToolTips

Saat menampilkan kemungkinan penyelesaian, tipsalat ditampilkan dalam daftar penyelesaian.

Pemadatan diaktifkan secara default. Opsi ini tidak diaktifkan secara default di versi PSReadLine sebelumnya. Untuk menonaktifkan, atur opsi ini ke $False.

Parameter dan opsi ini ditambahkan di PSReadLine 2.3.4.

Secara default, properti ShowToolTips dari objek PSConsoleReadLineOptions global diatur ke True. Menggunakan SwitchParameter ini mengatur nilai properti ke True. Untuk mengubah nilai properti, Anda harus menentukan nilai SwitchParameter sebagai berikut: -ShowToolTips:$False.

Dengan menggunakan perintah berikut, Anda dapat mengatur nilai properti secara langsung:

(Get-PSReadLineOption).ShowToolTips = $False

Type:SwitchParameter
Position:Named
Default value:True
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TerminateOrphanedConsoleApps

Parameter ini mengatur opsi TerminateOrphanedConsoleApps ke $true.

Di Windows, ketika Anda menekan Ctrl+c untuk mengakhiri proses, setiap proses yang dilampirkan ke konsol menerima sinyal penghentian, bukan hanya shell aktif. Terkadang, ketika shell telah meluncurkan beberapa pohon besar proses anak, (bayangkan sistem build, misalnya) beberapa proses mungkin keluar, meninggalkan beberapa proses secara bersamaan mencoba mengonsumsi input konsol.

Saat mengatur opsi TerminateOrphanedConsoleApps ke $true, PSReadLine merekam daftar proses yang saat ini dilampirkan ke konsol. Setelah itu, setiap kali PSReadLine berjalan, PSReadLine akan mendapatkan daftar proses baru yang melekat pada konsol, dan mengakhiri proses yang tidak ada dalam daftar asli.

Parameter dan opsi ini ditambahkan di PSReadLine 2.3.4.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ViModeChangeHandler

Ketika ViModeIndicator diatur ke Script, blok skrip yang disediakan akan dipanggil setiap kali mode berubah. Blok skrip disediakan satu argumen jenis ViMode.

Parameter ini diperkenalkan di PowerShell 7.

Type:ScriptBlock
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ViModeIndicator

Opsi ini mengatur indikator visual untuk mode Vi saat ini. Mode sisipkan atau mode perintah.

Nilai yang valid adalah sebagai berikut:

  • Tidak ada: Tidak ada indikator.
  • Prompt: Prompt berubah warna.
  • Kursor: Ukuran perubahan kursor.
  • Skrip: Teks yang ditentukan pengguna dicetak.
Type:ViModeStyle
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WordDelimiters

Menentukan karakter yang memisahkan kata untuk fungsi seperti ForwardWord atau KillWord.

Type:String
Position:Named
Default value:;:,.[]{}()/\|^&*-=+'"---
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

None

Anda tidak dapat menyalurkan objek ke cmdlet ini.

Output

None

Cmdlet ini tidak mengembalikan output.