Das ISEOptions-Objekt
Das ISEOptions-Objekt stellt verschiedene Einstellungen für Windows PowerShell ISE dar. Es ist eine Instanz der Microsoft.PowerShell.Host.ISE.ISEOptions-Klasse.
Das ISEOptions-Objekt stellt die folgenden Methoden und Eigenschaften bereit.
Methoden
RestoreDefaultConsoleTokenColors()
In Windows PowerShell ISE 3.0 und höher unterstützt, in früheren Versionen nicht enthalten.
Stellt die Standardwerte für die Tokenfarben im Konsolenbereich wieder her.
# 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()
In Windows PowerShell ISE 2.0 und höher unterstützt.
Stellt die Standardwerte aller Optionseinstellungen im Konsolenbereich wieder her. Außerdem wird das Verhalten von verschiedenen Warnmeldungen zurückgesetzt, in denen das Standardkontrollkästchen angezeigt wird, mit dem das erneute Anzeigen der Nachricht verhindert werden kann.
# Changes the background color in the Console pane and then restores it to its default value.
$psISE.Options.ConsolePaneBackgroundColor = 'orange'
$psISE.Options.RestoreDefaults()
RestoreDefaultTokenColors()
In Windows PowerShell ISE 2.0 und höher unterstützt.
Stellt die Standardwerte für die Tokenfarben im Skriptbereich wieder her.
# 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()
In Windows PowerShell ISE 3.0 und höher unterstützt, in früheren Versionen nicht enthalten.
Stellt die Standardwerte für die Tokenfarben für XML-Elemente wieder her, die in Windows PowerShell ISE angezeigt werden. Siehe auch 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()
Eigenschaften
AutoSaveMinuteInterval
In Windows PowerShell ISE 3.0 und höher unterstützt, in früheren Versionen nicht enthalten.
Gibt die Anzahl der Minuten zwischen automatischen Speichervorgängen Ihrer Dateien durch Windows PowerShell ISE an. Der Standardwert beträgt 2 Minuten. Der Wert ist eine ganze Zahl.
# Changes the number of minutes between automatic save operations to every 3 minutes.
$psISE.Options.AutoSaveMinuteInterval = 3
CommandPaneBackgroundColor
Dieses Feature ist in Windows PowerShell ISE 2.0 enthalten, wurde in höheren Versionen von ISE aber entfernt oder umbenannt. Informationen zu höheren Versionen finden Sie unter ConsolePaneBackgroundColor.
Gibt die Hintergrundfarbe für den Befehlsbereich an. Dies ist eine Instanz der System.Windows.Media.Color-Klasse.
# Changes the background color of the Command pane to orange.
$psISE.Options.CommandPaneBackgroundColor = 'orange'
CommandPaneUp
Dieses Feature ist in Windows PowerShell ISE 2.0 enthalten, wurde in höheren Versionen von ISE aber entfernt oder umbenannt.
Gibt an, ob sich der Befehlsbereich oberhalb des Ausgabebereichs befindet.
# Moves the Command pane to the top of the screen.
$psISE.Options.CommandPaneUp = $true
ConsolePaneBackgroundColor
In Windows PowerShell ISE 3.0 und höher unterstützt, in früheren Versionen nicht enthalten.
Gibt die Hintergrundfarbe für den Konsolenbereich an. Dies ist eine Instanz der System.Windows.Media.Color-Klasse.
# Changes the background color of the Console pane to red.
$psISE.Options.ConsolePaneBackgroundColor = 'red'
ConsolePaneForegroundColor
In Windows PowerShell ISE 3.0 und höher unterstützt, in früheren Versionen nicht enthalten.
Gibt die Vordergrundfarbe des Texts im Konsolenbereich an.
# Changes the foreground color of the text in the Console pane to yellow.
$psISE.Options.ConsolePaneForegroundColor = 'yellow'
ConsolePaneTextBackgroundColor
In Windows PowerShell ISE 3.0 und höher unterstützt, in früheren Versionen nicht enthalten.
Gibt die Hintergrundfarbe des Texts im Konsolenbereich an.
# Changes the background color of the Console pane text to pink.
$psISE.Options.ConsolePaneTextBackgroundColor = 'pink'
ConsoleTokenColors
In Windows PowerShell ISE 3.0 und höher unterstützt, in früheren Versionen nicht enthalten.
Gibt die Farben der IntelliSense-Token im Windows PowerShell ISE-Konsolenbereich an. Diese Eigenschaft ist ein Wörterbuchobjekt, das Name-Wert-Paare von Tokentypen und Farben für den Konsolenbereich enthält. Informationen zum Ändern der Farben der IntelliSense-Token im Skriptbereich finden Sie unter TokenColors. Informationen zum Zurücksetzen der Farben auf die Standardwerte finden Sie unter RestoreDefaultConsoleTokenColors. Tokenfarben können für folgende Elemente festgelegt werden: 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.ConsoleTokenColors["Command"] = 'green'
# Sets the color of keywords to magenta.
$psISE.Options.ConsoleTokenColors["Keyword"] = 'magenta'
DebugBackgroundColor
In Windows PowerShell ISE 2.0 und höher unterstützt.
Gibt die Hintergrundfarbe für den Debugtext an, der im Konsolenbereich angezeigt wird. Dies ist eine Instanz der System.Windows.Media.Color-Klasse.
# Changes the background color for the debug text that appears in the Console pane to blue.
$psISE.Options.DebugBackgroundColor = '#0000FF'
DebugForegroundColor
In Windows PowerShell ISE 2.0 und höher unterstützt.
Gibt die Vordergrundfarbe für den Debugtext an, der im Konsolenbereich angezeigt wird. Dies ist eine Instanz der System.Windows.Media.Color-Klasse.
# Changes the foreground color for the debug text that appears in the Console pane to yellow.
$psISE.Options.DebugForegroundColor = 'yellow'
DefaultOptions
In Windows PowerShell ISE 2.0 und höher unterstützt.
Eine Sammlung von Eigenschaften, mit denen die Standardwerte angegeben werden, die bei Verwendung der Reset-Methoden verwendet werden sollen.
# 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
In Windows PowerShell ISE 2.0 und höher unterstützt.
Gibt die Hintergrundfarbe für den Fehlertext an, der im Konsolenbereich angezeigt wird. Dies ist eine Instanz der System.Windows.Media.Color-Klasse.
# Changes the background color for the error text that appears in the Console pane to black.
$psISE.Options.ErrorBackgroundColor = 'black'
ErrorForegroundColor
In Windows PowerShell ISE 2.0 und höher unterstützt.
Gibt die Vordergrundfarbe für den Fehlertext an, der im Konsolenbereich angezeigt wird. Dies ist eine Instanz der System.Windows.Media.Color-Klasse.
# Changes the foreground color for the error text that appears in the console pane to green.
$psISE.Options.ErrorForegroundColor = 'green'
FontName
In Windows PowerShell ISE 2.0 und höher unterstützt.
Gibt den Namen der Schriftart an, die derzeit im Skriptbereich und im Konsolenbereich verwendet wird.
# Changes the font used in both panes.
$psISE.Options.FontName = 'Courier New'
FontSize
In Windows PowerShell ISE 2.0 und höher unterstützt.
Gibt den Schriftgrad als ganze Zahl an. Dieser wird im Skriptbereich, Befehlsbereich und Ausgabebereich verwendet. Der gültige Wertebereich liegt zwischen 8 und 32.
# Changes the font size in all panes.
$psISE.Options.FontSize = 20
IntellisenseTimeoutInSeconds
In Windows PowerShell ISE 3.0 und höher unterstützt, in früheren Versionen nicht enthalten.
Gibt in Sekunden an, wie lange IntelliSense versucht, den gerade eingegebenen Text aufzulösen. Nach dieser Anzahl von Sekunden tritt in IntelliSense eine Zeitüberschreitung auf, und Sie können mit der Eingabe fortfahren. Der Standardwert sind 3 Sekunden. Der Wert ist eine ganze Zahl.
# Changes the number of seconds for IntelliSense syntax recognition to 5.
$psISE.Options.IntellisenseTimeoutInSeconds = 5
MruCount
In Windows PowerShell ISE 3.0 und höher unterstützt, in früheren Versionen nicht enthalten.
Gibt die Anzahl der zuletzt geöffneten Dateien an, die Windows PowerShell ISE nachverfolgt und am unteren Rand des Menüs Datei öffnen anzeigt. Der Standardwert ist 10. Der Wert ist eine ganze Zahl.
# Changes the number of recently used files that appear at the bottom of the File Open menu to 5.
$psISE.Options.MruCount = 5
OutputPaneBackgroundColor
Dieses Feature ist in Windows PowerShell ISE 2.0 enthalten, wurde in höheren Versionen von ISE aber entfernt oder umbenannt. Informationen zu höheren Versionen finden Sie unter ConsolePaneBackgroundColor.
Die Lese-/Schreibeigenschaft, die die Hintergrundfarbe für den Ausgabebereich selbst abruft oder festlegt. Dies ist eine Instanz der System.Windows.Media.Color-Klasse.
# Changes the background color of the Output pane to gold.
$psISE.Options.OutputPaneForegroundColor = 'gold'
OutputPaneTextForegroundColor
Dieses Feature ist in Windows PowerShell ISE 2.0 enthalten, wurde in höheren Versionen von ISE aber entfernt oder umbenannt. Informationen zu höheren Versionen finden Sie unter ConsolePaneForegroundColor.
Die Lese-/Schreibeigenschaft, mit der die Vordergrundfarbe des Texts im Ausgabereich in Windows PowerShell ISE 2.0 geändert wird.
# Changes the foreground color of the text in the Output Pane to blue.
$psISE.Options.OutputPaneTextForegroundColor = 'blue'
OutputPaneTextBackgroundColor
Dieses Feature ist in Windows PowerShell ISE 2.0 enthalten, wurde in höheren Versionen von ISE aber entfernt oder umbenannt. Informationen zu höheren Versionen finden Sie unter ConsolePaneTextBackgroundColor.
Die Lese-/Schreibeigenschaft, mit der die Hintergrundfarbe des Texts im Ausgabereich geändert wird.
# Changes the background color of the Output pane text to pink.
$psISE.Options.OutputPaneTextBackgroundColor = 'pink'
ScriptPaneBackgroundColor
In Windows PowerShell ISE 2.0 und höher unterstützt.
Die Lese-/Schreibeigenschaft, mit der die Hintergrundfarbe für Dateien abgerufen oder festgelegt wird. Dies ist eine Instanz der System.Windows.Media.Color-Klasse.
# Sets the color of the script pane background to yellow.
$psISE.Options.ScriptPaneBackgroundColor = 'yellow'
ScriptPaneForegroundColor
In Windows PowerShell ISE 2.0 und höher unterstützt.
Die Lese-/Schreibeigenschaft, mit der die Vordergrundfarbe für Nicht-Skriptdateien im Skriptbereich abgerufen oder festgelegt wird. Verwenden Sie TokenColors zum Festlegen der Vordergrundfarbe für Skriptdateien.
# Sets the foreground to color of non-script files in the script pane to green.
$psISE.Options.ScriptPaneBackgroundColor = 'green'
SelectedScriptPaneState
In Windows PowerShell ISE 2.0 und höher unterstützt.
Die Lese-/Schreibeigenschaft, die die Position des Skriptbereichs in der Anzeige abruft oder festlegt. Die Zeichenfolge kann „Maximized“, „Top“ oder „Right“ lauten.
# 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
In Windows PowerShell ISE 3.0 und höher unterstützt, in früheren Versionen nicht enthalten.
Gibt an, ob die STRG+J-Liste mit Codeausschnitten den in Windows PowerShell enthaltenen Startersatz enthält. Bei Festlegung auf $false werden nur benutzerdefinierte Codeausschnitte in der STRG+J-Liste angezeigt.
Standardwert: $true.
# Hide the default snippets from the CTRL+J list.
$psISE.Options.ShowDefaultSnippets = $false
ShowIntellisenseInConsolePane
In Windows PowerShell ISE 3.0 und höher unterstützt, in früheren Versionen nicht enthalten.
Gibt an, ob IntelliSense Syntax-, Parameter- und Wertvorschläge im Konsolenbereich anzeigt.
Standardwert: $true.
# Turn off IntelliSense in the console pane.
$psISE.Options.ShowIntellisenseInConsolePane = $false
ShowIntellisenseInScriptPane
In Windows PowerShell ISE 3.0 und höher unterstützt, in früheren Versionen nicht enthalten.
Gibt an, ob IntelliSense Syntax-, Parameter- und Wertvorschläge im Skriptbereich anzeigt.
Standardwert: $true.
# Turn off IntelliSense in the Script pane.
$psISE.Options.ShowIntellisenseInScriptPane = $false
ShowLineNumbers
In Windows PowerShell ISE 3.0 und höher unterstützt, in früheren Versionen nicht enthalten.
Gibt an, ob im Skriptbereich Zeilennummern am linken Rand angezeigt werden. Standardwert: $true.
# Turn off line numbers in the Script pane.
$psISE.Options.ShowLineNumbers = $false
ShowOutlining
In Windows PowerShell ISE 3.0 und höher unterstützt, in früheren Versionen nicht enthalten.
Gibt an, ob im Skriptbereich erweiterbare und reduzierbare Klammern neben Codeabschnitten am linken Rand angezeigt werden. Wenn sie angezeigt werden, können Sie auf das Minuszeichen - neben einem Textblock klicken, um ihn zuzuklappen, oder auf das Pluszeichen +, um einen Textblock auszuklappen. Standardwert: $true.
# Turn off outlining in the Script pane.
$psISE.Options.ShowOutlining = $false
ShowToolBar
In Windows PowerShell ISE 2.0 und höher unterstützt.
Gibt an, ob die ISE-Symbolleiste am oberen Rand des Windows PowerShell ISE-Fensters angezeigt wird. Standardwert: $true.
# Show the toolbar.
$psISE.Options.ShowToolBar = $true
ShowWarningBeforeSavingOnRun
In Windows PowerShell ISE 2.0 und höher unterstützt.
Gibt an, ob eine Warnung angezeigt wird, wenn ein Skript vor dem Ausführen automatisch gespeichert wird.
Standardwert: $true.
# Enable the warning message when an attempt
# is made to run a script without saving it first.
$psISE.Options.ShowWarningBeforeSavingOnRun = $true
ShowWarningForDuplicateFiles
In Windows PowerShell ISE 2.0 und höher unterstützt.
Gibt an, ob eine Warnung angezeigt wird, wenn die gleiche Datei auf mehreren PowerShell-Registerkarten geöffnet wird. Wenn Sie dies auf $true stellen, erscheint beim Öffnen derselben Datei in mehreren Registerkarten die Meldung: „Eine Kopie dieser Datei ist in einer anderen Windows PowerShell-Registerkarte geöffnet. Änderungen an dieser Datei betreffen alle geöffneten Kopien.“ Der Standardwert lautet $true.
# Enable the warning message when a file is
# opened in multiple PowerShell tabs.
$psISE.Options.ShowWarningForDuplicateFiles = $true
TokenColors
In Windows PowerShell ISE 2.0 und höher unterstützt.
Gibt die Farben der IntelliSense-Token im Windows PowerShell ISE-Skriptbereich an. Diese Eigenschaft ist ein Wörterbuchobjekt, das Name-Wert-Paare von Tokentypen und Farben für den Skriptbereich enthält. Informationen zum Ändern der Farben der IntelliSense-Token im Konsolenbereich finden Sie unter ConsoleTokenColors. Informationen zum Zurücksetzen der Farben auf die Standardwerte finden Sie unter RestoreDefaultTokenColors. Tokenfarben können für folgende Elemente festgelegt werden: 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
In Windows PowerShell ISE 3.0 und höher unterstützt, in früheren Versionen nicht enthalten.
Gibt an, ob Sie mit der Eingabetaste eine von IntelliSense bereitgestellte Option im Konsolenbereich auswählen können. Standardwert: $true.
# Turn off using the ENTER key to select an IntelliSense provided option in the Console pane.
$psISE.Options.UseEnterToSelectInConsolePaneIntellisense = $false
UseEnterToSelectInScriptPaneIntellisense
In Windows PowerShell ISE 3.0 und höher unterstützt, in früheren Versionen nicht enthalten.
Gibt an, ob Sie mit der Eingabetaste eine von IntelliSense bereitgestellte Option im Skriptbereich auswählen können. Standardwert: $true.
# Turn on using the Enter key to select an IntelliSense provided option in the Console pane.
$psISE.Options.UseEnterToSelectInConsolePaneIntellisense = $true
UseLocalHelp
In Windows PowerShell ISE 3.0 und höher unterstützt, in früheren Versionen nicht enthalten.
Gibt an, ob die lokal installierte Hilfe oder die Onlinehilfe angezeigt wird, wenn der Cursor sich auf einem Schlüsselwort befindet und Sie F1 drücken. Bei Festlegung auf $true werden in einem Popupfenster Inhalte aus der lokal installierten Hilfe angezeigt. Sie können die Hilfedateien mit dem Befehl Update-Help installieren. Bei Festlegung auf $false wird eine Seite auf Microsoft Learn im Browser geöffnet.
# 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
In Windows PowerShell ISE 2.0 und höher unterstützt.
Gibt die Hintergrundfarbe für ausführlichen Text an, der im Konsolenbereich angezeigt wird. Dies ist ein System.Windows.Media.Color-Objekt.
# Changes the background color for verbose text to blue.
$psISE.Options.VerboseBackgroundColor ='#0000FF'
VerboseForegroundColor
In Windows PowerShell ISE 2.0 und höher unterstützt.
Gibt die Vordergrundfarbe für ausführlichen Text an, der im Konsolenbereich angezeigt wird. Dies ist ein System.Windows.Media.Color-Objekt.
# Changes the foreground color for verbose text to yellow.
$psISE.Options.VerboseForegroundColor = 'yellow'
WarningBackgroundColor
In Windows PowerShell ISE 2.0 und höher unterstützt.
Gibt die Hintergrundfarbe für Warntext an, der im Konsolenbereich angezeigt wird. Dies ist ein System.Windows.Media.Color-Objekt.
# Changes the background color for warning text to blue.
$psISE.Options.WarningBackgroundColor = '#0000FF'
WarningForegroundColor
In Windows PowerShell ISE 2.0 und höher unterstützt.
Gibt die Vordergrundfarbe für Warntext an, der im Ausgabebereich angezeigt wird. Dies ist ein System.Windows.Media.Color-Objekt.
# Changes the foreground color for warning text to yellow.
$psISE.Options.WarningForegroundColor = 'yellow'
XmlTokenColors
In Windows PowerShell ISE 3.0 und höher unterstützt, in früheren Versionen nicht enthalten.
Gibt ein Wörterbuchobjekt an, das Name-Wert-Paare von Tokentypen und Farben für XML-Inhalte enthält, die in Windows PowerShell ISE angezeigt werden. Tokenfarben können für folgende Elemente festgelegt werden: Attribute, Command, CommandArgument, CommandParameter, Comment, GroupEnd, GroupStart, Keyword, LineContinuation, LoopLabel, Member, NewLine, Number, Operator, Position, StatementSeparator, String, Type, Unknown, Variable. Siehe auch 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
In Windows PowerShell ISE 3.0 und höher unterstützt, in früheren Versionen nicht enthalten.
Gibt die relative Größe des Texts im Konsolenbereich und Skriptbereich an. Der Standardwert ist 100. Bei kleineren Werten wird der Text in Windows PowerShell ISE kleiner angezeigt, bei größeren Werten wird er größer angezeigt. Der Wert ist eine ganze Zahl zwischen 20 und 400.
# Changes the text in the Windows PowerShell ISE to be double its normal size.
$psISE.Options.Zoom = 200
