Sdílet prostřednictvím


Objekt ISEOptions

Objekt ISEOptions představuje různá nastavení prostředí Windows PowerShell ISE. Jedná se o instanci třídy Microsoft.PowerShell.Host.ISE.ISEOptions .

IsEOptions objekt poskytuje následující metody a vlastnosti.

Metody

RestoreDefaultConsoleTokenColors()

Podporováno v prostředí Windows PowerShell ISE 3.0 a novějších verzích a není k dispozici v dřívějších verzích.

Obnoví výchozí hodnoty barev tokenu v podokně Konzola.

# 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 v prostředí Windows PowerShell ISE 2.0 a novějším.

Obnoví výchozí hodnoty všech nastavení možností v podokně Konzola. Také resetuje chování různých upozornění zpráv, které poskytují standardní zaškrtávací políčko, aby se zpráva znovu zobrazovala.

# 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 v prostředí Windows PowerShell ISE 2.0 a novějším.

Obnoví výchozí hodnoty barev tokenu v podokně Skript.

# 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 v prostředí Windows PowerShell ISE 3.0 a novějších verzích a není k dispozici v dřívějších verzích.

Obnoví výchozí hodnoty barev tokenů pro elementy XML, které jsou zobrazeny v prostředí 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 v prostředí Windows PowerShell ISE 3.0 a novějších verzích a není k dispozici v dřívějších verzích.

Určuje počet minut mezi automatickými operacemi ukládání souborů pomocí prostředí 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 k dispozici v prostředí Windows PowerShell ISE 2.0, ale byla odebrána nebo přejmenována v novějších verzích isE. Další verze naleznete v tématu ConsolePaneBackgroundColor.

Určuje barvu pozadí pro podokno příkazů. Jedná se o instanci třídy System.Windows.Media.Color .

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

CommandPaneUp

Tato funkce je k dispozici v prostředí Windows PowerShell ISE 2.0, ale byla odebrána nebo přejmenována v novějších verzích isE.

Určuje, jestli je podokno Příkaz umístěné nad podoknem Výstup.

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

ConsolePaneBackgroundColor

Podporováno v prostředí Windows PowerShell ISE 3.0 a novějších verzích a není k dispozici v dřívějších verzích.

Určuje barvu pozadí podokna konzoly. Jedná se o instanci třídy System.Windows.Media.Color .

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

ConsolePaneForegroundColor

Podporováno v prostředí Windows PowerShell ISE 3.0 a novějších verzích a není k dispozici v dřívějších verzích.

Určuje barvu popředí textu v podokně Konzola.

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

ConsolePaneTextBackgroundColor

Podporováno v prostředí Windows PowerShell ISE 3.0 a novějších verzích a není k dispozici v dřívějších verzích.

Určuje barvu pozadí textu v podokně Konzola.

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

ConsoleTokenColors

Podporováno v prostředí Windows PowerShell ISE 3.0 a novějších verzích a není k dispozici v dřívějších verzích.

Určuje barvy tokenů IntelliSense v podokně konzoly prostředí Windows PowerShell ISE. Tato vlastnost je objekt slovníku, který obsahuje páry názvů a hodnot typů tokenů a barev pro podokno konzoly. Pokud chcete změnit barvy tokenů IntelliSense v podokně Skript, přečtěte si téma TokenColors. Pokud chcete obnovit barvy na výchozí hodnoty, přečtěte si téma RestoreDefaultConsoleTokenColors. Barvy tokenu lze nastavit pro následující: Atribut, 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.ConsoleTokenColors["Command"] = 'green'
# Sets the color of keywords to magenta.
$psISE.Options.ConsoleTokenColors["Keyword"] = 'magenta'

DebugBackgroundColor

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

Určuje barvu pozadí pro ladicí text, který se zobrazí v podokně konzoly. Jedná se o instanci 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 v prostředí Windows PowerShell ISE 2.0 a novějším.

Určuje barvu popředí pro ladicí text, který se zobrazí v podokně konzoly. Jedná se o instanci 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 v prostředí Windows PowerShell ISE 2.0 a novějším.

Kolekce vlastností, které určují výchozí hodnoty, které se mají použít 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                      : #FFFF0000
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
IntellisenseTimeoutInSeconds              : 3

ErrorBackgroundColor

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

