Het ISEOptions-object
Het ISEOptions--object vertegenwoordigt verschillende instellingen voor Windows PowerShell ISE. Het is een exemplaar van de klasse Microsoft.PowerShell.Host.ISE.ISEOptions.
Het object ISEOptions biedt de volgende methoden en eigenschappen.
Methoden
RestoreDefaultConsoleTokenColors()
Ondersteund in Windows PowerShell ISE 3.0 en hoger en niet aanwezig in eerdere versies.
Hiermee worden de standaardwaarden van de kleuren van het token in het deelvenster Console hersteld.
# 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()
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
Hiermee worden de standaardwaarden van alle instellingen voor opties in het consolevenster hersteld. Ook wordt het gedrag van verschillende waarschuwingsberichten die het standaard selectievakje bieden, opnieuw ingesteld om te voorkomen dat het bericht opnieuw wordt weergegeven.
# Changes the background color in the Console pane and then restores it to its default value.
$psISE.Options.ConsolePaneBackgroundColor = 'orange'
$psISE.Options.RestoreDefaults()
RestoreDefaultTokenColors()
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
Hiermee worden de standaardwaarden van de tokenkleuren in het deelvenster Script hersteld.
# 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()
Ondersteund in Windows PowerShell ISE 3.0 en hoger en niet aanwezig in eerdere versies.
Hiermee herstelt u de standaardwaarden van de tokenkleuren voor XML-elementen die worden weergegeven in Windows PowerShell ISE. Zie ook 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()
Eigenschappen
AutoSaveMinuteInterval
Ondersteund in Windows PowerShell ISE 3.0 en hoger en niet aanwezig in eerdere versies.
Hiermee geeft u het aantal minuten op tussen automatische opslagbewerkingen van uw bestanden door Windows PowerShell ISE. De standaardwaarde is 2 minuten. De waarde is een geheel getal.
# Changes the number of minutes between automatic save operations to every 3 minutes.
$psISE.Options.AutoSaveMinuteInterval = 3
CommandPaneBackgroundColor
Deze functie is aanwezig in Windows PowerShell ISE 2.0, maar is verwijderd of hernoemd in latere versies van de ISE. Zie ConsolePaneBackgroundColorvoor latere versies.
Hiermee geeft u de achtergrondkleur voor het opdrachtvenster. Het is een exemplaar van de klasse System.Windows.Media.Color.
# Changes the background color of the Command pane to orange.
$psISE.Options.CommandPaneBackgroundColor = 'orange'
CommandPaneUp
Deze functie is aanwezig in Windows PowerShell ISE 2.0, maar is verwijderd of hernoemd in latere versies van de ISE.
Hiermee geeft u op of het opdrachtvenster zich boven het uitvoervenster bevindt.
# Moves the Command pane to the top of the screen.
$psISE.Options.CommandPaneUp = $true
ConsolePaneBackgroundColor
Ondersteund in Windows PowerShell ISE 3.0 en hoger en niet aanwezig in eerdere versies.
Hiermee geeft u de achtergrondkleur voor het consoledeelvenster op. Het is een exemplaar van de klasse System.Windows.Media.Color.
# Changes the background color of the Console pane to red.
$psISE.Options.ConsolePaneBackgroundColor = 'red'
ConsolePaneForegroundColor
Ondersteund in Windows PowerShell ISE 3.0 en hoger en niet aanwezig in eerdere versies.
Hiermee geeft u de voorgrondkleur van de tekst in het consoledeelvenster op.
# Changes the foreground color of the text in the Console pane to yellow.
$psISE.Options.ConsolePaneForegroundColor = 'yellow'
ConsolePaneTextBackgroundColor
Ondersteund in Windows PowerShell ISE 3.0 en hoger en niet aanwezig in eerdere versies.
Hiermee geeft u de achtergrondkleur van de tekst in het consoledeelvenster op.
# Changes the background color of the Console pane text to pink.
$psISE.Options.ConsolePaneTextBackgroundColor = 'pink'
ConsoleTokenColors
Ondersteund in Windows PowerShell ISE 3.0 en hoger en niet aanwezig in eerdere versies.
Hiermee geeft u de kleuren van de IntelliSense-tokens in het deelvenster Windows PowerShell ISE Console op. Deze eigenschap is een woordenlijstobject dat naam-/waardeparen van tokentypen en kleuren voor het consoledeelvenster bevat. Zie TokenColorsals u de kleuren van de IntelliSense-tokens in het deelvenster Script wilt wijzigen. Zie RestoreDefaultConsoleTokenColorsom de kleuren opnieuw in te stellen op de standaardwaarden. Tokenkleuren kunnen worden ingesteld voor het volgende: Kenmerk, 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
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
Hiermee geeft u de achtergrondkleur op voor de foutopsporingstekst die wordt weergegeven in het consolevenster. Het is een exemplaar van de klasse 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
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
Hiermee geeft u de voorgrondkleur op voor de foutopsporingstekst die wordt weergegeven in het consoledeelvenster. Het is een exemplaar van de klasse 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
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
Een verzameling eigenschappen die de standaardwaarden opgeven die moeten worden gebruikt wanneer de resetmethoden worden gebruikt.
# 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
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
Hiermee geeft u de achtergrondkleur op voor fouttekst die wordt weergegeven in het consolevenster. Het is een exemplaar van de klasse 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
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
Hiermee geeft u de voorgrondkleur op voor fouttekst die wordt weergegeven in het consoledeelvenster. Het is een exemplaar van de klasse 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
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
Hiermee geeft u de naam van het lettertype dat momenteel wordt gebruikt in zowel het deelvenster Script als het consolevenster.
# Changes the font used in both panes.
$psISE.Options.FontName = 'Courier New'
Lettertype aanpassen
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
Hiermee geeft u de tekengrootte op als een geheel getal. Deze wordt gebruikt in het deelvenster Script, het opdrachtvenster en het deelvenster Uitvoer. Het geldige bereik van waarden is 8 tot en met 32.
# Changes the font size in all panes.
$psISE.Options.FontSize = 20
IntellisenseTimeoutInSeconds
Ondersteund in Windows PowerShell ISE 3.0 en hoger en niet aanwezig in eerdere versies.
Hiermee geeft u het aantal seconden op dat intelliSense gebruikt om de momenteel getypte tekst op te lossen. Na dit aantal seconden treedt er een time-out op in IntelliSense en kunt u doorgaan met typen. De standaardwaarde is 3 seconden. De waarde is een geheel getal.
# Changes the number of seconds for IntelliSense syntax recognition to 5.
$psISE.Options.IntellisenseTimeoutInSeconds = 5
MruCount
Ondersteund in Windows PowerShell ISE 3.0 en hoger en niet aanwezig in eerdere versies.
Hiermee geeft u het aantal onlangs geopende bestanden dat Windows PowerShell ISE bijhoudt en onderaan het menu Bestand openen weergeeft. De standaardwaarde is 10. De waarde is een geheel getal.
# Changes the number of recently used files that appear at the bottom of the File Open menu to 5.
$psISE.Options.MruCount = 5
OutputPaneBackgroundColor
Deze functie is aanwezig in Windows PowerShell ISE 2.0, maar is verwijderd of hernoemd in latere versies van de ISE. Zie ConsolePaneBackgroundColorvoor latere versies.
De eigenschap lezen/schrijven waarmee de achtergrondkleur voor het uitvoervenster zelf wordt ophaalt of ingesteld. Het is een exemplaar van de klasse System.Windows.Media.Color.
# Changes the background color of the Output pane to gold.
$psISE.Options.OutputPaneForegroundColor = 'gold'
OutputPaneTextForegroundColor
Deze functie is aanwezig in Windows PowerShell ISE 2.0, maar is verwijderd of hernoemd in latere versies van de ISE. Zie ConsolePaneForegroundColorvoor latere versies.
De eigenschap lezen/schrijven waarmee de voorgrondkleur van de tekst in het deelvenster Uitvoer in Windows PowerShell ISE 2.0 wordt gewijzigd.
# Changes the foreground color of the text in the Output Pane to blue.
$psISE.Options.OutputPaneTextForegroundColor = 'blue'
OutputPaneTextBackgroundColor
Deze functie is aanwezig in Windows PowerShell ISE 2.0, maar is verwijderd of hernoemd in latere versies van de ISE. Zie ConsolePaneTextBackgroundColorvoor latere versies.
De eigenschap lezen/schrijven waarmee de achtergrondkleur van de tekst in het deelvenster Uitvoer wordt gewijzigd.
# Changes the background color of the Output pane text to pink.
$psISE.Options.OutputPaneTextBackgroundColor = 'pink'
ScriptPaneBackgroundColor
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
De eigenschap lezen/schrijven waarmee de achtergrondkleur voor bestanden wordt opgeslagen of ingesteld. Het is een exemplaar van de klasse System.Windows.Media.Color.
# Sets the color of the script pane background to yellow.
$psISE.Options.ScriptPaneBackgroundColor = 'yellow'
ScriptPaneForegroundColor
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
De eigenschap lezen/schrijven waarmee de voorgrondkleur voor niet-scriptbestanden in het deelvenster Script wordt opgeslagen of ingesteld. Als u de voorgrondkleur voor scriptbestanden wilt instellen, gebruikt u de TokenColors-.
# Sets the foreground to color of non-script files in the script pane to green.
$psISE.Options.ScriptPaneBackgroundColor = 'green'
SelectedScriptPaneState
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
De eigenschap lezen/schrijven die de positie van het deelvenster Script op de weergave ophaalt of instelt. De tekenreeks kan 'Gemaximaliseerd' of 'Boven' of 'Rechts' zijn.
# 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
Ondersteund in Windows PowerShell ISE 3.0 en hoger en niet aanwezig in eerdere versies.
Hiermee geeft u op of de Ctrl+J lijst met fragmenten de startersset bevat die is opgenomen in Windows PowerShell. Als deze optie is ingesteld op $false
, worden alleen door de gebruiker gedefinieerde fragmenten weergegeven in de lijst met Ctrl+J-.
De standaardwaarde is $true
.
# Hide the default snippets from the CTRL+J list.
$psISE.Options.ShowDefaultSnippets = $false
ShowIntellisenseInConsolePane
Ondersteund in Windows PowerShell ISE 3.0 en hoger en niet aanwezig in eerdere versies.
Hiermee geeft u op of IntelliSense suggesties voor syntaxis, parameters en waarde biedt in het deelvenster Console.
De standaardwaarde is $true
.
# Turn off IntelliSense in the console pane.
$psISE.Options.ShowIntellisenseInConsolePane = $false
ShowIntellisenseInScriptPane
Ondersteund in Windows PowerShell ISE 3.0 en hoger en niet aanwezig in eerdere versies.
Hiermee geeft u op of IntelliSense suggesties voor syntaxis, parameters en waarde biedt in het deelvenster Script.
De standaardwaarde is $true
.
# Turn off IntelliSense in the Script pane.
$psISE.Options.ShowIntellisenseInScriptPane = $false
ShowLineNumbers
Ondersteund in Windows PowerShell ISE 3.0 en hoger en niet aanwezig in eerdere versies.
Hiermee geeft u op of in het deelvenster Script regelnummers in de linkermarge worden weergegeven. De standaardwaarde is $true
.
# Turn off line numbers in the Script pane.
$psISE.Options.ShowLineNumbers = $false
ShowOutlining
Ondersteund in Windows PowerShell ISE 3.0 en hoger en niet aanwezig in eerdere versies.
Hiermee geeft u op of in het deelvenster Script uitvouwbare en samenvouwbare vierkante haken naast codesecties in de linkermarge worden weergegeven. Wanneer deze worden weergegeven, kunt u op het minteken -
pictogrammen naast een tekstblok klikken om deze samen te vouwen of op het pluspictogram +
klikken om een tekstblok uit te vouwen. De standaardwaarde is $true
.
# Turn off outlining in the Script pane.
$psISE.Options.ShowOutlining = $false
ShowToolBar
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
Hiermee geeft u op of de ISE-werkbalk boven aan het Windows PowerShell ISE-venster wordt weergegeven. De standaardwaarde is $true
.
# Show the toolbar.
$psISE.Options.ShowToolBar = $true
ShowWarningBeforeSavingOnRun
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
Hiermee geeft u op of er een waarschuwingsbericht wordt weergegeven wanneer een script automatisch wordt opgeslagen voordat het wordt uitgevoerd.
De standaardwaarde is $true
.
# Enable the warning message when an attempt
# is made to run a script without saving it first.
$psISE.Options.ShowWarningBeforeSavingOnRun = $true
ShowWarningForDuplicateFiles
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
Hiermee geeft u op of er een waarschuwingsbericht wordt weergegeven wanneer hetzelfde bestand wordt geopend op verschillende PowerShell-tabbladen. Als dit is ingesteld op $true
, wordt dit bericht weergegeven om hetzelfde bestand op meerdere tabbladen te openen: 'Er is een kopie van dit bestand geopend op een ander Windows PowerShell-tabblad. Wijzigingen die in dit bestand zijn aangebracht, zijn van invloed op alle geopende kopieën.' De standaardwaarde is $true
.
# Enable the warning message when a file is
# opened in multiple PowerShell tabs.
$psISE.Options.ShowWarningForDuplicateFiles = $true
TokenColors
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
Hiermee geeft u de kleuren van de IntelliSense-tokens in het deelvenster Windows PowerShell ISE-script op. Deze eigenschap is een woordenlijstobject dat naam-/waardeparen van tokentypen en kleuren voor het deelvenster Script bevat. Zie ConsoleTokenColorsals u de kleuren van de IntelliSense-tokens in het consolevenster wilt wijzigen. Zie RestoreDefaultTokenColorsom de kleuren opnieuw in te stellen op de standaardwaarden. Tokenkleuren kunnen worden ingesteld voor het volgende: Kenmerk, 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
Ondersteund in Windows PowerShell ISE 3.0 en hoger en niet aanwezig in eerdere versies.
Hiermee geeft u op of u de Enter-toets kunt gebruiken om een intelliSense-optie in het consoledeelvenster te selecteren. De standaardwaarde is $true
.
# Turn off using the ENTER key to select an IntelliSense provided option in the Console pane.
$psISE.Options.UseEnterToSelectInConsolePaneIntellisense = $false
UseEnterToSelectInScriptPaneIntellisense
Ondersteund in Windows PowerShell ISE 3.0 en hoger en niet aanwezig in eerdere versies.
Hiermee geeft u op of u de Enter-toets kunt gebruiken om een intelliSense-optie te selecteren in het deelvenster Script. De standaardwaarde is $true
.
# Turn on using the Enter key to select an IntelliSense provided option in the Console pane.
$psISE.Options.UseEnterToSelectInConsolePaneIntellisense = $true
UseLocalHelp
Ondersteund in Windows PowerShell ISE 3.0 en hoger en niet aanwezig in eerdere versies.
Hiermee geeft u op of de lokaal geïnstalleerde Help of de online Help wordt weergegeven wanneer u op F1 met de cursor in een trefwoord geplaatst. Als deze optie is ingesteld op $true
, wordt in een pop-upvenster inhoud van de lokaal geïnstalleerde Help weergegeven. U kunt de Help-bestanden installeren door de opdracht Update-Help
uit te voeren. Als deze optie is ingesteld op $false
, wordt uw browser geopend op een pagina in 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
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
Hiermee geeft u de achtergrondkleur op voor uitgebreide tekst die wordt weergegeven in het consoledeelvenster. Het is een System.Windows.Media.Color object.
# Changes the background color for verbose text to blue.
$psISE.Options.VerboseBackgroundColor ='#0000FF'
UitgebreidForegroundColor
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
Hiermee geeft u de voorgrondkleur op voor uitgebreide tekst die wordt weergegeven in het deelvenster Console. Het is een System.Windows.Media.Color object.
# Changes the foreground color for verbose text to yellow.
$psISE.Options.VerboseForegroundColor = 'yellow'
WarningBackgroundColor
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
Hiermee geeft u de achtergrondkleur op voor waarschuwingstekst die wordt weergegeven in het consoledeelvenster. Het is een System.Windows.Media.Color object.
# Changes the background color for warning text to blue.
$psISE.Options.WarningBackgroundColor = '#0000FF'
WarningForegroundColor
Ondersteund in Windows PowerShell ISE 2.0 en hoger.
Hiermee geeft u de voorgrondkleur op voor waarschuwingstekst die wordt weergegeven in het deelvenster Uitvoer. Het is een System.Windows.Media.Color object.
# Changes the foreground color for warning text to yellow.
$psISE.Options.WarningForegroundColor = 'yellow'
XmlTokenColors
Ondersteund in Windows PowerShell ISE 3.0 en hoger en niet aanwezig in eerdere versies.
Hiermee geeft u een woordenlijstobject op dat naam-/waardeparen van tokentypen en kleuren bevat voor XML-inhoud die wordt weergegeven in Windows PowerShell ISE. Tokenkleuren kunnen worden ingesteld voor het volgende: Kenmerk, CommandArgument, CommandParameter, Comment, GroupEnd, GroupStart, Keyword, LineContinuation, LoopLabel, Member, NewLine, Number, Operator, Position, StatementSeparator, String, Type, Unknown, Variable. Zie ook 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
Ondersteund in Windows PowerShell ISE 3.0 en hoger en niet aanwezig in eerdere versies.
Hiermee geeft u de relatieve grootte van tekst op in de deelvensters Console en Script. De standaardwaarde is 100. Kleinere waarden zorgen ervoor dat de tekst in Windows PowerShell ISE kleiner wordt weergegeven, terwijl grotere getallen ertoe leiden dat tekst groter wordt weergegeven. De waarde is een geheel getal dat varieert van 20 tot 400.
# Changes the text in the Windows PowerShell ISE to be double its normal size.
$psISE.Options.Zoom = 200