Aracılığıyla paylaş

Set-PSReadLineOption

  • Başvuru
Modül:
PSReadLine

PSReadLinekomut satırı düzenleme davranışını özelleştirir.

Sözdizimi

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

Set-PSReadLineOption cmdlet'i, komut satırını düzenlerken PSReadLine modülünün davranışını özelleştirir. PSReadLine ayarlarını görüntülemek için Get-PSReadLineOptionkullanın.

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 yeşil ön plan metniyle Açıklama belirtecini gri arka planda görüntüleyecek şekilde ayarlar. Örnekte kullanılan kaçış dizisinde 32 ön plan rengini, 47 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ı dikkatini gerektiren hatalara veya koşullara yanıt verecektir. BellStyle, 60 ms için 1221 Hz'de sesli bir bip sesi yayacak şekilde 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 tabloyla birden çok seçenek ayarlayabilir.

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

$PSReadLineOptions karma tablosu anahtarları ve değerleri ayarlar. Set-PSReadLineOption, PSReadLine seçeneklerini güncelleştirmek için anahtarları ve değerleri @PSReadLineOptions kullanır.

PowerShell komut satırında $PSReadLineOptions karma tablo adını giren anahtarları ve değerleri 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, PSReadLineiçinde 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, OnViModeChange betik bloğu nesnesi olarak başvurmak için Function: sağlayıcısını kullanır.

Daha fazla bilgi için bkz. about_Providers.

Örnek 7: Geçmişe eklenen komutları filtrelemek için HistoryHandler kullanma

Aşağıdaki örnekte, git komutlarının geçmişe kaydedilmesini önlemek için AddToHistoryHandler nasıl kullanılacağı gösterilmektedir.

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

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

Set-PSReadLineOption -AddToHistoryHandler $ScriptBlock

komut gitile başladıysa betik bloğu $false döndürür. Bu, AddToHistorySkipAdding sabit listesini döndürmeyle aynı etkiye sahiptir. Komut gitile başlamazsa işleyici $true döndürür 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 bir komutu doğrulamak için CommandValidationHandler parametresinin nasıl kullanılacağı gösterilmektedir. Örnek, alt komut cmt ile git komut git özel olarak denetler ve bunu committam adıyla 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 istemin bir bölümünü kırmızı olarak değiştirir. PromptText parametresi PSReadLine'a istem dizesinin kırmızıya bölümünü bildirir.

Örneğin, aşağıdaki örnek geçerli yolu ve ardından büyüktür karakterini (>) ve bir 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 denetleyebilen 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 - Komutu 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ğerin SkipAddingolduğu gibi.
  • $true - Değerin MemoryAndFileolduğu gibi.
Tür:Func<T,TResult>[System.String,System.Object]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-AnsiEscapeTimeout

Giriş yeniden yönlendirildiğinde, örneğin tmux veya screenaltında ç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.

Tür:Int32
Position:Named
Default value:100
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-BellStyle

PSReadLine çeşitli hatalara ve belirsiz koşullara nasıl yanıt vereceğini belirtir.

Geçerli değerler şunlardır:

  • Sesli: Kısa bip sesi.
  • Visual: Metin kısa bir süre yanıp söner.
  • Hiçbiri: Geri bildirim yok.
Tür:BellStyle
Position:Named
Default value:Audible
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Colors

