Delen via


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 ISEOptions-object 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 ConsolePaneBackgroundColor voor 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 TokenColors als u de kleuren van de IntelliSense-tokens in het deelvenster Script wilt wijzigen. Zie RestoreDefaultConsoleTokenColors om 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'

FontSize

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 op dat Windows PowerShell ISE bijhoudt en onderaan het menu Bestand openen wordt weergegeven. 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 ConsolePaneBackgroundColor voor 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 ConsolePaneForegroundColor voor 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 ConsolePaneTextBackgroundColor voor 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 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$false, worden alleen door de gebruiker gedefinieerde fragmenten weergegeven in de CTRL+J-lijst. 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 de minpictogrammen - 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 $trueop , wordt dit bericht weergegeven als u hetzelfde bestand op meerdere tabbladen wilt openen: 'Er is een kopie van dit bestand geopend op een ander Windows PowerShell-tabblad. Wijzigingen in dit bestand 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 ConsoleTokenColors als u de kleuren van de IntelliSense-tokens in het consolevenster wilt wijzigen. Zie RestoreDefaultTokenColors om 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 drukt met de cursor in een trefwoord. Als dit is ingesteld $true, wordt in een pop-upvenster inhoud van de lokaal geïnstalleerde Help weergegeven. U kunt de Help-bestanden installeren door de opdracht uit te Update-Help voeren. Als deze optie is ingesteld $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

Zie ook