Note
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier les répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de changer de répertoire.
L’objet ISEOptions représente différents paramètres pour Windows PowerShell ISE. C’est une instance de la classe Microsoft.PowerShell.Host.ISE.ISEOptions .
L’objet ISEOptions fournit les méthodes et propriétés suivantes.
Méthodes
RestoreDefaultConsoleTokenColors()
Pris en charge dans Windows PowerShell ISE 3.0 et ultérieurs, et absent dans les versions antérieures.
Restaure les valeurs par défaut des couleurs des jetons 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 sous 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 de divers messages d’avertissement qui indiquent la case à cocher standard pour empêcher que le message ne soit réaffiché.
# 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 sous Windows PowerShell ISE 2.0 et versions ultérieures.
Restaure les valeurs par défaut des couleurs des jetons dans le panneau 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 ultérieurs, et absent dans les versions antérieures.
Restaure les valeurs par défaut des couleurs des jetons pour les éléments XML affichés dans Windows PowerShell ISE. Voir aussi 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 ultérieurs, et absent dans les versions antérieures.
Spécifie le nombre de minutes entre les opérations de sauvegarde 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, voir ConsolePaneBackgroundColor.
Spécifie la couleur d’arrière-plan pour le panneau Commandes. C’est 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.
Précise si le volet de commandes se trouve au-dessus du volet de 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 ultérieurs, et absent dans les versions antérieures.
Spécifie la couleur de fond pour le panneau Console. C’est 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 ultérieurs, et absent dans les versions antérieures.
Spécifie la couleur de premier plan du texte dans le panneau 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 ultérieurs, et absent dans les versions antérieures.
Spécifie la couleur de fond 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 ultérieurs, et absent dans les versions antérieures.
Spécifie les couleurs des jetons IntelliSense dans le volet de la console ISE de Windows PowerShell. Cette propriété est un objet dictionnaire qui contient des paires nom/valeur de types de jetons et de couleurs pour le volet Console. Pour changer les couleurs des jetons IntelliSense dans le volet Script, voir TokenColors. Pour réinitialiser les couleurs aux valeurs par défaut, voir RestoreDefaultConsoleTokenColors. Les couleurs des jetons peuvent être définies pour les suivants : Attribute, Command, CommandArgument, CommandParameterComment, GroupEnd, GroupStart, Keyword, LineContinuationLoopLabelMemberNewLineNumberOperatorPositionStatementSeparatorStringTypeUnknownVariable.
# 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 sous Windows PowerShell ISE 2.0 et versions ultérieures.
Précise la couleur d’arrière-plan pour le texte de débogage qui apparaît dans le panneau Console. C’est 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'
DebugDeForegroundColor
Pris en charge sous Windows PowerShell ISE 2.0 et versions ultérieures.
Spécifie la couleur de premier plan pour le texte de débogage qui apparaît dans le panneau Console. C’est 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 sous Windows PowerShell ISE 2.0 et versions ultérieures.
Un ensemble de propriétés qui spécifient les valeurs par défaut à utiliser lors de l’utilisation des méthodes de réinitialisation.
# 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
ErreurCouleurArrière-Fond
Pris en charge sous Windows PowerShell ISE 2.0 et versions ultérieures.
Spécifie la couleur d’arrière-plan pour le texte d’erreur qui apparaît dans le panneau Console. C’est 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 sous 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. C’est 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 sous Windows PowerShell ISE 2.0 et versions ultérieures.
Spécifie le nom de la police actuellement utilisé à la fois 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 sous Windows PowerShell ISE 2.0 et versions ultérieures.
Spécifie la taille de police comme un entier. Il est utilisé dans le volet Script, le panneau Commandes et le panneau Sortie. La plage valide des valeurs est de 8 à 32.
# Changes the font size in all panes.
$psISE.Options.FontSize = 20
IntellisenseTimeoutEnSecondesT
Pris en charge dans Windows PowerShell ISE 3.0 et ultérieurs, et absent dans les versions antérieures.
Spécifie le nombre de secondes qu’IntelliSense utilise pour essayer de résoudre le texte actuellement tapé. 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 ultérieurs, et absent dans les versions antérieures.
Spécifie le nombre de fichiers récemment ouverts que Windows PowerShell ISE suit et affiche en bas du menu Ouverture de 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, voir ConsolePaneBackgroundColor.
La propriété de lecture/écriture qui obtient ou définit la couleur d’arrière-plan pour le panneau de sortie lui-même. C’est 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, voir ConsolePaneForegroundColor.
La propriété de lecture/écriture qui modifie la couleur du premier plan du texte dans le panneau de 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, voir ConsolePaneTextBackgroundColor.
La propriété de lecture/écriture qui modifie la couleur d’arrière-plan du texte dans le panneau de sortie.
# Changes the background color of the Output pane text to pink.
$psISE.Options.OutputPaneTextBackgroundColor = 'pink'
ScriptPaneCouleurArrière-Fond
Pris en charge sous Windows PowerShell ISE 2.0 et versions ultérieures.
La propriété de lecture/écriture qui obtient ou définit la couleur de fond des fichiers. C’est 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 sous Windows PowerShell ISE 2.0 et versions ultérieures.
La propriété de lecture/écriture qui obtient ou définit la couleur de premier plan pour les fichiers non-script dans le panneau Script. Pour définir la couleur de premier plan des fichiers script, utilisez les TokenColors.
# Sets the foreground to color of non-script files in the script pane to green.
$psISE.Options.ScriptPaneBackgroundColor = 'green'
ScriptPaneÉtat sélectionné
Pris en charge sous Windows PowerShell ISE 2.0 et versions ultérieures.
La propriété de lecture/écriture qui obtient ou définit la position du panneau Script sur l’affichage. La corde peut être soit « Maximisée », « Haut » ou « Droite ».
# 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 ultérieurs, et absent dans les versions antérieures.
Précise si la liste Ctrl+J des extraits inclut le starter set inclus dans Windows PowerShell. Lorsqu’elle est définie à $false, seuls des 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 ultérieurs, et absent dans les versions antérieures.
Précise si IntelliSense propose des suggestions de syntaxe, de paramètres et de valeurs 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 ultérieurs, et absent dans les versions antérieures.
Précise si IntelliSense propose des suggestions de syntaxe, de paramètres et de valeurs 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 ultérieurs, et absent dans les versions antérieures.
Précise si le panneau 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
Showoutouting
Pris en charge dans Windows PowerShell ISE 3.0 et ultérieurs, et absent dans les versions antérieures.
Précise si le volet Script affiche des crochets extensibles et pliables à côté de sections de code dans la marge gauche. Lorsqu’ils sont affichés, vous pouvez cliquer sur les icônes moins - à côté d’un bloc de texte pour le faire plier ou cliquer sur l’icône plus + pour agrandir un bloc de texte. La valeur par défaut est $true.
# Turn off outlining in the Script pane.
$psISE.Options.ShowOutlining = $false
BarreDeOutils
Pris en charge sous Windows PowerShell ISE 2.0 et versions ultérieures.
Précise si la barre d’outils ISE apparaît en haut de la fenêtre ISE de Windows PowerShell. La valeur par défaut est $true.
# Show the toolbar.
$psISE.Options.ShowToolBar = $true
AfficherAvertissementAvant de sauvegarderOnRun
Pris en charge sous Windows PowerShell ISE 2.0 et versions ultérieures.
Précise si un message d’avertissement apparaît lorsqu’un script est sauvegardé 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
AfficherAvertissementPourFichiers Duplicates
Pris en charge sous Windows PowerShell ISE 2.0 et versions ultérieures.
Précise si un message d’avertissement apparaît lorsque le même fichier est ouvert dans différents onglets PowerShell. Si on règle sur $true, pour ouvrir le même fichier dans plusieurs onglets, ce message s’affiche : « Une copie de ce fichier est ouverte dans un autre onglet PowerShell Windows. Les modifications apportées à ce fichier affecteront 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 sous Windows PowerShell ISE 2.0 et versions ultérieures.
Spécifie les couleurs des jetons IntelliSense dans le volet script ISE PowerShell de Windows. Cette propriété est un objet dictionnaire qui contient des paires nom/valeur de types de jetons et de couleurs pour le volet Script. Pour changer les couleurs des jetons IntelliSense dans le volet Console, voir ConsoleTokenColors. Pour réinitialiser les couleurs aux valeurs par défaut, voir RestoreDefaultTokenColors. Les couleurs des jetons peuvent être définies pour les suivants : Attribut, Command, CommandArgument, CommandParameter, Comment, GroupEnd, GroupStart, Mot-clé, LineContinuation, LoopLabel, Member, NewLine, Number, Operator, Position, StatementSeparator, String, Type, Inconnu, 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 ultérieurs, et absent dans les versions antérieures.
Précise si vous pouvez utiliser la touche Entrée pour sélectionner une option fournie par IntelliSense 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 ultérieurs, et absent dans les versions antérieures.
Précise 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 ultérieurs, et absent dans les versions antérieures.
Précise si l’Aide installée localement ou l’Aide en ligne apparaît lorsque vous appuyez sur F1 avec le curseur positionné dans un mot-clé. Si la fonction est réglée sur $true, alors une fenêtre contextuelle affiche le contenu de l’Aide installée localement. Vous pouvez installer les fichiers d’aide en exécutant la Update-Help commande. Si vous êtes réglé sur $false, alors 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
VerbeCouleurArrière-Fond
Pris en charge sous Windows PowerShell ISE 2.0 et versions ultérieures.
Spécifie la couleur de fond pour le texte verbeux qui apparaît dans le volet Console. C’est un objet System.Windows.Media.Color .
# Changes the background color for verbose text to blue.
$psISE.Options.VerboseBackgroundColor ='#0000FF'
VerboseForegroundColor
Pris en charge sous Windows PowerShell ISE 2.0 et versions ultérieures.
Spécifie la couleur de premier plan pour le texte verbeux qui apparaît dans le panneau Console. C’est un objet System.Windows.Media.Color .
# Changes the foreground color for verbose text to yellow.
$psISE.Options.VerboseForegroundColor = 'yellow'
AvertissementCouleurArrière-Fond
Pris en charge sous Windows PowerShell ISE 2.0 et versions ultérieures.
Spécifie la couleur d’arrière-plan pour le texte d’avertissement qui apparaît dans le panneau Console. C’est un objet System.Windows.Media.Color .
# Changes the background color for warning text to blue.
$psISE.Options.WarningBackgroundColor = '#0000FF'
AvertissementCouleur du premier plan
Pris en charge sous Windows PowerShell ISE 2.0 et versions ultérieures.
Spécifie la couleur du premier plan pour le texte d’avertissement qui apparaît dans le panneau de sortie. C’est 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 ultérieurs, et absent dans les versions antérieures.
Spécifie un objet 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 des jetons peuvent être définies pour les suivants : Attribut, Command, CommandArgument, CommandParameter, Comment, GroupEnd, GroupStart, Mot-clé, LineContinuation, LoopLabel, Member, NewLine, Number, Operator, Position, StatementSeparator, String, Type, Inconnu, Variable. Voir aussi 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 ultérieurs, et absent dans les versions antérieures.
Spécifie la taille relative du texte dans les panneaux Console et Script. La valeur par défaut est 100. Des valeurs plus petites font apparaître le texte dans Windows PowerShell ISE tandis que des nombres plus grands font apparaître le texte plus grand. La valeur est un entier allant de 20 à 400.
# Changes the text in the Windows PowerShell ISE to be double its normal size.
$psISE.Options.Zoom = 200