IsEOptions, objet
L’objet ISEOptions représente différents paramètres pour Windows PowerShell ISE. Il s’agit d’une instance de la classe Microsoft.PowerShell.Host.ISE.ISEOptions.
L’objet ISEOptions fournit les méthodes et propriétés suivantes.
Méthode
RestoreDefaultConsoleTokenColors()
Pris en charge dans Windows PowerShell ISE 3.0 et versions ultérieures, et non présents dans les versions antérieures.
Restaure les valeurs par défaut des couleurs de jeton dans le volet Console.
# 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()
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Restaure les valeurs par défaut de tous les paramètres d’options dans le volet Console. Il réinitialise également le comportement des différents messages d’avertissement qui fournissent la case à cocher standard pour empêcher l’affichage du message.
# Changes the background color in the Console pane and then restores it to its default value.
$psISE.Options.ConsolePaneBackgroundColor = 'orange'
$psISE.Options.RestoreDefaults()
RestoreDefaultTokenColors()
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Restaure les valeurs par défaut des couleurs de jeton dans le volet 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()
Pris en charge dans Windows PowerShell ISE 3.0 et versions ultérieures, et non présents dans les versions antérieures.
Restaure les valeurs par défaut des couleurs de jeton pour les éléments XML affichés dans Windows PowerShell ISE. Voir également 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()
Propriétés
AutoSaveMinuteInterval
Pris en charge dans Windows PowerShell ISE 3.0 et versions ultérieures, et non présents dans les versions antérieures.
Spécifie le nombre de minutes entre les opérations d’enregistrement automatique de vos fichiers par Windows PowerShell ISE. La valeur par défaut est de 2 minutes. La valeur est un entier.
# Changes the number of minutes between automatic save operations to every 3 minutes.
$psISE.Options.AutoSaveMinuteInterval = 3
CommandPaneBackgroundColor
Cette fonctionnalité est présente dans Windows PowerShell ISE 2.0, mais a été supprimée ou renommée dans les versions ultérieures de l’ISE. Pour les versions ultérieures, consultez ConsolePaneBackgroundColor.
Spécifie la couleur d’arrière-plan du volet Commandes. Il s’agit d’une instance de la classe System.Windows.Media.Color.
# Changes the background color of the Command pane to orange.
$psISE.Options.CommandPaneBackgroundColor = 'orange'
CommandPaneUp
Cette fonctionnalité est présente dans Windows PowerShell ISE 2.0, mais a été supprimée ou renommée dans les versions ultérieures de l’ISE.
Spécifie si le volet Commande se trouve au-dessus du volet Sortie.
# Moves the Command pane to the top of the screen.
$psISE.Options.CommandPaneUp = $true
ConsolePaneBackgroundColor
Pris en charge dans Windows PowerShell ISE 3.0 et versions ultérieures, et non présents dans les versions antérieures.
Spécifie la couleur d’arrière-plan du volet Console. Il s’agit d’une instance de la classe System.Windows.Media.Color.
# Changes the background color of the Console pane to red.
$psISE.Options.ConsolePaneBackgroundColor = 'red'
ConsolePaneForegroundColor
Pris en charge dans Windows PowerShell ISE 3.0 et versions ultérieures, et non présents dans les versions antérieures.
Spécifie la couleur de premier plan du texte dans le volet Console.
# Changes the foreground color of the text in the Console pane to yellow.
$psISE.Options.ConsolePaneForegroundColor = 'yellow'
ConsolePaneTextBackgroundColor
Pris en charge dans Windows PowerShell ISE 3.0 et versions ultérieures, et non présents dans les versions antérieures.
Spécifie la couleur d’arrière-plan du texte dans le volet Console.
# Changes the background color of the Console pane text to pink.
$psISE.Options.ConsolePaneTextBackgroundColor = 'pink'
ConsoleTokenColors
Pris en charge dans Windows PowerShell ISE 3.0 et versions ultérieures, et non présents dans les versions antérieures.
Spécifie les couleurs des jetons IntelliSense dans le volet console Windows PowerShell ISE. Cette propriété est un objet de dictionnaire qui contient des paires nom/valeur de types de jetons et de couleurs pour le volet Console. Pour modifier les couleurs des jetons IntelliSense dans le volet Script, consultez TokenColors. Pour réinitialiser les couleurs aux valeurs par défaut, consultez RestoreDefaultConsoleTokenColors. Les couleurs de jeton peuvent être définies pour les éléments suivants : Attribut, 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
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Spécifie la couleur d’arrière-plan du texte de débogage qui apparaît dans le volet Console. Il s’agit d’une instance de la classe 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
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Spécifie la couleur de premier plan du texte de débogage qui apparaît dans le volet Console. Il s’agit d’une instance de la classe 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
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Collection de propriétés qui spécifient les valeurs par défaut à utiliser lorsque les méthodes reset sont utilisées.
# 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
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Spécifie la couleur d’arrière-plan du texte d’erreur qui apparaît dans le volet Console. Il s’agit d’une instance de la classe 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
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Spécifie la couleur de premier plan pour le texte d’erreur qui apparaît dans le volet Console. Il s’agit d’une instance de la classe 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
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Spécifie le nom de police actuellement utilisé dans le volet Script et dans le volet Console.
# Changes the font used in both panes.
$psISE.Options.FontName = 'Courier New'
FontSize
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Spécifie la taille de police en tant qu’entier. Il est utilisé dans le volet Script, dans le volet Commande et dans le volet Sortie. La plage de valeurs valide est de 8 à 32.
# Changes the font size in all panes.
$psISE.Options.FontSize = 20
IntellisenseTimeoutInSeconds
Pris en charge dans Windows PowerShell ISE 3.0 et versions ultérieures, et non présents dans les versions antérieures.
Spécifie le nombre de secondes qu’IntelliSense utilise pour essayer de résoudre le texte actuellement typé. Après ce nombre de secondes, IntelliSense expire et vous permet de continuer à taper. La valeur par défaut est de 3 secondes. La valeur est un entier.
# Changes the number of seconds for IntelliSense syntax recognition to 5.
$psISE.Options.IntellisenseTimeoutInSeconds = 5
MruCount
Pris en charge dans Windows PowerShell ISE 3.0 et versions ultérieures, et non présents dans les versions antérieures.
Spécifie le nombre de fichiers récemment ouverts suivis par Windows PowerShell ISE et s’affiche en bas du menu Ouvrir le fichier. La valeur par défaut est 10. La valeur est un entier.
# Changes the number of recently used files that appear at the bottom of the File Open menu to 5.
$psISE.Options.MruCount = 5
OutputPaneBackgroundColor
Cette fonctionnalité est présente dans Windows PowerShell ISE 2.0, mais a été supprimée ou renommée dans les versions ultérieures de l’ISE. Pour les versions ultérieures, consultez ConsolePaneBackgroundColor.
Propriété en lecture/écriture qui obtient ou définit la couleur d’arrière-plan du volet Sortie lui-même. Il s’agit d’une instance de la classe System.Windows.Media.Color.
# Changes the background color of the Output pane to gold.
$psISE.Options.OutputPaneForegroundColor = 'gold'
OutputPaneTextForegroundColor
Cette fonctionnalité est présente dans Windows PowerShell ISE 2.0, mais a été supprimée ou renommée dans les versions ultérieures de l’ISE. Pour les versions ultérieures, consultez ConsolePaneForegroundColor.
Propriété en lecture/écriture qui modifie la couleur de premier plan du texte dans le volet Sortie dans Windows PowerShell ISE 2.0.
# Changes the foreground color of the text in the Output Pane to blue.
$psISE.Options.OutputPaneTextForegroundColor = 'blue'
OutputPaneTextBackgroundColor
Cette fonctionnalité est présente dans Windows PowerShell ISE 2.0, mais a été supprimée ou renommée dans les versions ultérieures de l’ISE. Pour les versions ultérieures, consultez ConsolePaneTextBackgroundColor.
Propriété en lecture/écriture qui modifie la couleur d’arrière-plan du texte dans le volet Sortie.
# Changes the background color of the Output pane text to pink.
$psISE.Options.OutputPaneTextBackgroundColor = 'pink'
ScriptPaneBackgroundColor
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Propriété en lecture/écriture qui obtient ou définit la couleur d’arrière-plan des fichiers. Il s’agit d’une instance de la classe System.Windows.Media.Color.
# Sets the color of the script pane background to yellow.
$psISE.Options.ScriptPaneBackgroundColor = 'yellow'
ScriptPaneForegroundColor
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Propriété en lecture/écriture qui obtient ou définit la couleur de premier plan pour les fichiers non-script dans le volet Script. Pour définir la couleur de premier plan pour les fichiers de script, utilisez le TokenColors.
# Sets the foreground to color of non-script files in the script pane to green.
$psISE.Options.ScriptPaneBackgroundColor = 'green'
SelectedScriptPaneState
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Propriété en lecture/écriture qui obtient ou définit la position du volet Script sur l’affichage. La chaîne peut être « Agrandie », « Top » ou « Right ».
# 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
Pris en charge dans Windows PowerShell ISE 3.0 et versions ultérieures, et non présents dans les versions antérieures.
Spécifie si la CTRL+J liste d’extraits de code inclut le jeu de démarrage inclus dans Windows PowerShell. Lorsqu’il est défini sur $false, seuls les extraits définis par l’utilisateur apparaissent dans la liste CTRL+J.
La valeur par défaut est $true.
# Hide the default snippets from the CTRL+J list.
$psISE.Options.ShowDefaultSnippets = $false
ShowIntellisenseInConsolePane
Pris en charge dans Windows PowerShell ISE 3.0 et versions ultérieures, et non présents dans les versions antérieures.
Spécifie si IntelliSense propose des suggestions de syntaxe, de paramètre et de valeur dans le volet Console.
La valeur par défaut est $true.
# Turn off IntelliSense in the console pane.
$psISE.Options.ShowIntellisenseInConsolePane = $false
ShowIntellisenseInScriptPane
Pris en charge dans Windows PowerShell ISE 3.0 et versions ultérieures, et non présents dans les versions antérieures.
Spécifie si IntelliSense propose des suggestions de syntaxe, de paramètre et de valeur dans le volet Script.
La valeur par défaut est $true.
# Turn off IntelliSense in the Script pane.
$psISE.Options.ShowIntellisenseInScriptPane = $false
ShowLineNumbers
Pris en charge dans Windows PowerShell ISE 3.0 et versions ultérieures, et non présents dans les versions antérieures.
Spécifie si le volet Script affiche les numéros de ligne dans la marge gauche. La valeur par défaut est $true.
# Turn off line numbers in the Script pane.
$psISE.Options.ShowLineNumbers = $false
ShowOutlining
Pris en charge dans Windows PowerShell ISE 3.0 et versions ultérieures, et non présents dans les versions antérieures.
Spécifie si le volet Script affiche des crochets extensibles et réductibles en regard de sections de code dans la marge gauche. Lorsqu’elles sont affichées, vous pouvez cliquer sur les icônes moins - en regard d’un bloc de texte pour le réduire ou cliquer sur l’icône plus + pour développer un bloc de texte. La valeur par défaut est $true.
# Turn off outlining in the Script pane.
$psISE.Options.ShowOutlining = $false
ShowToolBar
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Spécifie si la barre d’outils ISE apparaît en haut de la fenêtre Windows PowerShell ISE. La valeur par défaut est $true.
# Show the toolbar.
$psISE.Options.ShowToolBar = $true
ShowWarningBeforeSavingOnRun
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Spécifie si un message d’avertissement s’affiche lorsqu’un script est enregistré automatiquement avant son exécution.
La valeur par défaut est $true.
# Enable the warning message when an attempt
# is made to run a script without saving it first.
$psISE.Options.ShowWarningBeforeSavingOnRun = $true
ShowWarningForDuplicateFiles
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Spécifie si un message d’avertissement s’affiche lorsque le même fichier est ouvert dans différents onglets PowerShell. Si la valeur est $true, pour ouvrir le même fichier sous plusieurs onglets, affiche ce message : « Une copie de ce fichier est ouverte dans un autre onglet Windows PowerShell. Les modifications apportées à ce fichier affectent toutes les copies ouvertes. » La valeur par défaut est $true.
# Enable the warning message when a file is
# opened in multiple PowerShell tabs.
$psISE.Options.ShowWarningForDuplicateFiles = $true
TokenColors
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Spécifie les couleurs des jetons IntelliSense dans le volet Script ISE Windows PowerShell. Cette propriété est un objet de dictionnaire qui contient des paires nom/valeur de types de jetons et de couleurs pour le volet Script. Pour modifier les couleurs des jetons IntelliSense dans le volet Console, consultez ConsoleTokenColors. Pour réinitialiser les couleurs aux valeurs par défaut, consultez RestoreDefaultTokenColors. Les couleurs de jeton peuvent être définies pour les éléments suivants : Attribut, 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
Pris en charge dans Windows PowerShell ISE 3.0 et versions ultérieures, et non présents dans les versions antérieures.
Spécifie si vous pouvez utiliser la touche Entrée pour sélectionner une option IntelliSense fournie dans le volet Console. La valeur par défaut est $true.
# Turn off using the ENTER key to select an IntelliSense provided option in the Console pane.
$psISE.Options.UseEnterToSelectInConsolePaneIntellisense = $false
UseEnterToSelectInScriptPaneIntellisense
Pris en charge dans Windows PowerShell ISE 3.0 et versions ultérieures, et non présents dans les versions antérieures.
Spécifie si vous pouvez utiliser la touche Entrée pour sélectionner une option fournie par IntelliSense dans le volet Script. La valeur par défaut est $true.
# Turn on using the Enter key to select an IntelliSense provided option in the Console pane.
$psISE.Options.UseEnterToSelectInConsolePaneIntellisense = $true
UseLocalHelp
Pris en charge dans Windows PowerShell ISE 3.0 et versions ultérieures, et non présents dans les versions antérieures.
Spécifie si l’aide installée localement ou l’aide en ligne s’affiche lorsque vous appuyez sur F1 avec le curseur positionné dans un mot clé. Si la valeur est $true, une fenêtre contextuelle affiche le contenu de l’aide installée localement. Vous pouvez installer les fichiers d’aide en exécutant la commande Update-Help. Si la valeur est $false, votre navigateur s’ouvre sur une page sur 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
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Spécifie la couleur d’arrière-plan du texte détaillé qui apparaît dans le volet Console. Il s’agit d’un objet System.Windows.Media.Color.
# Changes the background color for verbose text to blue.
$psISE.Options.VerboseBackgroundColor ='#0000FF'
VerboseForegroundColor
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Spécifie la couleur de premier plan pour le texte détaillé qui apparaît dans le volet Console. Il s’agit d’un objet System.Windows.Media.Color.
# Changes the foreground color for verbose text to yellow.
$psISE.Options.VerboseForegroundColor = 'yellow'
WarningBackgroundColor
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Spécifie la couleur d’arrière-plan du texte d’avertissement qui apparaît dans le volet Console. Il s’agit d’un objet System.Windows.Media.Color.
# Changes the background color for warning text to blue.
$psISE.Options.WarningBackgroundColor = '#0000FF'
WarningForegroundColor
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Spécifie la couleur de premier plan pour le texte d’avertissement qui apparaît dans le volet Sortie. Il s’agit d’un objet System.Windows.Media.Color.
# Changes the foreground color for warning text to yellow.
$psISE.Options.WarningForegroundColor = 'yellow'
XmlTokenColors
Pris en charge dans Windows PowerShell ISE 3.0 et versions ultérieures, et non présents dans les versions antérieures.
Spécifie un objet de dictionnaire qui contient des paires nom/valeur de types de jetons et de couleurs pour le contenu XML affiché dans Windows PowerShell ISE. Les couleurs de jeton peuvent être définies pour les éléments suivants : Attribut, Command, CommandArgument, CommandParameter, Comment, GroupEnd, GroupStart, Keyword, LineContinuation, LoopLabel, Member, NewLine, Number, Operator, Position, StatementSeparator, String, Type, Unknown, Variable. Consultez également 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
Pris en charge dans Windows PowerShell ISE 3.0 et versions ultérieures, et non présents dans les versions antérieures.
Spécifie la taille relative du texte dans les volets Console et Script. La valeur par défaut est 100. Les valeurs plus petites entraînent l’apparition du texte dans Windows PowerShell ISE, tandis que de plus grands nombres entraînent l’affichage du texte plus grand. La valeur est un entier compris entre 20 et 400.
# Changes the text in the Windows PowerShell ISE to be double its normal size.
$psISE.Options.Zoom = 200