Určuje barvu pozadí pro text chyby, který se zobrazí v podokně konzoly. Jedná se o instanci 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 v prostředí Windows PowerShell ISE 2.0 a novějším.

Určuje barvu popředí pro text chyby, který se zobrazí v podokně konzoly. Jedná se o instanci 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 v prostředí Windows PowerShell ISE 2.0 a novějším.

Určuje název písma, který se aktuálně používá v podokně Skript i v podokně Konzola.

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

FontSize

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

Určuje velikost písma jako celé číslo. Používá se v podokně Skript, v podokně Příkaz a v podokně Výstup. Platný rozsah hodnot je 8 až 32.

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

IntellisenseTimeoutInSeconds

Podporováno v prostředí Windows PowerShell ISE 3.0 a novějších verzích a není k dispozici v dřívějších verzích.

Určuje počet sekund, které IntelliSense používá k pokusu o vyřešení aktuálně zadaného textu. Po tomto počtu sekund vyprší časový limit technologie IntelliSense a umožní 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 v prostředí Windows PowerShell ISE 3.0 a novějších verzích a není k dispozici v dřívějších verzích.

Určuje počet naposledy otevřených souborů, které prostředí Windows PowerShell ISE sleduje a zobrazuje v dolní čá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

OutputPaneBackgroundColor

Tato funkce je k dispozici v prostředí Windows PowerShell ISE 2.0, ale byla odebrána nebo přejmenována v novějších verzích isE. Další verze naleznete v tématu ConsolePaneBackgroundColor.

Vlastnost pro čtení a zápis, která získá nebo nastaví barvu pozadí pro samotné podokno Výstup. Jedná se o instanci třídy System.Windows.Media.Color .

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

OutputPaneTextForegroundColor

Tato funkce je k dispozici v prostředí Windows PowerShell ISE 2.0, ale byla odebrána nebo přejmenována v novějších verzích isE. Další verze naleznete v tématu ConsolePaneForegroundColor.

Vlastnost čtení a zápisu, která změní barvu popředí textu v podokně Výstup v prostředí 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 k dispozici v prostředí Windows PowerShell ISE 2.0, ale byla odebrána nebo přejmenována v novějších verzích isE. Další verze naleznete v tématu ConsolePaneTextBackgroundColor.

Vlastnost pro čtení a zápis, která změní barvu pozadí textu v podokně Výstup.

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

ScriptPaneBackgroundColor

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

Vlastnost pro čtení/zápis, která získá nebo nastaví barvu pozadí pro soubory. Jedná se o instanci třídy System.Windows.Media.Color .

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

ScriptPaneForegroundColor

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

Vlastnost pro čtení/zápis, která získá nebo nastaví barvu popředí pro soubory, které nejsou skripty v podokně Skript. Chcete-li nastavit barvu popředí pro soubory skriptu, použijte TokenColors.

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

SelectedScriptPaneState

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

Vlastnost pro čtení/zápis, která získá nebo nastaví pozici podokna Skript na displeji. Řetězec může být maximalizován, nahoře nebo vpravo.

# 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 v prostředí Windows PowerShell ISE 3.0 a novějších verzích a není k dispozici v dřívějších verzích.

Určuje, jestli seznam fragmentů kódu CTRL+J obsahuje úvodní sadu, která je součástí Windows PowerShellu. Pokud je tato možnost nastavená na $false, zobrazí se v seznamu CTRL+J pouze uživatelem definované fragmenty kódu. Výchozí hodnota je $true.

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

ShowIntellisenseInConsolePane

Podporováno v prostředí Windows PowerShell ISE 3.0 a novějších verzích a není k dispozici v dřívějších verzích.

Určuje, jestli IntelliSense nabízí návrhy syntaxe, parametru a hodnot v podokně konzoly. Výchozí hodnota je $true.

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

ShowIntellisenseInScriptPane

Podporováno v prostředí Windows PowerShell ISE 3.0 a novějších verzích a není k dispozici v dřívějších verzích.

Určuje, jestli IntelliSense nabízí návrhy syntaxe, parametru a hodnot v podokně Skript. Výchozí hodnota je $true.

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

ShowLineNumbers

Podporováno v prostředí Windows PowerShell ISE 3.0 a novějších verzích a není k dispozici v dřívějších verzích.

Určuje, jestli podokno Skript zobrazuje čísla řádků na levém okraji. Výchozí hodnota je $true.

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

ShowOutlining

