Udostępnij przez

Obiekt ISEOptions

Obiekt ISEOptions reprezentuje różne ustawienia dla Windows PowerShell ISE. To instancja klasy Microsoft.PowerShell.Host.ISE.ISEOptions .

Obiekt ISEOptions oferuje następujące metody i właściwości.

Methods

RestoreDefaultConsoleTokenColors()

Obsługiwany w Windows PowerShell ISE 3.0 i nowszych, a nie występował w wcześniejszych wersjach.

Przywraca domyślne wartości kolorów tokenów w panelu konsoli.

# 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()

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Przywraca domyślne wartości wszystkich ustawień opcji w panelu konsoli. Resetuje także zachowanie różnych komunikatów ostrzegawczych, które zapewniają standardowe pole zaznaczenia, aby zapobiec ponownemu wyświetlaniu komunikatu.

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

RestoreDefaultTokenColors()

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Przywraca domyślne wartości kolorów tokenów w 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()

Obsługiwany w Windows PowerShell ISE 3.0 i nowszych, a nie występował w wcześniejszych wersjach.

Przywraca domyślne wartości kolorów tokenów dla elementów XML wyświetlanych w Windows PowerShell ISE. Zobacz także 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()

Właściwości

AutoSaveMinuteInterval

Obsługiwany w Windows PowerShell ISE 3.0 i nowszych, a nie występował w wcześniejszych wersjach.

Określa liczbę minut między automatycznymi operacjami zapisu plików przez Windows PowerShell ISE. Domyślna wartość to 2 minuty. Wartość jest liczbą całkowitą.

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

CommandPaneBackgroundColor

Ta funkcja jest obecna w Windows PowerShell ISE 2.0, ale została usunięta lub przemianowana w późniejszych wersjach ISE. Późniejsze wersje można znaleźć w sekcji ConsolePaneBackgroundColor.

Określa kolor tła dla panelu Command. To instancja klasy System.Windows.Media.Color .

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

CommandPaneUp

Ta funkcja jest obecna w Windows PowerShell ISE 2.0, ale została usunięta lub przemianowana w późniejszych wersjach ISE.

Określa, czy panel Poleceń znajduje się nad panelem Wyjście.

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

ConsolePaneBackgroundColor

Obsługiwany w Windows PowerShell ISE 3.0 i nowszych, a nie występował w wcześniejszych wersjach.

Określa kolor tła dla panelu konsoli. To instancja klasy System.Windows.Media.Color .

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

ConsolePaneForegroundColor

Obsługiwany w Windows PowerShell ISE 3.0 i nowszych, a nie występował w wcześniejszych wersjach.

Określa kolor pierwszego planu tekstu w panelu konsoli.

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

ConsolePaneTextBackgroundColor

Obsługiwany w Windows PowerShell ISE 3.0 i nowszych, a nie występował w wcześniejszych wersjach.

Określa kolor tła tekstu w panelu konsoli.

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

ConsoleTokenColors

Obsługiwany w Windows PowerShell ISE 3.0 i nowszych, a nie występował w wcześniejszych wersjach.

Określa kolory tokenów IntelliSense w panelu konsoli Windows PowerShell ISE. Ta własność jest obiektem słownikowym zawierającym pary nazw/wartość typów i kolorów tokenów dla panelu konsoli. Aby zmienić kolory tokenów IntelliSense w panelu Script, zobacz TokenColors. Aby przywrócić kolory do wartości domyślnych, zobacz RestoreDefaultConsoleTokenColors. Kolory żetonów można ustawić dla następujących parametrów: Attribute, Command, , CommandArgument, CommandParameterCommentGroupEndGroupStartKeywordLineContinuationLoopLabelMemberNewLineNumberOperatorPositionStatementSeparatorStringTypeUnknown. 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

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Określa kolor tła dla tekstu debugującego pojawiającego się w panelu konsoli. To instancja klasy System.Windows.Media.Color .

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

DebugFrontgroundColor

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Określa kolor pierwszego planu tekstu debugującego pojawiającego się w panelu konsoli. To instancja klasy 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

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Zbiór właściwości określających domyślne wartości używane podczas stosowania 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

BłądKolor Tła

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Określa kolor tła dla tekstu błędu pojawiającego się w panelu konsoli. To instancja klasy System.Windows.Media.Color .

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

BłądKolor Pierwszego Planu

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Określa kolor pierwszego planu dla tekstu błędu pojawiającego się w panelu konsoli. To instancja klasy 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

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Określa nazwę czcionki używanej zarówno w panelu Script, jak i Konsoli.

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

Rozmiar czcionki

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Określa rozmiar czcionki jako liczbę całkowitą. Jest używany w panelu Script, panelu Command oraz panelu Output. Prawidłowy zakres wartości to od 8 do 32.

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

IntellisenseTimeoutInSecondss

Obsługiwany w Windows PowerShell ISE 3.0 i nowszych, a nie występował w wcześniejszych wersjach.

Określa liczbę sekund, które IntelliSense wykorzystuje na próbę rozwiązywania aktualnie wpisanego tekstu. Po tej liczbie sekund IntelliSense się kończy i pozwala kontynuować pisanie. Domyślna wartość to 3 sekundy. Wartość jest liczbą całkowitą.

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

MruCount

Obsługiwany w Windows PowerShell ISE 3.0 i nowszych, a nie występował w wcześniejszych wersjach.

Określa liczbę niedawno otwartych plików, które Windows PowerShell ISE śledzi i wyświetla na dole menu File Open . Wartość domyślna to 10. Wartość jest liczbą całkowitą.

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

OutputPaneBackgroundColor

Ta funkcja jest obecna w Windows PowerShell ISE 2.0, ale została usunięta lub przemianowana w późniejszych wersjach ISE. Późniejsze wersje można znaleźć w sekcji ConsolePaneBackgroundColor.

Właściwość odczytu/zapisu, która otrzymuje lub ustawia kolor tła dla samej tablicy wyjściowej. To instancja klasy System.Windows.Media.Color .

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

OutputPaneTextForegroundColor

Ta funkcja jest obecna w Windows PowerShell ISE 2.0, ale została usunięta lub przemianowana w późniejszych wersjach ISE. Późniejsze wersje można znaleźć w ConsolePaneForegroundColor.

Właściwość czytania/zapisu, która zmienia kolor pierwszego planu tekstu w panelu Output w Windows PowerShell ISE 2.0.

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

OutputPaneTextBackgroundColor

Ta funkcja jest obecna w Windows PowerShell ISE 2.0, ale została usunięta lub przemianowana w późniejszych wersjach ISE. Późniejsze wersje można znaleźć w sekcji ConsolePaneTextBackgroundColor.

Właściwość odczytu/zapisu, która zmienia kolor tła tekstu w panelu Output.

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

ScriptPaneBackgroundColor

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Właściwość odczytu/zapisu, która pobiera lub ustawia kolor tła dla plików. To instancja klasy System.Windows.Media.Color .

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

ScriptPaneForegroundColor

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Właściwość czytania/zapisu, która pobiera lub ustawia kolor pierwszego planu dla plików nieskryptowych w panelu skryptów. Aby ustawić kolor pierwszego planu dla plików skryptowych, użyj TokenColors.

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

SelectScriptPaneState

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Właściwość odczytu/zapisu, która ustala lub ustawia pozycję panelu skryptowego na wyświetlaczu. Struna może być "Zmaksymalizowana", "Górna" lub "Prawa".

# 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'

Pokaż domyślneFragmenty

Obsługiwany w Windows PowerShell ISE 3.0 i nowszych, a nie występował w wcześniejszych wersjach.

Określa, czy lista fragmentów Ctrl+J zawiera zestaw startowy zawarty w Windows PowerShell. Po ustawieniu na $false, w liście Ctrl+J pojawiają się tylko fragmenty zdefiniowane przez użytkownika. Domyślna wartość to $true.

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

Pokaż IntellisenseInConsolePane

Obsługiwany w Windows PowerShell ISE 3.0 i nowszych, a nie występował w wcześniejszych wersjach.

Określa, czy IntelliSense oferuje sugestie składni, parametrów i wartości w panelu konsoli. Domyślna wartość to $true.

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

Pokaż IntellisenseInScriptPane

Obsługiwany w Windows PowerShell ISE 3.0 i nowszych, a nie występował w wcześniejszych wersjach.

Określa, czy IntelliSense oferuje sugestie składni, parametrów i wartości w panelu Script. Domyślna wartość to $true.

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

ShowLineNumbers

Obsługiwany w Windows PowerShell ISE 3.0 i nowszych, a nie występował w wcześniejszych wersjach.

Określa, czy panel Script wyświetla numery linii w lewym marginesie. Domyślna wartość to $true.

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

Konspekt programu

Obsługiwany w Windows PowerShell ISE 3.0 i nowszych, a nie występował w wcześniejszych wersjach.

Określa, czy panel skryptowy wyświetla rozkładalne i składane nawiasy obok sekcji kodu w lewym marginesie. Gdy są wyświetlane, możesz kliknąć ikony minus - obok bloku tekstu, aby go zwinąć, lub kliknąć ikonę plus + , aby powiększyć blok tekstu. Domyślna wartość to $true.

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

ShowToolBar

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Określa, czy pasek narzędzi ISE pojawia się u góry okna Windows PowerShell ISE. Domyślna wartość to $true.

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

OstrzeżeniePrzed Ucieczką

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Określa, czy komunikat ostrzegawczy pojawia się, gdy skrypt zostanie zapisany automatycznie przed jego uruchomieniem. Domyślna wartość to $true.

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

OstrzeżenieOPlikówPlików

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Określa, czy komunikat ostrzegawczy pojawia się, gdy ten sam plik zostanie otwarty w różnych zakładkach PowerShell. Jeśli ustawimy na $true, aby otworzyć ten sam plik w wielu zakładkach, pojawi się komunikat: "Kopia tego pliku jest otwarta w innej zakładce Windows PowerShell. Zmiany dokonane w tym pliku wpłyną na wszystkie otwarte kopie." Domyślna wartość to $true.

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

TokenColors

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Określa kolory tokenów IntelliSense w panelu skryptów Windows PowerShell ISE. Ta właściwość jest obiektem słownika zawierającym pary nazw/wartość typów tokenów i kolorów dla panelu Script. Aby zmienić kolory tokenów IntelliSense w panelu konsoli, zobacz ConsoleTokenColors. Aby przywrócić kolory do wartości domyślnych, zobacz RestoreDefaultTokenColors. Kolory tokenów można ustawić na następujące kategorie: Attribute, Command, CommandArgument, CommandParameter, Comment, GroupEnd, GroupStart, Keyword, LineContinuation, LoopLabel, Member, NewLine, Number, Operator, Position, CommandSeparator, 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

Obsługiwany w Windows PowerShell ISE 3.0 i nowszych, a nie występował w wcześniejszych wersjach.

Określa, czy można użyć Enter, aby wybrać opcję udostępnioną przez IntelliSense w panelu konsoli. Domyślna wartość to $true.

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

UseEnterToSelectInScriptPaneIntellisense

Obsługiwany w Windows PowerShell ISE 3.0 i nowszych, a nie występował w wcześniejszych wersjach.

Określa, czy można użyć Enter do wyboru opcji dostarczonej przez IntelliSense w panelu Script. Domyślna wartość to $true.

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

UżyjLocalHelp

Obsługiwany w Windows PowerShell ISE 3.0 i nowszych, a nie występował w wcześniejszych wersjach.

Określa, czy lokalnie zainstalowana Pomoc, czy online Pomoc pojawia się, gdy naciśniesz F1 z kursorem umieszczonym w słowie kluczowym. Jeśli ustawisz na $true, to okno wyskakujące pokazuje zawartość lokalnie zainstalowanej pomocy (Help). Możesz zainstalować pliki pomocy, uruchamiając polecenie Update-Help . Jeśli ustawiono na $false, to przeglądarka otwiera stronę w 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

SłowoKolor Tła

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Określa kolor tła dla rozwlekłego tekstu pojawiającego się w panelu konsoli. To obiekt System.Windows.Media.Color .

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

SłowaPrzódKolor

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Określa kolor pierwszego planu dla rozbudowanego tekstu pojawiającego się w panelu konsoli. To obiekt System.Windows.Media.Color .

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

OstrzeżenieTłoKolor

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Określa kolor tła dla tekstu ostrzegawczego pojawiającego się w panelu konsoli. To obiekt System.Windows.Media.Color .

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

OstrzeżenieKolor pierwszego planu

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Określa kolor pierwszego planu tekstu ostrzegawczego pojawiającego się w panelu Wyjście. To obiekt System.Windows.Media.Color .

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

XmlTokenColors

Obsługiwany w Windows PowerShell ISE 3.0 i nowszych, a nie występował w wcześniejszych wersjach.

Określa obiekt słownika zawierający pary nazwy/wartość typów tokenów i kolorów dla treści XML wyświetlanej w Windows PowerShell ISE. Kolory tokenów można ustawić na następujące kategorie: Attribute, Command, CommandArgument, CommandParameter, Comment, GroupEnd, GroupStart, Keyword, LineContinuation, LoopLabel, Member, NewLine, Number, Operator, Position, CommandSeparator, String, Type, Unknown, Variable. Zobacz także 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'

Powiększenie

Obsługiwany w Windows PowerShell ISE 3.0 i nowszych, a nie występował w wcześniejszych wersjach.

Określa względny rozmiar tekstu zarówno w panelu Konsola, jak i Skrypt. Wartość domyślna to 100. Mniejsze wartości powodują, że tekst w Windows PowerShell ISE wydaje się mniejszy, podczas gdy większe liczby powodują, że tekst wydaje się większy. Wartość ta jest liczbą całkowitą mieszczącą się w zakresie od 20 do 400.

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

Zobacz też

  • Last updated on