Delen via

Set-PSReadLineOption

  • Referentie
Module:
PSReadLine

Hiermee past u het gedrag van het bewerken van opdrachtregels in PSReadLine aan.

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

De Set-PSReadLineOption cmdlet past het gedrag van de PSReadLine-module aan wanneer u de opdrachtregel bewerkt. Als u de PSReadLine-instellingen wilt weergeven, gebruikt u Get-PSReadLineOption.

De opties die door deze opdracht zijn ingesteld, zijn alleen van toepassing op de huidige sessie. Als u opties wilt behouden, voegt u deze toe aan een profielscript. Zie about_Profiles en uw shell-omgeving aanpassen voor meer informatie.

Voorbeelden

Voorbeeld 1: Voorgrond- en achtergrondkleuren instellen

In dit voorbeeld wordt PSReadLine ingesteld om het opmerkingstoken weer te geven met groene voorgrondtekst op een grijze achtergrond. In de escapereeks die in het voorbeeld wordt gebruikt, vertegenwoordigt 32 de voorgrondkleur en 47 de achtergrondkleur.

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

U kunt ervoor kiezen om alleen een voorgrondtekstkleur in te stellen. Bijvoorbeeld een heldergroene tekstkleur voor de voorgrond voor het token Opmerking : "Comment"="`e[92m".

Voorbeeld 2: Belstijl instellen

In dit voorbeeld reageert PSReadLine op fouten of voorwaarden waarvoor gebruikers aandacht nodig is. De BellStyle is ingesteld om een hoorbare pieptoon te verzenden op 1221 Hz voor 60 ms.

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

Notitie

Deze functie werkt mogelijk niet op alle hosts op platforms.

Voorbeeld 3: Meerdere opties instellen

Set-PSReadLineOption kan meerdere opties instellen met een hash-tabel.

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

De $PSReadLineOptions hashtabel stelt de sleutels en waarden in. Set-PSReadLineOption gebruikt de sleutels en waarden waarmee @PSReadLineOptions de PSReadLine-opties worden bijgewerkt.

U kunt de sleutels en waarden bekijken die de naam van de hash-tabel invoeren op $PSReadLineOptions de PowerShell-opdrachtregel.

Voorbeeld 4: Opties voor meerdere kleuren instellen

In dit voorbeeld ziet u hoe u meer dan één kleurwaarde instelt in één opdracht.

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

Voorbeeld 5: Kleurwaarden instellen voor meerdere typen

In dit voorbeeld ziet u drie verschillende methoden voor het instellen van de kleur van tokens die worden weergegeven in 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"
}

Voorbeeld 6: ViModeChangeHandler gebruiken om wijzigingen in de vi-modus weer te geven

In dit voorbeeld wordt een VT-escape voor cursorwijziging verzonden als reactie op een wijziging in de Vi-modus .

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

Met de functie OnViModeChange worden de cursoropties voor de vi-modi ingesteld: invoegen en opdracht. ViModeChangeHandler gebruikt de Function: provider om te verwijzen naar OnViModeChange als een scriptblokobject.

Zie about_Providers voor meer informatie.

Voorbeeld 7: HistoryHandler gebruiken om opdrachten te filteren die zijn toegevoegd aan de geschiedenis

In het volgende voorbeeld ziet u hoe u het kunt gebruiken om te voorkomen dat git-opdrachten in de AddToHistoryHandler geschiedenis worden opgeslagen.

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

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

Set-PSReadLineOption -AddToHistoryHandler $ScriptBlock

Het scriptblok retourneert $false als de opdracht is gestart met git. Dit heeft hetzelfde effect als het retourneren van de SkipAddingenum AddToHistory . Als de opdracht niet begint git, retourneert $true de handler en slaat PSReadLine de opdracht in de geschiedenis op.

Voorbeeld 8: CommandValidationHandler gebruiken om een opdracht te valideren voordat deze wordt uitgevoerd

In dit voorbeeld ziet u hoe u de parameter CommandValidationHandler gebruikt om een validatie van een opdracht uit te voeren voordat deze wordt uitgevoerd. Het voorbeeld controleert specifiek op de opdracht git met de subopdracht cmt en vervangt dat door de volledige naam commit. Op deze manier kunt u verkorte aliassen maken voor subopdrachten.

# 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

Voorbeeld 9: de parameter PromptText gebruiken

