Set-PSReadLineOption
PSReadLine'da komut satırı düzenleme davranışını özelleştirir.
Syntax
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>]
Description
Cmdlet, Set-PSReadLineOption
komut satırını düzenlerken PSReadLine modülünün davranışını özelleştirir. PSReadLine ayarlarını görüntülemek için kullanınGet-PSReadLineOption
.
Bu komut tarafından ayarlanan seçenekler yalnızca geçerli oturum için geçerlidir. Seçenekleri kalıcı hale getirmek için bunları bir profil betiğine ekleyin. Daha fazla bilgi için bkz . about_Profiles ve Kabuk ortamınızı özelleştirme.
Örnekler
Örnek 1: Ön plan ve arka plan renklerini ayarlama
Bu örnek PSReadLine'ı gri arka planda yeşil ön plan metniyle Açıklama belirtecini görüntüleyecek şekilde ayarlar. Örnekte kullanılan kaçış dizisinde 32 ön plan rengini, 47 ise arka plan rengini temsil eder.
Set-PSReadLineOption -Colors @{ "Comment"="`e[32;47m" }
Yalnızca ön plan metin rengini ayarlamayı seçebilirsiniz. Örneğin, Açıklama belirteci için parlak yeşil ön plan metin rengi: "Comment"="`e[92m"
.
Örnek 2: Zil stilini ayarlama
Bu örnekte PSReadLine, kullanıcı dikkati gerektiren hatalara veya koşullara yanıt verir. BellStyle, 60 ms için 1221 Hz'de sesli bir bip sesi yaymaya ayarlanmıştır.
Set-PSReadLineOption -BellStyle Audible -DingTone 1221 -DingDuration 60
Not
Bu özellik platformlardaki tüm konaklarda çalışmayabilir.
Örnek 3: Birden çok seçenek ayarlama
Set-PSReadLineOption
karma tablosuyla birden çok seçenek ayarlayabilir.
$PSReadLineOptions = @{
EditMode = "Emacs"
HistoryNoDuplicates = $true
HistorySearchCursorMovesToEnd = $true
Colors = @{
"Command" = "#8181f7"
}
}
Set-PSReadLineOption @PSReadLineOptions
Karma $PSReadLineOptions
tablosu anahtarları ve değerleri ayarlar. Set-PSReadLineOption
, ILE tuşlarını ve değerlerini @PSReadLineOptions
kullanarak PSReadLine seçeneklerini güncelleştirir.
Karma tablo adını $PSReadLineOptions
giren anahtarları ve değerleri PowerShell komut satırında görüntüleyebilirsiniz.
Örnek 4: Birden çok renk seçeneği ayarlama
Bu örnekte, tek bir komutta birden fazla renk değerinin nasıl ayarlanacağı gösterilmektedir.
Set-PSReadLineOption -Colors @{
Command = 'Magenta'
Number = 'DarkGray'
Member = 'DarkGray'
Operator = 'DarkGray'
Type = 'DarkGray'
Variable = 'DarkGreen'
Parameter = 'DarkGreen'
ContinuationPrompt = 'DarkGray'
Default = 'DarkGray'
}
Örnek 5: Birden çok tür için renk değerleri ayarlama
Bu örnekte, PSReadLine'da görüntülenen belirteçlerin rengini ayarlamaya yönelik üç farklı yöntem gösterilmektedir.
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"
}
Örnek 6: Vi modu değişikliklerini görüntülemek için ViModeChangeHandler kullanma
Bu örnek, Vi modu değişikliğine yanıt olarak bir imleç değişikliği VT kaçışı yayar.
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
OnViModeChange işlevi Vi modları için imleç seçeneklerini ayarlar: insert ve command.
ViModeChangeHandler, betik bloğu nesnesi olarak OnViModeChange'e başvurmak için sağlayıcıyı kullanırFunction:
.
Daha fazla bilgi için bkz . about_Providers.
Örnek 7: Geçmişe eklenen komutları filtrelemek için HistoryHandler kullanma
Aşağıdaki örnekte, geçmişe git komutlarının kaydedilmesini önlemek için komutunun nasıl kullanılacağı AddToHistoryHandler
gösterilmektedir.
$ScriptBlock = {
Param([string]$line)
if ($line -match "^git") {
return $false
} else {
return $true
}
}
Set-PSReadLineOption -AddToHistoryHandler $ScriptBlock
komut ile başladıysa git
betik bloğu döndürülüyor$false
. Bu, AddToHistory sabit listesini döndürmeyle SkipAdding
aynı etkiye sahiptir. Komut ile git
başlamıyorsa işleyici döndürür $true
ve PSReadLine komutu geçmişe kaydeder.
Örnek 8: Komutu yürütülmeden önce doğrulamak için CommandValidationHandler kullanma
Bu örnekte, yürütülmeden önce command validate komutunu çalıştırmak için CommandValidationHandler parametresinin nasıl kullanılacağı gösterilmektedir. Örnek, komutu cmt
alt komutuyla git
özel olarak denetler ve bunu tam adıyla commit
değiştirir. Bu şekilde alt komutlar için kısa adlar oluşturabilirsiniz.
# 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
Örnek 9: PromptText parametresini kullanma
Ayrıştırma hatası olduğunda, PSReadLine istemlerin bir bölümünü kırmızı olarak değiştirir. PromptText parametresi PSReadLine'a istem dizesinin kırmızı olmasını söyler.
Örneğin, aşağıdaki örnek geçerli yolu ve ardından büyüktür karakterini (>
) ve boşluğu içeren bir istem oluşturur.
function prompt { "PS $pwd> " }`
Set-PSReadLineOption -PromptText '> ' # change the '>' character red
Set-PSReadLineOption -PromptText '> ', 'X ' # replace the '>' character with a red 'X'
İlk dize, istem dizenizin ayrıştırma hatası olduğunda kırmızı yapmak istediğiniz bölümüdür. İkinci dize, ayrıştırma hatası olduğunda kullanılacak alternatif bir dizedir.
Parametreler
-AddToHistoryHandler
Komutların PSReadLine geçmişine nasıl ekleneceğini denetleen bir ScriptBlock belirtir.
ScriptBlock, komut satırını giriş olarak alır.
ScripBlock, AddToHistoryOption sabit listesinin bir üyesini, bu üyelerden birinin dize adını veya boole değerini döndürmelidir. Aşağıdaki listede olası değerler ve bunların etkileri açıklanmaktadır.
MemoryAndFile
- Komutunu geçmiş dosyasına ve geçerli oturuma ekleyin.MemoryOnly
- Komutu yalnızca geçerli oturum için geçmişe ekleyin.SkipAdding
- Komutu geçerli oturum için geçmiş dosyasına eklemeyin.$false
- DeğerinSkipAdding
olduğu gibi.$true
- DeğerinMemoryAndFile
olduğu gibi.
Type: | Func<T,TResult>[System.String,System.Object] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AnsiEscapeTimeout
Giriş yeniden yönlendirildiğinde, örneğin veya screen
altında tmux
çalışırken bu seçenek Windows'a özgüdür.
Windows'ta yeniden yönlendirilen girişle, birçok tuş kaçış karakteriyle başlayan bir karakter dizisi olarak gönderilir. Tek bir kaçış karakteri ile ardından daha fazla karakter ve geçerli bir kaçış dizisi arasında ayrım yapmak mümkün değildir.
Varsayım, terminalin karakterleri bir kullanıcı türünden daha hızlı gönderebileceğidir. PSReadLine , tam bir kaçış dizisi aldığı sonucuna varmadan önce bu zaman aşımını bekler.
Yazarken rastgele veya beklenmeyen karakterler görürseniz bu zaman aşımını ayarlayabilirsiniz.
Type: | Int32 |
Position: | Named |
Default value: | 100 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BellStyle
PSReadLine'ın çeşitli hatalara ve belirsiz koşullara nasıl yanıt vereceğini belirtir.
Geçerli değerler şunlardır:
- Sesli: Kısa bir bip sesi.
- Görsel: Metin kısa bir süre yanıp söner.
- Hiçbiri: Geri bildirim yok.
Type: | BellStyle |
Position: | Named |
Default value: | Audible |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Colors
Colors parametresi PSReadLine tarafından kullanılan çeşitli renkleri belirtir.
Bağımsız değişken, anahtarların öğeleri ve değerlerin rengi belirttiği bir karma tablodur. Daha fazla bilgi için bkz . about_Hash_Tables.
Renkler ConsoleColor'dan bir değer olabilir, örneğin [ConsoleColor]::Red
, veya geçerli bir ANSI kaçış dizisi olabilir. Geçerli kaçış dizileri terminalinize bağlıdır. PowerShell 5.0'da, kırmızı metin için örnek bir kaçış dizisidir $([char]0x1b)[91m
. PowerShell 6 ve daha yeni sürümlerde aynı kaçış dizisidir `e[91m
. Aşağıdaki türler de dahil olmak üzere diğer kaçış dizilerini belirtebilirsiniz:
PSReadLine 2.2.0'da özelleştirmeyi ListView
desteklemek için iki renk ayarı eklendi:
ListPredictionColor - baştaki
>
karakter ve sondaki kaynak adı (gibi[History]
) için renk ayarlayın. Varsayılan olarak, ön plan rengi olarak kullanırDarkYellow
.ListPredictionSelectedColor - Bir liste öğesinin seçili olduğunu belirten rengi ayarlayın. Varsayılan olarak, arka plan rengi olarak kullanır
DarkBlack
.256 renk
24 bit renk
Ön plan, arka plan veya her ikisi
Ters, kalın
ANSI renk kodları hakkında daha fazla bilgi için ANSI kaçış kodu Wikipedia makalesine bakın.
Geçerli anahtarlar şunlardır:
- ContinuationPrompt: Devamlılık isteminin rengi.
- Vurgu: Vurgu rengi. Örneğin, geçmiş araması yaparken eşleşen metin.
- Hata: Hata rengi. Örneğin, isteminde.
- Seçim: Menü seçimini veya seçili metni vurgulamak için renk.
- Varsayılan: Varsayılan belirteç rengi.
- Açıklama: Açıklama belirteci rengi.
- Anahtar sözcük: Anahtar sözcük belirteci rengi.
- Dize: Dize belirteci rengi.
- İşleç: İşleç belirteci rengi.
- Değişken: Değişken belirteci rengi.
- Komut: Komut belirteci rengi.
- Parametre: Parametre belirteci rengi.
- Tür: Tür belirteci rengi.
- Sayı: Sayı belirteci rengi.
- Üye: Üye adı belirteci rengi.
- InlinePrediction: Tahmine dayalı önerinin satır içi görünümünün rengi.
- ListPrediction: Baştaki
>
karakterin ve tahmin kaynağı adının rengi. - ListPredictionSelected: Liste görünümünde seçili tahminin rengi.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CommandValidationHandler
ValidateAndAcceptLine'dan çağrılan bir ScriptBlock belirtir. Özel durum oluşursa doğrulama başarısız olur ve hata bildirilir.
Bir özel durum oluşturmadan önce, doğrulama işleyicisi düzeltmeyi kolaylaştırmak için imleci hatanın noktasına getirebilir. Doğrulama işleyicisi, yaygın tipografik hataları düzeltmek için komut satırını da değiştirebilir.
ValidateAndAcceptLine , çalışmayan komutlarla geçmişinizin karmaşık olmasını önlemek için kullanılır.
Type: | Action<T>[CommandAst] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CompletionQueryItems
İstenmeden gösterilen en fazla tamamlanma öğesi sayısını belirtir.
Gösterilecek öğe sayısı bu değerden büyükse, PSReadLine tamamlanma öğelerini görüntülemeden önce evet/hayır ister.
Type: | Int32 |
Position: | Named |
Default value: | 100 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContinuationPrompt
Çok satırlı giriş girildiğinde sonraki satırların başında görüntülenen dizeyi belirtir. Varsayılan değer çift büyüktür işaretidir (>>
). Boş bir dize geçerli.
Type: | String |
Position: | Named |
Default value: | >> |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DingDuration
BellStyle Sesli olarak ayarlandığında bip sesinin süresini belirtir.
Type: | Int32 |
Position: | Named |
Default value: | 50ms |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DingTone
BellStyle Sesli olarak ayarlandığında bip sesinin Hertz (Hz) içindeki tonunu belirtir.
Type: | Int32 |
Position: | Named |
Default value: | 1221 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EditMode
Komut satırı düzenleme modunu belirtir. Bu parametre kullanıldığında tarafından Set-PSReadLineKeyHandler
ayarlanan tüm anahtar bağlamaları sıfırlanır.
Geçerli değerler şunlardır:
- Windows: Anahtar bağlamaları PowerShell, cmd ve Visual Studio öykünmelerini sağlar.
- Emacs: Anahtar bağlamaları Bash veya Emacs'e öykünmektedir.
- Vi: Anahtar bağlamaları Vi'ye öykünmektedir.
Şu anda yapılandırılmış olan EditMode için anahtar bağlamalarını görmek için kullanınGet-PSReadLineKeyHandler
.
Type: | EditMode |
Position: | Named |
Default value: | Windows |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExtraPromptLineCount
Ek satır sayısını belirtir.
İsteminiz birden fazla satıra yayılmışsa, bu parametre için bir değer belirtin. PSReadLine bazı çıktıları gösterdikten sonra istemi görüntülerken ek satırların kullanılabilir olmasını istediğinizde bu seçeneği kullanın. Örneğin, PSReadLine tamamlamaların listesini döndürür.
Bu seçenek PSReadLine'ın önceki sürümlerinden daha az gereklidir, ancak işlev kullanıldığında kullanışlıdırInvokePrompt
.
Type: | Int32 |
Position: | Named |
Default value: | 0 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HistoryNoDuplicates
Bu seçenek geri çağırma davranışını denetler. Yine de geçmiş dosyasına yinelenen komutlar eklenir. Bu seçenek ayarlandığında, komutları geri çağırırken yalnızca en son çağrı görüntülenir. Geri çekme sırasında sıralamayı korumak için geçmişe yinelenen komutlar eklenir. Ancak, genellikle geçmişi geri çağırırken veya ararken komutu birden çok kez görmek istemezsiniz.
Varsayılan olarak, genel PSConsoleReadLineOptions nesnesinin HistoryNoDuplicates özelliği olarak True
ayarlanır. Özellik değerini değiştirmek için SwitchParameter değerini aşağıdaki gibi belirtmeniz gerekir: -HistoryNoDuplicates:$False
. yalnızca SwitchParameter-HistoryNoDuplicates
, kullanarak öğesine True
geri dönebilirsiniz.
Aşağıdaki komutu kullanarak özellik değerini doğrudan ayarlayabilirsiniz:
(Get-PSReadLineOption).HistoryNoDuplicates = $False
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HistorySavePath
Geçmişin kaydedildiği dosyanın yolunu belirtir. Windows veya Windows dışı platformlar çalıştıran bilgisayarlar dosyayı farklı konumlarda depolar. Dosya adı, örneğin ConsoleHost_history.txt
bir değişkende $($Host.Name)_history.txt
depolanır.
Bu parametreyi kullanmıyorsanız, varsayılan yol aşağıdaki gibidir:
Windows
$env:APPDATA\Microsoft\Windows\PowerShell\PSReadLine\$($Host.Name)_history.txt
Windows dışı
$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
PSReadLine'ın geçmişi nasıl kaydettiğini belirtir.
Geçerli değerler şunlardır:
SaveIncrementally
: Her komut yürütüldükten sonra geçmişi kaydedin ve PowerShell'in birden çok örneğinde paylaşın.SaveAtExit
: PowerShell'in çıkışında ekleme geçmişi dosyası.SaveNothing
: Geçmiş dosyası kullanmayın.
Not
HistorySaveStyle'ı SaveNothing
olarak ayarlayıp daha sonra aynı oturumda olarak ayarlarsanızSaveIncrementally
, PSReadLine daha önce oturumda çalıştırdığınız tüm komutları kaydeder.
Type: | HistorySaveStyle |
Position: | Named |
Default value: | SaveIncrementally |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HistorySearchCaseSensitive
ReverseSearchHistory veya HistorySearchBackward gibi işlevlerde geçmiş aramanın büyük/küçük harfe duyarlı olduğunu belirtir.
Varsayılan olarak, genel PSConsoleReadLineOptions nesnesinin HistorySearchCaseSensitive özelliği olarak False
ayarlanır. Bu SwitchParameter kullanıldığında özellik değeri olarak True
ayarlır. Özellik değerini geri değiştirmek için SwitchParameter değerini şu şekilde belirtmeniz gerekir: -HistorySearchCaseSensitive:$False
.
Aşağıdaki komutu kullanarak özellik değerini doğrudan ayarlayabilirsiniz:
(Get-PSReadLineOption).HistorySearchCaseSensitive = $False
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HistorySearchCursorMovesToEnd
İmlecin, arama kullanarak geçmişten yüklediğiniz komutların sonuna taşındığını gösterir.
Bu parametre olarak $False
ayarlandığında, imleç yukarı veya aşağı oklara bastığınız konumda kalır.
Varsayılan olarak, genel PSConsoleReadLineOptions nesnesinin HistorySearchCursorMovesToEnd özelliği olarak False
ayarlanır. Bu SwitchParameter'ı kullanarak özellik değerini olarak True
ayarlayın. Özellik değerini geri değiştirmek için SwitchParameter değerini şu şekilde belirtmeniz gerekir: -HistorySearchCursorMovesToEnd:$False
.
Aşağıdaki komutu kullanarak özellik değerini doğrudan ayarlayabilirsiniz:
(Get-PSReadLineOption).HistorySearchCursorMovesToEnd = $False
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaximumHistoryCount
PSReadLine geçmişinde kaydedilecek en fazla komut sayısını belirtir.
PSReadLine geçmişi PowerShell geçmişinden ayrıdır.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaximumKillRingCount
Sonlandırma halkasında depolanan en fazla öğe sayısını belirtir.
Type: | Int32 |
Position: | Named |
Default value: | 10 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PredictionSource
Tahmine dayalı öneriler almak için PSReadLine kaynağını belirtir.
Geçerli değerler:
- Yok - Tahmine dayalı IntelliSense özelliğini devre dışı bırakın (varsayılan).
- Geçmiş - Tahmine dayalı IntelliSense özelliğini etkinleştirin ve psreadline geçmişini tek kaynak olarak kullanın.
- Eklenti - Tahmine dayalı IntelliSense özelliğini etkinleştirin ve eklentileri (
CommandPrediction
) tek kaynak olarak kullanın. Bu değer PSReadLine 2.2.0'a eklendi - HistoryAndPlugin - Tahmine dayalı IntelliSense özelliğini etkinleştirin ve kaynak olarak hem geçmiş hem de eklenti kullanın. Bu değer PSReadLine 2.2.0'a eklendi
Type: | Microsoft.PowerShell.PredictionSource |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PredictionViewStyle
Tahmine dayalı metnin görüntülenmesi için stili ayarlar. Varsayılan değer InlineView'dır.
- InlineView - balık kabuğu ve zsh'de olduğu gibi, bugün var olan stil. (varsayılan)
- ListView - öneriler açılan listede işlenir ve kullanıcılar UpArrow ve DownArrow kullanarak seçim yapabilir.
Bu parametre PSReadLine 2.2.0'a eklendi
Type: | Microsoft.PowerShell.PredictionViewStyle |
Position: | Named |
Default value: | InlineView |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PromptText
Bu parametre PromptText özelliğinin değerini ayarlar. Varsayılan değer şudur: "> "
.
PSReadLine , isteminizin yalnızca bir bölümünün renginin nasıl değiştirileceğini belirlemek için istem işlevinizi analiz eder. Bu analiz %100 güvenilir değildir. PSReadLine isteminizi beklenmeyen yollarla değiştiriyorsa bu seçeneği kullanın. Sondaki boşlukları ekleyin.
Bu parametrenin değeri tek bir dize veya iki dizeden oluşan bir dizi olabilir. İlk dize, ayrıştırma hatası olduğunda istem dizenizin kırmızıya değiştirilmesini istediğiniz bölümüdür. İkinci dize, ayrıştırma hatası olduğunda kullanılacak alternatif bir dizedir.
Type: | String[] |
Position: | Named |
Default value: | > |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ShowToolTips
Olası tamamlamalar görüntülenirken, araç ipuçları tamamlamalar listesinde gösterilir.
Bu seçenek varsayılan olarak etkindir. Bu seçenek PSReadLine'ın önceki sürümlerinde varsayılan olarak etkinleştirilmedi. Devre dışı bırakmak için bu seçeneği olarak $False
ayarlayın.
Bu parametre ve seçenek PSReadLine 2.3.4'e eklendi.
Varsayılan olarak, genel PSConsoleReadLineOptions nesnesinin ShowTool İpuçları özelliği olarak True
ayarlanır. Bu SwitchParameter kullanıldığında özellik değeri olarak True
ayarlır. Özellik değerini değiştirmek için SwitchParameter değerini aşağıdaki gibi belirtmeniz gerekir: -ShowToolTips:$False
.
Aşağıdaki komutu kullanarak özellik değerini doğrudan ayarlayabilirsiniz:
(Get-PSReadLineOption).ShowToolTips = $False
Type: | SwitchParameter |
Position: | Named |
Default value: | True |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TerminateOrphanedConsoleApps
Bu parametre TerminateOrphanedConsoleApps seçeneğini olarak $true
ayarlar.
Windows'da, bir işlemi sonlandırmak için Ctrl+c tuşuna bastığınızda, konsola bağlı her işlem yalnızca etkin kabuğun aksine bir sonlandırma sinyali alır. Bazen, bir kabuk bazı büyük alt işlem ağacını başlattığında (örneğin bir derleme sistemi düşünün) bazı işlemlerden çıkılabilir ve birden çok işlem eşzamanlı olarak konsol girişini tüketmeye çalışır.
TerminateOrphanedConsoleApps seçeneğini olarak $true
ayarlarken, PSReadLine şu anda konsola bağlı olan işlemlerin listesini kaydeder. Daha sonra PSReadLine her çalıştırıldığında konsola eklenen işlemlerin yeni bir listesini alır ve özgün listede olmayan işlemleri sonlandırır.
Bu parametre ve seçenek PSReadLine 2.3.4'e eklendi.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ViModeChangeHandler
ViModeIndicator olarak ayarlandığındaScript
, mod her değiştiğinde sağlanan betik bloğu çağrılır. Betik bloğuna türünde ViMode
bir bağımsız değişken sağlanır.
Bu parametre PowerShell 7'de kullanıma sunulmuştur.
Type: | ScriptBlock |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ViModeIndicator
Bu seçenek geçerli Vi modunun görsel göstergesini ayarlar. Ekleme modu veya komut modu.
Geçerli değerler şunlardır:
- Yok: Gösterge yok.
- İstem: İstem rengi değiştirir.
- İmleç: İmleç boyutu değiştirir.
- Betik: Kullanıcı tarafından belirtilen metin yazdırılır.
Type: | ViModeStyle |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WordDelimiters
ForwardWord veya KillWord gibi işlevler için sözcükleri sınırlandıran karakterleri belirtir.
Type: | String |
Position: | Named |
Default value: | ;:,.[]{}()/\|^&*-=+'"--- |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Girişler
None
Nesneleri bu cmdlet'e yöneltemezsiniz.
Çıkışlar
None
Bu cmdlet çıkış döndürmez.
İlişkili Bağlantılar
PowerShell
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin