Sdílet prostřednictvím


Objekt ISEOptions

Objekt ISEOptions představuje různá nastavení pro Windows PowerShell ISE. Je to instance třídy Microsoft.PowerShell.Host.ISE.ISEOptions .

Objekt ISEOptions poskytuje následující metody a vlastnosti.

Methods

RestoreDefaultConsoleTokenColors()

Podporováno ve Windows PowerShell ISE 3.0 a novějších, a v dřívějších verzích nebylo.

Obnoví výchozí hodnoty barev tokenů v panelu Konzole.

# Changes the color of the commands in the Console pane to red and then restores
# it to its default value.
$psISE.Options.ConsoleTokenColors["Command"] = 'red'
$psISE.Options.RestoreDefaultConsoleTokenColors()

RestoreDefaults()

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Obnoví výchozí hodnoty všech nastavení nastavení v panelu Konzole. Také resetuje chování různých varovných zpráv, které poskytují standardní zaškrtávací políčko a zabrání opětovnému zobrazení zprávy.

# Changes the background color in the Console pane and then restores it to its default value.
$psISE.Options.ConsolePaneBackgroundColor = 'orange'
$psISE.Options.RestoreDefaults()

RestoreDefaultTokenColors()

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Obnoví výchozí hodnoty barev tokenů v panelu Script.

# Changes the color of the comments in the Script pane to red and then restores it
# to its default value.
$psISE.Options.TokenColors["Comment"] = 'red'
$psISE.Options.RestoreDefaultTokenColors()

RestoreDefaultXmlTokenColors()

Podporováno ve Windows PowerShell ISE 3.0 a novějších, a v dřívějších verzích nebylo.

Obnoví výchozí hodnoty barev tokenů pro XML prvky, které jsou zobrazeny ve Windows PowerShell ISE. Viz také XmlTokenColors.

# Changes the color of the comments in XML data to red and then restores it
# to its default value.
$psISE.Options.XmlTokenColors["Comment"] = 'red'
$psISE.Options.RestoreDefaultXmlTokenColors()

Vlastnosti

AutoSaveMinuteInterval

Podporováno ve Windows PowerShell ISE 3.0 a novějších, a v dřívějších verzích nebylo.

Určuje počet minut mezi automatickými uloženími souborů pomocí Windows PowerShell ISE. Výchozí hodnota je 2 minuty. Hodnota je celé číslo.

# Changes the number of minutes between automatic save operations to every 3 minutes.
$psISE.Options.AutoSaveMinuteInterval = 3

CommandPaneBackgroundColor

Tato funkce je přítomna ve Windows PowerShell ISE 2.0, ale v pozdějších verzích ISE byla odstraněna nebo přejmenována. Pro pozdější verze viz ConsolePaneBackgroundColor.

Specifikuje barvu pozadí pro panel Příkaz. Je to instance třídy System.Windows.Media.Color .

# Changes the background color of the Command pane to orange.
$psISE.Options.CommandPaneBackgroundColor = 'orange'

CommandPaneUp

Tato funkce je přítomna ve Windows PowerShell ISE 2.0, ale v pozdějších verzích ISE byla odstraněna nebo přejmenována.

Specifikuje, zda se panel příkazů nachází nad panelem výstupů.

# Moves the Command pane to the top of the screen.
$psISE.Options.CommandPaneUp  = $true

ConsolePaneBackgroundColor

Podporováno ve Windows PowerShell ISE 3.0 a novějších, a v dřívějších verzích nebylo.

Specifikuje barvu pozadí panelu Konzole. Je to instance třídy System.Windows.Media.Color .

# Changes the background color of the Console pane to red.
$psISE.Options.ConsolePaneBackgroundColor = 'red'

ConsolePaneForegroundColor

Podporováno ve Windows PowerShell ISE 3.0 a novějších, a v dřívějších verzích nebylo.

Specifikuje barvu textu v popředí panelu Konzole.

# Changes the foreground color of the text in the Console pane to yellow.
$psISE.Options.ConsolePaneForegroundColor  = 'yellow'

ConsolePaneTextBackgroundColor

Podporováno ve Windows PowerShell ISE 3.0 a novějších, a v dřívějších verzích nebylo.

Specifikuje barvu pozadí textu v panelu Konzole.

# Changes the background color of the Console pane text to pink.
$psISE.Options.ConsolePaneTextBackgroundColor = 'pink'

ConsoleTokenColors

Podporováno ve Windows PowerShell ISE 3.0 a novějších, a v dřívějších verzích nebylo.

Specifikuje barvy tokenů IntelliSense v panelu Windows PowerShell ISE Console. Tato vlastnost je slovníkový objekt, který obsahuje dvojice jmen/hodnota typů tokenů a barev pro panel Konzole. Pro změnu barev tokenů IntelliSense v panelu Script viz TokenColors. Pro obnovení barev na výchozí hodnoty viz RestoreDefaultConsoleTokenColors. Barvy žetonů lze nastavit pro následující: , , , , , AttributeCommand, CommandArgument, CommandParameter. CommentGroupEndGroupStartKeywordLineContinuationLoopLabelMemberNewLineNumberOperatorPositionStatementSeparatorStringTypeUnknownVariable

# Sets the color of commands to green.
$psISE.Options.ConsoleTokenColors["Command"] = 'green'
# Sets the color of keywords to magenta.
$psISE.Options.ConsoleTokenColors["Keyword"] = 'magenta'

DebugBackgroundColor

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Specifikuje barvu pozadí pro ladění textu, který se objevuje v panelu Konzole. Je to instance třídy System.Windows.Media.Color .

# Changes the background color for the debug text that appears in the Console pane
# to blue.
$psISE.Options.DebugBackgroundColor = '#0000FF'

DebugForegroundColor

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Specifikuje barvu popředí pro ladicí text, který se objevuje v panelu Konzole. Je to instance třídy System.Windows.Media.Color .

# Changes the foreground color for the debug text that appears in the Console
# pane to yellow.
$psISE.Options.DebugForegroundColor = 'yellow'

DefaultOptions

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Sbírka vlastností, které určují výchozí hodnoty používané při použití metod Reset.

