about_Prompts
Description courte
Décrit la Prompt
fonction et montre comment créer une fonction personnalisée Prompt
.
Description longue
L’invite de commandes PowerShell indique que PowerShell est prêt à exécuter une commande :
PS C:\>
PowerShell a une fonction intégrée Prompt
. Vous pouvez définir votre propre fonction personnalisée Prompt
dans votre script de profil PowerShell.
À propos de la fonction Prompt
La Prompt
fonction détermine l’apparence de l’invite PowerShell.
PowerShell est fourni avec une fonction intégrée, mais vous pouvez la remplacer en Prompt
définissant votre propre Prompt
fonction.
La Prompt
fonction a la syntaxe suivante :
function Prompt { <function-body> }
La Prompt
fonction doit retourner un objet . Il est recommandé de renvoyer une chaîne ou un objet au format chaîne. La longueur maximale recommandée est de 80 caractères.
Par exemple, la fonction suivante Prompt
retourne une chaîne « Hello, World » suivie d’un crochet droit (>
).
PS C:\> function prompt {"Hello, World > "}
Hello, World >
Obtention de la fonction Prompt
Pour obtenir la Prompt
fonction, utilisez l’applet de Get-Command
commande ou utilisez l’applet Get-Item
de commande dans le lecteur Function.
Par exemple :
PS C:\> Get-Command Prompt
CommandType Name ModuleName
----------- ---- ----------
Function prompt
Pour obtenir le script qui définit la valeur de l’invite, utilisez la méthode dot pour obtenir la propriété ScriptBlock de la Prompt
fonction .
Par exemple :
(Get-Command Prompt).ScriptBlock
"PS $($executionContext.SessionState.Path.CurrentLocation)$('>' * ($nestedPromptLevel + 1)) "
# .Link
# https://go.microsoft.com/fwlink/?LinkID=225750
# .ExternalHelp System.Management.Automation.dll-help.xml
Comme toutes les fonctions, la Prompt
fonction est stockée dans le Function:
lecteur.
Pour afficher le script qui crée la fonction actuelle Prompt
, tapez :
(Get-Item function:prompt).ScriptBlock
Invite par défaut
L’invite par défaut s’affiche uniquement lorsque la Prompt
fonction génère une erreur ou ne retourne pas d’objet.
L’invite PowerShell par défaut est la suivante :
PS>
Par exemple, la commande suivante définit la fonction sur Prompt
$null
, ce qui n’est pas valide. Par conséquent, l’invite par défaut s’affiche.
PS C:\> function prompt {$null}
PS>
Étant donné que PowerShell est fourni avec une invite intégrée, vous ne voyez généralement pas l’invite par défaut.
Invite intégrée
PowerShell inclut une fonction intégrée Prompt
.
function prompt {
"PS $($executionContext.SessionState.Path.CurrentLocation)$('>' * ($nestedPromptLevel + 1)) ";
# .Link
# https://go.microsoft.com/fwlink/?LinkID=225750
# .ExternalHelp System.Management.Automation.dll-help.xml
}
La fonction utilise l’applet de Test-Path
commande pour tester si la $PSDebugContext
variable automatique a une valeur. Si $PSDebugContext
a une valeur, vous exécutez en mode débogage et [DBG]:
est ajouté à l’invite, comme suit :
[DBG]: PS C:\ps-test>
Si $PSDebugContext
n’est pas renseigné, la fonction ajoute PS
à l’invite.
De plus, la fonction utilise l’applet Get-Location
de commande pour obtenir l’emplacement actuel du répertoire du système de fichiers. Ensuite, il ajoute un crochet à angle droit (>
).
Par exemple :
PS C:\ps-test>
Si vous êtes dans une invite imbriquée, la fonction ajoute deux crochets angulaires (>>
) à l’invite. Vous êtes dans une invite imbriquée si la valeur de la $NestedPromptLevel
variable automatique est supérieure à 0.
Par exemple, lorsque vous déboguez dans une invite imbriquée, l’invite ressemble à l’invite suivante :
[DBG] PS C:\ps-test>>>
Modifications apportées à l’invite
L’applet Enter-PSSession
de commande ajoute le nom de l’ordinateur distant à la fonction actuelle Prompt
. Lorsque vous utilisez l’applet Enter-PSSession
de commande pour démarrer une session avec un ordinateur distant, l’invite de commandes change pour inclure le nom de l’ordinateur distant. Par exemple :
PS Hello, World> Enter-PSSession Server01
[Server01]: PS Hello, World>
D’autres applications hôtes PowerShell et autres interpréteurs de commandes peuvent avoir leurs propres invites de commandes personnalisées.
Pour plus d’informations sur les $PSDebugContext
variables automatiques et $NestedPromptLevel
, consultez about_Automatic_Variables.
Comment personnaliser l’invite
Pour personnaliser l’invite, écrivez une nouvelle Prompt
fonction. La fonction n’est pas protégée. Vous pouvez donc la remplacer.
Pour écrire une Prompt
fonction, tapez ce qui suit :
function prompt { }
Ensuite, entre les accolades, entrez les commandes ou la chaîne qui crée votre invite.
Par exemple, l’invite suivante inclut le nom de votre ordinateur :
function prompt {"PS [$env:COMPUTERNAME]> "}
Sur l’ordinateur Server01, l’invite ressemble à l’invite suivante :
PS [Server01] >
La fonction suivante Prompt
inclut la date et l’heure actuelles :
function prompt {"$(Get-Date)> "}
L’invite ressemble à l’invite suivante :
03/15/2012 17:49:47>
Vous pouvez également modifier la fonction par défaut Prompt
:
Par exemple, la fonction modifiée Prompt
suivante ajoute [ADMIN]:
à l’invite PowerShell intégrée lors de l’exécution dans une session avec élévation de privilèges.
function prompt {
$identity = [Security.Principal.WindowsIdentity]::GetCurrent()
$principal = [Security.Principal.WindowsPrincipal] $identity
$adminRole = [Security.Principal.WindowsBuiltInRole]::Administrator
$(if (Test-Path variable:/PSDebugContext) { '[DBG]: ' }
elseif($principal.IsInRole($adminRole)) { "[ADMIN]: " }
else { '' }
) + 'PS ' + $(Get-Location) +
$(if ($NestedPromptLevel -ge 1) { '>>' }) + '> '
}
Lorsque vous démarrez PowerShell à l’aide de l’option Exécuter en tant qu’administrateur , une invite semblable à l’invite suivante s’affiche :
[ADMIN]: PS C:\ps-test>
La fonction suivante Prompt
affiche l’ID d’historique de la commande suivante. Pour afficher l’historique des commandes, utilisez l’applet de Get-History
commande .
function prompt {
# The at sign creates an array in case only one history item exists.
$history = @(Get-History)
if($history.Count -gt 0)
{
$lastItem = $history[$history.Count - 1]
$lastId = $lastItem.Id
}
$nextCommand = $lastId + 1
$currentDirectory = Get-Location
"PS: $nextCommand $currentDirectory >"
}
L’invite suivante utilise les Write-Host
applets de commande et Get-Random
pour créer une invite qui change de couleur de façon aléatoire. Étant donné que Write-Host
écrit dans l’application hôte actuelle, mais ne retourne pas d’objet, cette fonction inclut une Return
instruction . Sans elle, PowerShell utilise l’invite par défaut, PS>
.
function prompt {
$color = Get-Random -Min 1 -Max 16
Write-Host ("PS " + $(Get-Location) +">") -NoNewLine `
-ForegroundColor $Color
return " "
}
Enregistrement de la fonction Prompt
Comme n’importe quelle fonction, la Prompt
fonction existe uniquement dans la session active. Pour enregistrer la fonction pour les Prompt
sessions futures, ajoutez-la à vos profils PowerShell. Pour plus d'informations sur les profils, consultez about_Profiles.