Colors parametresi, PSReadLinetarafı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, ConsoleColorbir değer olabilir, örneğin [ConsoleColor]::Redveya 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çış dizisi $([char]0x1b)[91m. PowerShell 6 ve daha yeni sürümlerde aynı kaçış dizisi `e[91m. Aşağıdaki türler de dahil olmak üzere diğer kaçış dizilerini belirtebilirsiniz:

PSReadLine 2.2.0'da ListView özelleştirmesini desteklemek için iki renk ayarı eklendi:

  • ListPredictionColor - baştaki > karakteri ve [History]gibi sondaki kaynak adı için renk ayarlayın. Varsayılan olarak, ön plan rengi olarak DarkYellow kullanır.

  • ListPredictionSelectedColor - liste öğesinin seçili olduğunu gösteren rengi ayarlayın. Varsayılan olarak, arka plan rengi olarak DarkBlack kullanır.

  • 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 vurgulama rengi.
  • 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.
  • İşleci: İş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.
  • Satır İçiÖndirme: Tahmine dayalı önerinin satır içi görünümünün rengi.
  • ListPrediction: Baştaki > karakterinin ve tahmin kaynağı adının rengi.
  • ListPredictionSelected: Liste görünümünde seçili tahminin rengi.
Tür:Hashtable
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-CommandValidationHandler

ValidateAndAcceptLinetarafından ç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.

Tür:Action<T>[CommandAst]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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 tamamlama öğelerini görüntülemeden önce evet/hayır ister.

Tür:Int32
Position:Named
Default value:100
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:String
Position:Named
Default value:>>
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DingDuration

BellStyleSesliolarak ayarlandığında bip sesinin süresini belirtir.

Tür:Int32
Position:Named
Default value:50ms
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DingTone

BellStyleSesliolarak ayarlandığında bip sesinin Hertz (Hz) içindeki tonunu belirtir.

Tür:Int32
Position:Named
Default value:1221
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-EditMode

Komut satırı düzenleme modunu belirtir. Bu parametre kullanıldığında, Set-PSReadLineKeyHandlertarafından 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'ya öykünmektedir.
  • Emacs: Anahtar bağlamaları Bash veya Emacs'e öykünmektedir.
  • Vi: Anahtar bağlamaları Vi'ye öykünmektedir.

EditMode yapılandırılmış olan anahtar bağlamalarını görmek için Get-PSReadLineKeyHandler kullanın.

Tür:EditMode
Position:Named
Default value:Windows
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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 istem görüntülendiğinde 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önceki sürümlerinden daha az gereklidir, ancak InvokePrompt işlevi kullanıldığında kullanışlıdır.

Tür:Int32
Position:Named
Default value:0
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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, HistoryNoDuplicates genel PSConsoleReadLineOptions nesnesi Trueolarak ayarlanır. Özellik değerini değiştirmek için SwitchParameter değerini şu şekilde belirtmeniz gerekir: -HistoryNoDuplicates:$False. yalnızca SwitchParameter-HistoryNoDuplicateskullanarak True dönebilirsiniz.

Aşağıdaki komutu kullanarak özellik değerini doğrudan ayarlayabilirsiniz:

(Get-PSReadLineOption).HistoryNoDuplicates = $False

Tür:SwitchParameter
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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ı $($Host.Name)_history.txtbir değişkende depolanır, örneğin ConsoleHost_history.txt.

Bu parametreyi kullanmıyorsanız, varsayılan yol aşağıdaki gibidir:

Windows

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

Windows olmayan

  • $env:XDG_DATA_HOME/powershell/PSReadLine/$($Host.Name)_history.txt
  • $HOME/.local/share/powershell/PSReadLine/$($Host.Name)_history.txt
Tür: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
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-HistorySaveStyle

PSReadLine geçmişi nasıl kaydediyor 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 geçmiş dosyasını ekleyin.
  • SaveNothing: Geçmiş dosyası kullanmayın.

Not

HistorySaveStyleSaveNothing olarak ayarladıysanız ve daha sonra aynı oturumda SaveIncrementally olarak ayarlarsanız, PSReadLine daha önce oturumda çalıştırdığınız tüm komutları kaydeder.

Tür:HistorySaveStyle
Position:Named
Default value:SaveIncrementally
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-HistorySearchCaseSensitive

ReverseSearchHistory veya HistorySearchBackwardgibi 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 Falseolarak ayarlanır. Bu SwitchParameter kullanıldığında özellik değeri Trueolarak ayarlar. Ö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

Tür:SwitchParameter
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-HistorySearchCursorMovesToEnd

İmlecin, arama kullanarak geçmişten yüklediğiniz komutların sonuna taşındığını gösterir. Bu parametre $Falseolarak ayarlandığında, imleç yukarı veya aşağı oklara bastığınızda olduğu konumda kalır.

Varsayılan olarak, genel PSConsoleReadLineOptions nesnesinin HistorySearchCursorMovesToEnd özelliği Falseolarak ayarlanır. Bu SwitchParameter kullanarak özellik değerini Trueolarak 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

Tür:SwitchParameter
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:Int32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-MaximumKillRingCount

Sonlandırma halkasında depolanan en fazla öğe sayısını belirtir.

Tür:Int32
Position:Named
Default value:10
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-PredictionSource

Tahmine dayalı öneriler almak için PSReadLine kaynağını belirtir.

Geçerli değerler şunlardır:

  • None - Tahmine dayalı IntelliSense özelliğini devre dışı bırakın (varsayılan).
  • Geçmişi - Tahmine dayalı IntelliSense özelliğini etkinleştirin ve psreadline geçmişini tek kaynak olarak kullanın.
  • Eklentisi - 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 eklentiyi kullanın. Bu değer PSReadLine 2.2.0'a eklendi
Tür:Microsoft.PowerShell.PredictionSource
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-PredictionViewStyle

Tahmine dayalı metnin görüntülenmesi için stili ayarlar. InlineView varsayılan değerdir.

  • InlineView - balık kabuğu ve zsh'de olduğu gibi bugün olduğu gibi stil. (varsayılan)
  • ListView - öneriler açılan listede işlenir ve kullanıcılar UpArrow ve DownArrowkullanarak seçebilir.

Bu parametre PSReadLine 2.2.0'a eklendi

Tür:Microsoft.PowerShell.PredictionViewStyle
Position:Named
Default value:InlineView
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-PromptText

Bu parametre, PromptText özelliğinin değerini ayarlar. Varsayılan değer "> ".

PSReadLine istem işlevinizi analiz eder ve isteminizin yalnızca bir bölümünün renginin nasıl değiştirileceğini belirler. Bu analiz 100% güvenilir değildir. PSReadLine isteminizi beklenmedik şekillerde 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.

Tür:String[]
Position:Named
Default value:>
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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önceki sürümlerinde varsayılan olarak etkinleştirilmedi. Devre dışı bırakmak için bu seçeneği $Falseolarak ayarlayın.

Bu parametre ve seçenek PSReadLine 2.3.4'e eklendi.

Varsayılan olarak, genel PSConsoleReadLineOptions nesnesinin ShowToolTips özelliği Trueolarak ayarlanır. Bu SwitchParameter kullanıldığında özellik değeri Trueolarak ayarlar. Özellik değerini değiştirmek için SwitchParameter değerini şu şekilde belirtmeniz gerekir: -ShowToolTips:$False.

Aşağıdaki komutu kullanarak özellik değerini doğrudan ayarlayabilirsiniz:

(Get-PSReadLineOption).ShowToolTips = $False

Tür:SwitchParameter
Position:Named
Default value:True
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-TerminateOrphanedConsoleApps

Bu parametre TerminateOrphanedConsoleApps seçeneğini $trueolarak ayarlar.

Windows'da, bir işlemi sonlandırmak için Ctrl+c 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 $trueolarak 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.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ViModeChangeHandler

ViModeIndicatorScriptolarak ayarlandığında, mod her değiştiğinde sağlanan betik bloğu çağrılır. Betik bloğuna ViModetüründe bir bağımsız değişken sağlanır.

Bu parametre PowerShell 7'de kullanıma sunulmuştur.

Tür:ScriptBlock
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ViModeIndicator

Bu seçenek geçerli Vi modu için görsel göstergeyi ayarlar. Ekleme modu veya komut modu.

Geçerli değerler şunlardır:

  • Hiçbiri: 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.
Tür:ViModeStyle
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-WordDelimiters

ForwardWord veya KillWordgibi işlevler için sözcükleri sınırlandıran karakterleri belirtir.

Tür:String
Position:Named
Default value:;:,.[]{}()/\|^&*-=+'"---
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

None

Bu cmdlet çıkış döndürmez.