Wanneer er een parseringsfout optreedt, wijzigt PSReadLine een deel van de prompt rood. De parameter PromptText vertelt PSReadLine het deel van de prompttekenreeks om rood te maken.

In het volgende voorbeeld wordt bijvoorbeeld een prompt gemaakt die het huidige pad bevat, gevolgd door het teken groter dan (>) en een spatie.

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

De eerste tekenreeks is het gedeelte van de prompttekenreeks dat u rood wilt maken wanneer er een parseringsfout optreedt. De tweede tekenreeks is een alternatieve tekenreeks die moet worden gebruikt wanneer er een parseringsfout optreedt.

Parameters

-AddToHistoryHandler

Hiermee geeft u een ScriptBlock op waarmee wordt bepaald hoe opdrachten worden toegevoegd aan de geschiedenis van PSReadLine .

ScriptBlock ontvangt de opdrachtregel als invoer.

De ScripBlock moet een lid van de enum AddToHistoryOption , de tekenreeksnaam van een van deze leden of een booleaanse waarde retourneren. In de onderstaande lijst worden de mogelijke waarden en hun effecten beschreven.

  • MemoryAndFile - Voeg de opdracht toe aan het geschiedenisbestand en de huidige sessie.
  • MemoryOnly - Voeg de opdracht alleen toe aan de geschiedenis voor de huidige sessie.
  • SkipAdding - Voeg de opdracht niet toe aan het geschiedenisbestand voor de huidige sessie.
  • $false- Hetzelfde als als als de waarde .SkipAdding
  • $true- Hetzelfde als als als de waarde .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

Deze optie is specifiek voor Windows wanneer invoer wordt omgeleid, bijvoorbeeld wanneer deze wordt uitgevoerd onder tmux of screen.

Met omgeleide invoer in Windows worden veel sleutels verzonden als een reeks tekens die beginnen met het escape-teken. Het is onmogelijk om onderscheid te maken tussen één escape-teken, gevolgd door meer tekens en een geldige escapereeks.

De veronderstelling is dat de terminal de tekens sneller kan verzenden dan een gebruikerstype. PSReadLine wacht op deze time-out voordat wordt geconcludeerd dat deze een volledige escape-reeks heeft ontvangen.

Als u willekeurige of onverwachte tekens ziet wanneer u typt, kunt u deze time-out aanpassen.

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

-BellStyle

Hiermee geeft u op hoe PSReadLine reageert op verschillende fout- en dubbelzinnige voorwaarden.

De geldige waarden zijn als volgt:

  • Hoorbaar: Een korte pieptoon.
  • Visual: Tekst knippert kort.
  • Geen: Geen feedback.
Type:BellStyle
Position:Named
Default value:Audible
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Colors

De parameter Kleuren geeft verschillende kleuren op die worden gebruikt door PSReadLine.

Het argument is een hash-tabel waarin de sleutels de elementen opgeven en de waarden de kleur opgeven. Zie about_Hash_Tables voor meer informatie.