# Displays the name of the default options. This example is from ISE 4.0.
$psISE.Options.DefaultOptions
SelectedScriptPaneState                   : Top
ShowDefaultSnippets                       : True
ShowToolBar                               : True
ShowOutlining                             : True
ShowLineNumbers                           : True
TokenColors                               : {[Attribute, #FF00BFFF], [Command, #FF0000FF],
                                            [CommandArgument, #FF8A2BE2], [CommandParameter, #FF000080]...}
ConsoleTokenColors                        : {[Attribute, #FFB0C4DE], [Command, #FFE0FFFF],
                                            [CommandArgument, #FFEE82EE], [CommandParameter, #FFFFE4B5]...}
XmlTokenColors                            : {[Comment, #FF006400], [CommentDelimiter, #FF008000],
                                            [ElementName, #FF8B0000], [MarkupExtension, #FFFF8C00]...}
DefaultOptions                            : Microsoft.PowerShell.Host.ISE.ISEOptions
FontSize                                  : 9
Zoom                                      : 100
FontName                                  : Lucida Console
ErrorForegroundColor                      : #FFFF9494
ErrorBackgroundColor                      : #00FFFFFF
WarningForegroundColor                    : #FFFF8C00
WarningBackgroundColor                    : #00FFFFFF
VerboseForegroundColor                    : #FF00FFFF
VerboseBackgroundColor                    : #00FFFFFF
DebugForegroundColor                      : #FF00FFFF
DebugBackgroundColor                      : #00FFFFFF
ConsolePaneBackgroundColor                : #FF012456
ConsolePaneTextBackgroundColor            : #FF012456
ConsolePaneForegroundColor                : #FFF5F5F5
ScriptPaneBackgroundColor                 : #FFFFFFFF
ScriptPaneForegroundColor                 : #FF000000
ShowWarningForDuplicateFiles              : True
ShowWarningBeforeSavingOnRun              : True
UseLocalHelp                              : True
AutoSaveMinuteInterval                    : 2
MruCount                                  : 10
ShowIntellisenseInConsolePane             : True
ShowIntellisenseInScriptPane              : True
UseEnterToSelectInConsolePaneIntellisense : True
UseEnterToSelectInScriptPaneIntellisense  : True

ChybaPozadíBarva

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Specifikuje barvu pozadí pro chybový text, který se objevuje v panelu Konzole. Je to instance třídy System.Windows.Media.Color .

# Changes the background color for the error text that appears in the Console pane to black.
$psISE.Options.ErrorBackgroundColor = 'black'

ErrorForegroundColor

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Specifikuje barvu popředí pro chybový text, který se objevuje v panelu Konzole. Je to instance třídy System.Windows.Media.Color .

# Changes the foreground color for the error text that appears in the console pane to green.
$psISE.Options.ErrorForegroundColor = 'green'

FontName

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Specifikuje název písma, který se aktuálně používá jak v panelu Script, tak v panelu Konzole.

# Changes the font used in both panes.
$psISE.Options.FontName = 'Courier New'

Velikost písma

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Specifikuje velikost písma jako celé číslo. Používá se v panelu Script, panelu Command a panelu Output. Platný rozsah hodnot je 8 až 32.

# Changes the font size in all panes.
$psISE.Options.FontSize = 20

IntellisenseTimeoutInSecondsSeconds

Podporováno ve Windows PowerShell ISE 3.0 a novějších, a v dřívějších verzích nebylo.

Určuje počet sekund, které IntelliSense používá k pokusu o vyřešení aktuálně psaného textu. Po tomto počtu sekund IntelliSense vyprší a umožní vám pokračovat v psaní. Výchozí hodnota je 3 sekundy. Hodnota je celé číslo.

# Changes the number of seconds for IntelliSense syntax recognition to 5.
$psISE.Options.IntellisenseTimeoutInSeconds = 5

MruCount

Podporováno ve Windows PowerShell ISE 3.0 a novějších, a v dřívějších verzích nebylo.

Specifikuje počet nedávno otevřených souborů, které Windows PowerShell ISE sleduje a zobrazuje ve spodní části nabídky Otevřít soubor. Výchozí hodnota je 10. Hodnota je celé číslo.

# Changes the number of recently used files that appear at the bottom of the
# File Open menu to 5.
$psISE.Options.MruCount = 5

VýstupPaneBackgroundColor

Tato funkce je přítomna ve Windows PowerShell ISE 2.0, ale v pozdějších verzích ISE byla odstraněna nebo přejmenována. Pro pozdější verze viz ConsolePaneBackgroundColor.

Vlastnost čtení/zápis, která získává nebo nastavuje barvu pozadí pro samotné okno Výstup. Je to instance třídy System.Windows.Media.Color .

# Changes the background color of the Output pane to gold.
$psISE.Options.OutputPaneForegroundColor = 'gold'

OutputPaneTextForegroundColor

Tato funkce je přítomna ve Windows PowerShell ISE 2.0, ale v pozdějších verzích ISE byla odstraněna nebo přejmenována. Pro pozdější verze viz ConsolePaneForegroundColor.

Vlastnost čtení/zápis, která mění barvu popředí textu v panelu Výstup ve Windows PowerShell ISE 2.0.

# Changes the foreground color of the text in the Output Pane to blue.
$psISE.Options.OutputPaneTextForegroundColor  = 'blue'

OutputPaneTextBackgroundColor

Tato funkce je přítomna ve Windows PowerShell ISE 2.0, ale v pozdějších verzích ISE byla odstraněna nebo přejmenována. Pro pozdější verze viz ConsolePaneTextBackgroundColor.

Vlastnost čtení/zápis, která mění barvu pozadí textu v panelu Výstup.

# Changes the background color of the Output pane text to pink.
$psISE.Options.OutputPaneTextBackgroundColor = 'pink'

ScriptPaneBackgroundColor

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Vlastnost čtení/zápis, která získává nebo nastavuje barvu pozadí souborů. Je to instance třídy System.Windows.Media.Color .

# Sets the color of the script pane background to yellow.
$psISE.Options.ScriptPaneBackgroundColor = 'yellow'

ScriptPaneForegroundColor

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Vlastnost čtení/zápis, která získává nebo nastavuje barvu popředí pro neskriptové soubory v panelu Script. Pro nastavení barvy popředí pro skriptové soubory použijte TokenColors.

# Sets the foreground to color of non-script files in the script pane to green.
$psISE.Options.ScriptPaneBackgroundColor = 'green'

SelectScriptPaneState

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Vlastnost čtení/zápis, která získává nebo nastavuje pozici panelu Script na displeji. Řetězec může být buď 'Maximalizovaný', 'Top' nebo 'Right'.

# Moves the Script Pane to the top.
$psISE.Options.SelectedScriptPaneState = 'Top'
# Moves the Script Pane to the right.
$psISE.Options.SelectedScriptPaneState = 'Right'
# Maximizes the Script Pane
$psISE.Options.SelectedScriptPaneState = 'Maximized'

ShowDefaultSnippets

Podporováno ve Windows PowerShell ISE 3.0 a novějších, a v dřívějších verzích nebylo.

Specifikuje, zda seznam útržků Ctrl+J zahrnuje startovací sadu, která je zahrnuta ve Windows PowerShell. Při nastavení na $false, v seznamu Ctrl+J se objevují pouze uživatelsky definované úryvky. Výchozí hodnota je $true.

# Hide the default snippets from the Ctrl+J list.
$psISE.Options.ShowDefaultSnippets = $false

ShowIntellisenseInConsolePane

Podporováno ve Windows PowerShell ISE 3.0 a novějších, a v dřívějších verzích nebylo.

Specifikuje, zda IntelliSense nabízí návrhy syntaxe, parametrů a hodnot v panelu Konzole. Výchozí hodnota je $true.

# Turn off IntelliSense in the console pane.
$psISE.Options.ShowIntellisenseInConsolePane = $false

ShowIntellisenseInScriptPane

Podporováno ve Windows PowerShell ISE 3.0 a novějších, a v dřívějších verzích nebylo.

Specifikuje, zda IntelliSense nabízí návrhy syntaxe, parametrů a hodnot v panelu Script. Výchozí hodnota je $true.

# Turn off IntelliSense in the Script pane.
$psISE.Options.ShowIntellisenseInScriptPane = $false

ShowLineNumbers

Podporováno ve Windows PowerShell ISE 3.0 a novějších, a v dřívějších verzích nebylo.

Specifikuje, zda panel Script zobrazuje čísla řádků v levém okraji. Výchozí hodnota je $true.

# Turn off line numbers in the Script pane.
$psISE.Options.ShowLineNumbers = $false

Náčrt pořadu

Podporováno ve Windows PowerShell ISE 3.0 a novějších, a v dřívějších verzích nebylo.

Specifikuje, zda panel Script zobrazuje rozbalitelné a skládací závorky vedle částí kódu v levém okraji. Když se zobrazí, můžete kliknout na mínusové - ikony vedle bloku textu a sbalit ho nebo kliknout na ikonu plus + pro rozbalení bloku textu. Výchozí hodnota je $true.

# Turn off outlining in the Script pane.
$psISE.Options.ShowOutlining = $false

ShowToolBar

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Specifikuje, zda se panel nástrojů ISE zobrazuje v horní části okna Windows PowerShell ISE. Výchozí hodnota je $true.

# Show the toolbar.
$psISE.Options.ShowToolBar = $true

UkázatVarováníPředtímNež utečete

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Specifikuje, zda se při automatickém uložení skriptu objeví varovná zpráva před jeho spuštěním. Výchozí hodnota je $true.

# Enable the warning message when an attempt
# is made to run a script without saving it first.
$psISE.Options.ShowWarningBeforeSavingOnRun = $true

Zobrazit varováníProDuplicitníSoubory

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Specifikuje, zda se při otevření stejného souboru v různých záložkách PowerShell objeví varovná zpráva. Pokud je nastaveno na $true, aby se stejný soubor otevřel ve více kartách, zobrazí se tato zpráva: "Kopie tohoto souboru je otevřena v jiné záložce Windows PowerShell. Změny provedené v tomto souboru ovlivní všechny otevřené kopie." Výchozí hodnota je $true.

# Enable the warning message when a file is
# opened in multiple PowerShell tabs.
$psISE.Options.ShowWarningForDuplicateFiles = $true

TokenColors

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Specifikuje barvy tokenů IntelliSense v panelu Windows PowerShell ISE Script. Tato vlastnost je slovníkový objekt, který obsahuje dvojice jmen/hodnota typů tokenů a barev pro panel Script. Pro změnu barev tokenů IntelliSense v panelu Konzole viz ConsoleTokenColors. Pro obnovení barev na výchozí hodnoty viz RestoreDefaultTokenColors. Barvy tokenů lze nastavit pro následující: Attribute, Command, CommandArgument, CommandParameter, Comment, GroupEnd, GroupStart, Keyword, LineContinuation, LoopLabel, Member, NewLine, Number, Operator, Position, StatementSeparator, String, Type, Unknown, Variable.

# Sets the color of commands to green.
$psISE.Options.TokenColors["Command"] = "green"
# Sets the color of keywords to magenta.
$psISE.Options.TokenColors["Keyword"] = "magenta"

UseEnterToSelectInConsolePaneIntellisense

Podporováno ve Windows PowerShell ISE 3.0 a novějších, a v dřívějších verzích nebylo.

Specifikuje, zda můžete použít klávesu Enter k výběru možnosti poskytované IntelliSense v panelu Konzole. Výchozí hodnota je $true.

# Turn off using the ENTER key to select an IntelliSense provided option in the Console pane.
$psISE.Options.UseEnterToSelectInConsolePaneIntellisense = $false

UseEnterToSelectInScriptPaneIntellisense

Podporováno ve Windows PowerShell ISE 3.0 a novějších, a v dřívějších verzích nebylo.

Specifikuje, zda můžete použít klávesu Enter k výběru možnosti poskytnuté IntelliSense v panelu Script. Výchozí hodnota je $true.

# Turn on using the Enter key to select an IntelliSense provided option in the Console pane.
$psISE.Options.UseEnterToSelectInConsolePaneIntellisense = $true

UseLocalHelp

Podporováno ve Windows PowerShell ISE 3.0 a novějších, a v dřívějších verzích nebylo.

Specifikuje, zda se při stisknutí F1 s kurzorem v klíčovém slově objeví lokálně nainstalovaná Nápověda nebo online Nápověda. Pokud je nastaveno na $true, zobrazí se vyskakovací okno s obsahem z lokálně nainstalované nápovědy. Nápovědu můžete nainstalovat spuštěním příkazu Update-Help . Pokud je nastaveno na $false, prohlížeč otevře stránku v Microsoft Learn.

# Sets the option for the online help to be displayed.
$psISE.Options.UseLocalHelp = $false
# Sets the option for the local Help to be displayed.
$psISE.Options.UseLocalHelp = $true

SlovoPozadíBarva

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Specifikuje barvu pozadí pro rozvláčný text, který se objevuje v panelu Konzole. Je to objekt System.Windows.Media.Color .

# Changes the background color for verbose text to blue.
$psISE.Options.VerboseBackgroundColor ='#0000FF'

SlovoPředníBarva

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Specifikuje barvu popředí pro rozvláčný text, který se objevuje v panelu Konzole. Je to objekt System.Windows.Media.Color .

# Changes the foreground color for verbose text to yellow.
$psISE.Options.VerboseForegroundColor = 'yellow'

VarováníPozadíBarva

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Specifikuje barvu pozadí varovného textu, který se objevuje v panelu Konzole. Je to objekt System.Windows.Media.Color .

# Changes the background color for warning text to blue.
$psISE.Options.WarningBackgroundColor = '#0000FF'

VarováníFrontgroundColor

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Specifikuje barvu popředí varovného textu, který se objevuje v panelu Výstup. Je to objekt System.Windows.Media.Color .

# Changes the foreground color for warning text to yellow.
$psISE.Options.WarningForegroundColor = 'yellow'

XmlTokenColors

Podporováno ve Windows PowerShell ISE 3.0 a novějších, a v dřívějších verzích nebylo.

Specifikuje slovníkový objekt, který obsahuje dvojice jmen/hodnota typů tokenů a barev pro XML obsah zobrazený ve Windows PowerShell ISE. Barvy tokenů lze nastavit pro následující: Attribute, Command, CommandArgument, CommandParameter, Comment, GroupEnd, GroupStart, Keyword, LineContinuation, LoopLabel, Member, NewLine, Number, Operator, Position, StatementSeparator, String, Type, Unknown, Variable. Viz také RestoreDefaultXmlTokenColors.

# Sets the color of XML element names to green.
$psISE.Options.XmlTokenColors["ElementName"] = 'green'
# Sets the color of XML comments to magenta.
$psISE.Options.XmlTokenColors["Comment"] = 'magenta'

Zvětšení

Podporováno ve Windows PowerShell ISE 3.0 a novějších, a v dřívějších verzích nebylo.

Specifikuje relativní velikost textu jak v panelech Konzole, tak ve Skriptech. Výchozí hodnota je 100. Menší hodnoty způsobují, že text ve Windows PowerShell ISE vypadá menší, zatímco větší čísla způsobují, že text se zdá větší. Hodnota je celé číslo, které se pohybuje od 20 do 400.

# Changes the text in the Windows PowerShell ISE to be double its normal size.
$psISE.Options.Zoom = 200

Viz také