Podporováno v prostředí Windows PowerShell ISE 3.0 a novějších verzích a není k dispozici v dřívějších verzích.

Určuje, zda podokno Skript zobrazuje rozbalitelné a sbalitelné hranaté závorky vedle oddílů kódu na levém okraji. Když se zobrazí, můžete kliknutím na ikony minus - vedle bloku textu sbalit nebo kliknutím na ikonu plus + rozbalit blok textu. Výchozí hodnota je $true.

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

ShowToolBar

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

Určuje, jestli se panel nástrojů ISE zobrazí v horní části okna prostředí Windows PowerShell ISE. Výchozí hodnota je $true.

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

ShowWarningBeforeSavingOnRun

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

Určuje, jestli se při automatickém uložení skriptu před spuštěním zobrazí zpráva upozornění. 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

ShowWarningForDuplicateFiles

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

Určuje, jestli se při otevření stejného souboru na různých kartách PowerShellu zobrazí zpráva s upozorněním. Pokud je tato možnost nastavená na $true, aby se stejný soubor otevřel na více kartách, zobrazí se tato zpráva: "Kopie tohoto souboru je otevřená na jiné kartě Windows PowerShellu. 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 v prostředí Windows PowerShell ISE 2.0 a novějším.

Určuje barvy tokenů IntelliSense v podokně Skript prostředí Windows PowerShell ISE. Tato vlastnost je objekt slovníku, který obsahuje páry názvů a hodnot typů tokenů a barev pro podokno Skript. Pokud chcete změnit barvy tokenů IntelliSense v podokně konzoly, přečtěte si téma ConsoleTokenColors. Pokud chcete obnovit barvy na výchozí hodnoty, přečtěte si téma RestoreDefaultTokenColors. Barvy tokenu lze nastavit pro následující: Atribut, 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 v prostředí Windows PowerShell ISE 3.0 a novějších verzích a není k dispozici v dřívějších verzích.

Určuje, jestli můžete pomocí klávesy Enter vybrat v podokně konzoly možnost IntelliSense. 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 v prostředí Windows PowerShell ISE 3.0 a novějších verzích a není k dispozici v dřívějších verzích.

Určuje, jestli můžete pomocí klávesy Enter vybrat možnost technologie IntelliSense v podokně Skript. 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 v prostředí Windows PowerShell ISE 3.0 a novějších verzích a není k dispozici v dřívějších verzích.

Určuje, jestli se místně nainstalovaná nápověda nebo online nápověda zobrazí, když stisknete klávesu F1 s kurzorem umístěným v klíčovém slově. Pokud je nastavená hodnota $true, zobrazí se automaticky otevírané okno s obsahem z místně nainstalované nápovědy. Soubory nápovědy můžete nainstalovat spuštěním Update-Help příkazu. Pokud je nastavená hodnota $false, otevře se váš prohlížeč na stránce na 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

VerboseBackgroundColor

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

Určuje barvu pozadí pro podrobný text, který se zobrazí v podokně konzoly. Jedná se o objekt System.Windows.Media.Color .

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

VerboseForegroundColor

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

Určuje barvu popředí pro podrobný text, který se zobrazí v podokně konzoly. Jedná se o objekt System.Windows.Media.Color .

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

WarningBackgroundColor

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

Určuje barvu pozadí pro text upozornění, který se zobrazí v podokně konzoly. Jedná se o objekt System.Windows.Media.Color .

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

WarningForegroundColor

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

Určuje barvu popředí pro text upozornění, který se zobrazí v podokně Výstup. Jedná se o objekt System.Windows.Media.Color .

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

XmlTokenColors

Podporováno v prostředí Windows PowerShell ISE 3.0 a novějších verzích a není k dispozici v dřívějších verzích.

Určuje objekt slovníku, který obsahuje páry názvů a hodnot typů a barev tokenů pro obsah XML, který se zobrazí v prostředí Windows PowerShell ISE. Barvy tokenu lze nastavit pro následující: Atribut, 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'

Zoom

Podporováno v prostředí Windows PowerShell ISE 3.0 a novějších verzích a není k dispozici v dřívějších verzích.

Určuje relativní velikost textu v podokně Konzola i Skript. Výchozí hodnota je 100. Menší hodnoty způsobí, že text v prostředí Windows PowerShell ISE bude menší, zatímco větší čísla způsobí, že text bude 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é