Kleuren kunnen een waarde zijn uit ConsoleColor, bijvoorbeeld [ConsoleColor]::Redof een geldige ANSI-escapereeks. Geldige escapereeksen zijn afhankelijk van uw terminal. In PowerShell 5.0 is $([char]0x1b)[91meen voorbeeld van een escapereeks voor rode tekst. In PowerShell 6 en hoger is `e[91mdezelfde escapereeks. U kunt andere escapereeksen opgeven, waaronder de volgende typen:

Er zijn twee kleurinstellingen toegevoegd ter ondersteuning van aanpassing van de ListView in PSReadLine 2.2.0:

  • ListPredictionColor - stel kleur in voor het voorloopteken > en de naam van de volgbron, zoals [History]. Standaard wordt deze gebruikt DarkYellow als de voorgrondkleur.

  • ListPredictionSelectedColor - kleur instellen om aan te geven dat een lijstitem is geselecteerd. Standaard wordt deze gebruikt DarkBlack als achtergrondkleur.

  • 256 kleur

  • 24-bits kleur

  • Voorgrond, achtergrond of beide

  • Inverse, vet

Zie het Wikipedia-artikel ANSI-escapecode voor meer informatie over ANSI-kleurcodes.

De geldige sleutels zijn:

  • ContinuationPrompt: De kleur van de vervolgprompt.
  • Nadruk: De nadrukkleur. Bijvoorbeeld de overeenkomende tekst bij het zoeken in de geschiedenis.
  • Fout: de foutkleur. Bijvoorbeeld in de prompt.
  • Selectie: De kleur om de menuselectie of geselecteerde tekst te markeren.
  • Standaard: de standaardtokenkleur.
  • Opmerking: de kleur van het opmerkingstoken.
  • Trefwoord: de kleur van het trefwoordtoken.
  • Tekenreeks: de tekenreekstokenkleur.
  • Operator: De kleur van het operatortoken.
  • Variabele: de kleur van het variabeletoken.
  • Opdracht: de kleur van het opdrachttoken.
  • Parameter: de kleur van het parametertoken.
  • Type: De kleur van het typetoken.
  • Getal: De kleur van het nummertoken.
  • Lid: De naamtokenkleur van het lid.
  • InlinePrediction: de kleur voor de inlineweergave van de voorspellende suggestie.
  • ListPrediction: De kleur voor het voorloopteken > en de naam van de voorspellingsbron.
  • ListPredictionSelected: de kleur voor de geselecteerde voorspelling in de lijstweergave.
Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CommandValidationHandler

Hiermee geeft u een ScriptBlock op die wordt aangeroepen vanuit ValidateAndAcceptLine. Als er een uitzondering wordt gegenereerd, mislukt de validatie en wordt de fout gerapporteerd.

Voordat u een uitzondering genereert, kan de validatiehandler de cursor op het punt van de fout plaatsen, zodat u deze gemakkelijker kunt oplossen. Een validatiehandler kan ook de opdrachtregel wijzigen om veelvoorkomende typografische fouten te corrigeren.

ValidateAndAcceptLine wordt gebruikt om te voorkomen dat uw geschiedenis overzichtelijk blijft met opdrachten die niet werken.

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

-CompletionQueryItems

Hiermee geeft u het maximum aantal voltooiingsitems op dat wordt weergegeven zonder te vragen.

Als het aantal weer te geven items groter is dan deze waarde, geeft PSReadLine ja/nee aan voordat de voltooiingsitems worden weergegeven.

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

-ContinuationPrompt

Hiermee geeft u de tekenreeks op die wordt weergegeven aan het begin van de volgende regels wanneer invoer met meerdere regels wordt ingevoerd. De standaardwaarde is dubbel groter dan tekens (>>). Een lege tekenreeks is geldig.

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

-DingDuration

Hiermee geeft u de duur van de pieptoon wanneer BellStyle is ingesteld op Audible.

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

-DingTone

Hiermee geeft u de toon in Hertz (Hz) van de pieptoon wanneer BellStyle is ingesteld op Audible.

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

-EditMode

Hiermee geeft u de bewerkingsmodus van de opdrachtregel. Met deze parameter worden alle sleutelbindingen opnieuw ingesteld door Set-PSReadLineKeyHandler.

De geldige waarden zijn als volgt:

  • Windows: Sleutelbindingen emuleren PowerShell, cmd en Visual Studio.
  • Emacs: Sleutelbindingen emuleren Bash of Emacs.
  • Vi: Sleutelbindingen emuleren Vi.

Gebruik Get-PSReadLineKeyHandler dit om de sleutelbindingen voor de momenteel geconfigureerde EditMode weer te geven.

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

-ExtraPromptLineCount

Hiermee geeft u het aantal extra regels op.

Als uw prompt meer dan één regel omvat, geeft u een waarde op voor deze parameter. Gebruik deze optie als u wilt dat er extra regels beschikbaar zijn wanneer PSReadLine de prompt weergeeft nadat de uitvoer is weergegeven. PSReadLine retourneert bijvoorbeeld een lijst met voltooiingen.

Deze optie is minder nodig dan in eerdere versies van PSReadLine, maar is handig wanneer de InvokePrompt functie wordt gebruikt.

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

-HistoryNoDuplicates

Met deze optie bepaalt u het gedrag van intrekken. Er worden nog steeds dubbele opdrachten toegevoegd aan het geschiedenisbestand. Wanneer deze optie is ingesteld, wordt alleen de meest recente aanroep weergegeven bij het intrekken van opdrachten. Herhaalde opdrachten worden toegevoegd aan de geschiedenis om de volgorde tijdens het intrekken te behouden. Meestal wilt u de opdracht echter niet meerdere keren zien wanneer u de geschiedenis terugroept of doorzoekt.

De eigenschap HistoryNoDuplicates van het globale OBJECT PSConsoleReadLineOptions is standaard ingesteld op True. Als u de eigenschapswaarde wilt wijzigen, moet u de waarde van de SwitchParameter als volgt opgeven: -HistoryNoDuplicates:$False U kunt deze weer True instellen met behulp van alleen de SwitchParameter. -HistoryNoDuplicates

Met de volgende opdracht kunt u de eigenschapswaarde rechtstreeks instellen:

(Get-PSReadLineOption).HistoryNoDuplicates = $False

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

-HistorySavePath

Hiermee geeft u het pad naar het bestand waarin de geschiedenis wordt opgeslagen. Op computers met Windows- of niet-Windows-platforms wordt het bestand op verschillende locaties opgeslagen. De bestandsnaam wordt bijvoorbeeld opgeslagen in een variabele$($Host.Name)_history.txtConsoleHost_history.txt.

Als u deze parameter niet gebruikt, is het standaardpad als volgt:

Windows

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

niet-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

Hiermee geeft u op hoe de geschiedenis van PSReadLine wordt opgeslagen.

Geldige waarden zijn als volgt:

  • SaveIncrementally: Sla de geschiedenis op nadat elke opdracht is uitgevoerd en deel deze over meerdere exemplaren van PowerShell.
  • SaveAtExit: Geschiedenisbestand toevoegen wanneer PowerShell wordt afgesloten.
  • SaveNothing: Gebruik geen geschiedenisbestand.

Notitie

Als u HistorySaveStyle SaveNothing instelt en deze later in dezelfde sessie insteltSaveIncrementally, slaat PSReadLine alle opdrachten op die eerder in de sessie worden uitgevoerd.

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

-HistorySearchCaseSensitive

Hiermee geeft u op dat zoeken in geschiedenis hoofdlettergevoelig is in functies zoals ReverseSearchHistory of HistorySearchBackward.

De eigenschap HistorySearchCaseSensitive van het globale PSConsoleReadLineOptions-object is standaard ingesteld op False. Met deze SwitchParameter stelt u de eigenschapswaarde in op True. Als u de eigenschapswaarde weer wilt wijzigen, moet u de waarde van de SwitchParameter als volgt opgeven: -HistorySearchCaseSensitive:$False

Met de volgende opdracht kunt u de eigenschapswaarde rechtstreeks instellen:

(Get-PSReadLineOption).HistorySearchCaseSensitive = $False

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

-HistorySearchCursorMovesToEnd

Hiermee wordt aangegeven dat de cursor wordt verplaatst naar het einde van opdrachten die u vanuit de geschiedenis laadt met behulp van een zoekopdracht. Wanneer deze parameter is ingesteld $False, blijft de cursor op de positie waar deze zich bevond toen u op de pijl-omhoog of -omlaag hebt gedrukt.

De eigenschap HistorySearchCursorMovesToEnd van het globale PSConsoleReadLineOptions-object is standaard ingesteld op False. Met deze SwitchParameter stelt u de eigenschapswaarde in op True. Als u de eigenschapswaarde weer wilt wijzigen, moet u de waarde van de SwitchParameter als volgt opgeven: -HistorySearchCursorMovesToEnd:$False

Met de volgende opdracht kunt u de eigenschapswaarde rechtstreeks instellen:

(Get-PSReadLineOption).HistorySearchCursorMovesToEnd = $False

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

-MaximumHistoryCount

Hiermee geeft u het maximum aantal opdrachten op dat moet worden opgeslagen in de GESCHIEDENIS van PSReadLine .

De geschiedenis van PSReadLine staat los van de PowerShell-geschiedenis.

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

-MaximumKillRingCount

Hiermee geeft u het maximum aantal items op dat is opgeslagen in de kill-ring.

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

-PredictionSource

Hiermee geeft u de bron voor PSReadLine om voorspellende suggesties te krijgen.

Geldige waarden zijn:

  • Geen - schakel de voorspellende IntelliSense-functie (standaard) uit.
  • Geschiedenis : schakel de voorspellende IntelliSense-functie in en gebruik de PSReadLine-geschiedenis als enige bron.
  • Invoegtoepassing : schakel de voorspellende IntelliSense-functie in en gebruik de invoegtoepassingen (CommandPrediction) als enige bron. Deze waarde is toegevoegd in PSReadLine 2.2.0
  • HistoryAndPlugin : schakel de voorspellende IntelliSense-functie in en gebruik zowel de geschiedenis als de invoegtoepassing als de bronnen. Deze waarde is toegevoegd in PSReadLine 2.2.0
Type:Microsoft.PowerShell.PredictionSource
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PredictionViewStyle

Hiermee stelt u de stijl voor de weergave van de voorspellende tekst in. De standaardwaarde is InlineView.

  • InlineView - de stijl als bestaande vandaag, vergelijkbaar met in visshell en zsh. (standaard)
  • ListView - suggesties worden weergegeven in een vervolgkeuzelijst en gebruikers kunnen selecteren met Behulp van UpArrow en DownArrow.

Deze parameter is toegevoegd in PSReadLine 2.2.0

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

-PromptText

Met deze parameter wordt de waarde van de eigenschap PromptText ingesteld. De standaardwaarde is "> ".

PSReadLine analyseert uw promptfunctie om te bepalen hoe u alleen de kleur van een deel van de prompt wijzigt. Deze analyse is niet 100% betrouwbaar. Gebruik deze optie als PSReadLine uw prompt op onverwachte manieren wijzigt. Neem eventuele volgspaties op.

De waarde van deze parameter kan één tekenreeks of een matrix van twee tekenreeksen zijn. De eerste tekenreeks is het gedeelte van de prompttekenreeks dat u wilt wijzigen in rood wanneer er een parseringsfout optreedt. De tweede tekenreeks is een alternatieve tekenreeks die moet worden gebruikt wanneer er een parseringsfout optreedt.

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

-ShowToolTips

Wanneer mogelijke voltooiingen worden weergegeven, worden knopinfo weergegeven in de lijst met voltooiingen.

Deze optie is standaard ingeschakeld. Deze optie is niet standaard ingeschakeld in eerdere versies van PSReadLine. Als u wilt uitschakelen, stelt u deze optie in op $False.

Deze parameter en optie zijn toegevoegd in PSReadLine 2.3.4.

Standaard is de eigenschap ShowToolTips van het globale OBJECT PSConsoleReadLineOptions ingesteld op True. Met deze SwitchParameter stelt u de eigenschapswaarde in op True. Als u de eigenschapswaarde wilt wijzigen, moet u de waarde van de SwitchParameter als volgt opgeven: -ShowToolTips:$False

Met de volgende opdracht kunt u de eigenschapswaarde rechtstreeks instellen:

(Get-PSReadLineOption).ShowToolTips = $False

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

-TerminateOrphanedConsoleApps

Met deze parameter wordt de optie TerminateOrphanedConsoleApps ingesteld op $true.

Wanneer u in Windows op Ctrl+c drukt om een proces te beëindigen, ontvangt elk proces dat is gekoppeld aan een console een beëindigingssignaal, in plaats van alleen de actieve shell. Soms, wanneer een shell een grote boomstructuur met onderliggende processen heeft gestart (stel dat een buildsysteem, bijvoorbeeld) sommige processen kunnen worden afgesloten, waardoor meerdere processen gelijktijdig proberen console-invoer te gebruiken.

Wanneer u de optie $trueTerminateOrphanedConsoleApps instelt op , registreert PSReadLine de lijst met processen die momenteel aan de console zijn gekoppeld. Wanneer PSReadLine daarna wordt uitgevoerd, krijgt deze een nieuwe lijst met processen die zijn gekoppeld aan de console en beëindigt deze die zich niet in de oorspronkelijke lijst.

Deze parameter en optie zijn toegevoegd in PSReadLine 2.3.4.

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

-ViModeChangeHandler

Wanneer de ViModeIndicator is ingesteld Scriptop, wordt het opgegeven scriptblok telkens aangeroepen wanneer de modus wordt gewijzigd. Het scriptblok wordt één argument van het type ViModeopgegeven.

Deze parameter is geïntroduceerd in PowerShell 7.

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

-ViModeIndicator

Met deze optie stelt u de visuele indicator in voor de huidige Vi-modus . Invoegmodus of opdrachtmodus.

De geldige waarden zijn als volgt:

  • Geen: Er is geen indicator.
  • Prompt: de prompt verandert de kleur.
  • Cursor: De cursor verandert de grootte.
  • Script: Door de gebruiker opgegeven tekst wordt afgedrukt.
Type:ViModeStyle
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WordDelimiters

Hiermee geeft u de tekens op die woorden scheiden voor functies zoals ForwardWord of KillWord.

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

Invoerwaarden

None

U kunt geen objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

None

Deze cmdlet retourneert geen uitvoer.