À propos des profils
Description courte
Décrit comment créer et utiliser un profil PowerShell.
Description longue
Vous pouvez créer un profil PowerShell pour personnaliser votre environnement et ajouter des éléments spécifiques à la session à chaque session PowerShell que vous démarrez.
Un profil PowerShell est un script qui s’exécute au démarrage de PowerShell. Vous pouvez utiliser le profil comme script d’ouverture de session pour personnaliser l’environnement. Vous pouvez ajouter des commandes, des alias, des fonctions, des variables, des composants logiciels enfichables, des modules et des lecteurs PowerShell. Vous pouvez également ajouter d’autres éléments spécifiques à votre profil afin qu’ils soient disponibles dans chaque session sans avoir à les importer ou à les recréer.
PowerShell prend en charge plusieurs profils pour les utilisateurs et les programmes hôtes. Toutefois, il ne crée pas les profils pour vous. Cette rubrique décrit les profils et explique comment créer et gérer des profils sur votre ordinateur.
Il explique comment utiliser le paramètre NoProfile de la console PowerShell (PowerShell.exe) pour démarrer PowerShell sans profils. Et explique l’effet de la stratégie d’exécution PowerShell sur les profils.
Fichiers de profil
PowerShell prend en charge plusieurs fichiers de profil. En outre, les programmes hôtes PowerShell peuvent prendre en charge leurs propres profils spécifiques à l’hôte.
Par exemple, la console PowerShell prend en charge les fichiers de profil de base suivants. Les profils sont répertoriés dans l’ordre de priorité. Le premier profil a la priorité la plus élevée.
| Description | Path |
|---|---|
| Tous les utilisateurs, tous les hôtes | $PSHOME\Profile.ps1 |
| Tous les utilisateurs, hôte actuel | $PSHOME\Microsoft.PowerShell_profile.ps1 |
| Utilisateur actuel, tous les hôtes | $Home\[My ]Documents\PowerShell\Profile.ps1 |
| Utilisateur actuel, Hôte actuel | $Home\[Mes ]documents\PowerShell\ Microsoft.PowerShell_profile.ps1 |
Les chemins d’accès au profil incluent les variables suivantes :
- Variable
$PSHOME, qui stocke le répertoire d’installation pour PowerShell - Variable
$Homequi stocke le répertoire d’accueil de l’utilisateur actuel
En outre, d’autres programmes qui hébergent PowerShell peuvent prendre en charge leurs propres profils. Par exemple, Visual Studio Code prend en charge les profils spécifiques à l’hôte suivants.
| Description | Path |
|---|---|
| Tous les utilisateurs, Hôte actuel | $PSHOME\Microsoft.VSCode_profile.ps1 |
| Utilisateur actuel, Hôte actuel | $Home\[Mes ]documents\PowerShell\ Microsoft.VSCode_profile.ps1 |
Dans l’aide PowerShell, le profil « CurrentUser, Current Host » est le profil le plus souvent appelé « votre profil PowerShell ».
Variable $PROFILE
La $PROFILE variable automatique stocke les chemins d’accès aux profils PowerShell disponibles dans la session active.
Pour afficher un chemin d’accès au profil, affichez la valeur de la $PROFILE variable. Vous pouvez également utiliser la $PROFILE variable dans une commande pour représenter un chemin d’accès.
La $PROFILE variable stocke le chemin d’accès au profil « Utilisateur actuel, Hôte actuel ». Les autres profils sont enregistrés dans les propriétés de note de la $PROFILE variable.
Par exemple, la $PROFILE variable a les valeurs suivantes dans la console Windows PowerShell.
| Description | Nom |
|---|---|
| Utilisateur actuel, hôte actuel | $PROFILE |
| Utilisateur actuel, hôte actuel | $PROFILE.CurrentUserCurrentHost |
| Utilisateur actuel, tous les hôtes | $PROFILE.CurrentUserAllHosts |
| Tous les utilisateurs, hôte actuel | $PROFILE.AllUsersCurrentHost |
| Tous les utilisateurs, tous les hôtes | $PROFILE.AllUsersAllHosts |
Étant donné que les valeurs de la $PROFILE variable changent pour chaque utilisateur et dans chaque application hôte, assurez-vous d’afficher les valeurs des variables de profil dans chaque application hôte PowerShell que vous utilisez.
Pour afficher les valeurs actuelles de la $PROFILE variable, tapez :
$PROFILE | Get-Member -Type NoteProperty
Vous pouvez utiliser la $PROFILE variable dans de nombreuses commandes. Par exemple, la commande suivante ouvre le profil « Utilisateur actuel, Hôte actuel » dans le Bloc-notes :
notepad $PROFILE
La commande suivante détermine si un profil « Tous les utilisateurs, tous les hôtes » a été créé sur l’ordinateur local :
Test-Path -Path $PROFILE.AllUsersAllHosts
Comment créer un profil
Pour créer un profil PowerShell, utilisez le format de commande suivant :
if (!(Test-Path -Path <profile-name>)) {
New-Item -ItemType File -Path <profile-name> -Force
}
Par exemple, pour créer un profil pour l’utilisateur actuel dans l’application hôte PowerShell actuelle, utilisez la commande suivante :
if (!(Test-Path -Path $PROFILE)) {
New-Item -ItemType File -Path $PROFILE -Force
}
Dans cette commande, l’instruction If vous empêche de remplacer un profil existant. Remplacez la valeur de l’espace <réservé de chemin d’accès> au profil par le chemin d’accès au fichier de profil que vous souhaitez créer.
Notes
Pour créer des profils « Tous les utilisateurs » dans Windows Vista et versions ultérieures de Windows, démarrez PowerShell avec l’option Exécuter en tant qu’administrateur .
Guide pratique pour modifier un profil
Vous pouvez ouvrir n’importe quel profil PowerShell dans un éditeur de texte, tel que le Bloc-notes.
Pour ouvrir le profil de l’utilisateur actuel dans l’application hôte PowerShell actuelle dans le Bloc-notes, tapez :
notepad $PROFILE
Pour ouvrir d’autres profils, spécifiez le nom du profil. Par exemple, pour ouvrir le profil pour tous les utilisateurs de toutes les applications hôtes, tapez :
notepad $PROFILE.AllUsersAllHosts
Pour appliquer les modifications, enregistrez le fichier de profil, puis redémarrez PowerShell.
Comment choisir un profil
Si vous utilisez plusieurs applications hôtes, placez les éléments que vous utilisez dans toutes les applications hôtes dans votre $PROFILE.CurrentUserAllHosts profil. Placez des éléments spécifiques à une application hôte, par exemple une commande qui définit la couleur d’arrière-plan d’une application hôte, dans un profil spécifique à cette application hôte.
Si vous êtes un administrateur qui personnalise PowerShell pour de nombreux utilisateurs, suivez ces instructions :
- Stocker les éléments courants dans le
$PROFILE.AllUsersAllHostsprofil - Stocker des éléments spécifiques à une application hôte dans
$PROFILE.AllUsersCurrentHostdes profils spécifiques à l’application hôte - Stocker des éléments pour des utilisateurs particuliers dans les profils spécifiques à l’utilisateur
Veillez à vérifier la documentation de l’application hôte pour toute implémentation spéciale des profils PowerShell.
Comment utiliser un profil
La plupart des éléments que vous créez dans PowerShell et la plupart des commandes que vous exécutez affectent uniquement la session active. Lorsque vous terminez la session, les éléments sont supprimés.
Les commandes et éléments spécifiques à la session incluent des variables, des variables de préférence, des alias, des fonctions, des commandes (à l’exception de Set-ExecutionPolicy) et des modules PowerShell que vous ajoutez à la session.
Pour enregistrer ces éléments et les rendre disponibles dans toutes les sessions futures, ajoutez-les à un profil PowerShell.
Une autre utilisation courante pour les profils consiste à enregistrer des fonctions, des alias et des variables fréquemment utilisés. Lorsque vous enregistrez les éléments d’un profil, vous pouvez les utiliser dans une session applicable sans les recréer.
Guide pratique pour démarrer un profil
Lorsque vous ouvrez le fichier de profil, il est vide. Toutefois, vous pouvez le remplir avec les variables, les alias et les commandes que vous utilisez fréquemment.
Voici quelques suggestions pour commencer.
Ajouter des commandes qui facilitent l’ouverture de votre profil
Cela est particulièrement utile si vous utilisez un profil autre que le profil « Utilisateur actuel, Hôte actuel ». Par exemple, ajoutez la commande suivante :
function Pro {notepad $PROFILE.CurrentUserAllHosts}
Ajouter une fonction qui répertorie les alias de n’importe quelle applet de commande
function Get-CmdletAlias ($cmdletname) {
Get-Alias |
Where-Object -FilterScript {$_.Definition -like "$cmdletname"} |
Format-Table -Property Definition, Name -AutoSize
}
Personnaliser votre console
function Color-Console {
$Host.ui.rawui.backgroundcolor = "white"
$Host.ui.rawui.foregroundcolor = "black"
$hosttime = (Get-ChildItem -Path $PSHOME\PowerShell.exe).CreationTime
$hostversion="$($Host.Version.Major)`.$($Host.Version.Minor)"
$Host.UI.RawUI.WindowTitle = "PowerShell $hostversion ($hosttime)"
Clear-Host
}
Color-Console
Ajouter une invite PowerShell personnalisée
function Prompt
{
$env:COMPUTERNAME + "\" + (Get-Location) + "> "
}
Pour plus d’informations sur l’invite PowerShell, consultez about_Prompts.
Paramètre NoProfile
Pour démarrer PowerShell sans profils, utilisez le paramètre NoProfile de PowerShell.exe, le programme qui démarre PowerShell.
Pour commencer, ouvrez un programme qui peut démarrer PowerShell, tel que Cmd.exe ou PowerShell lui-même. Vous pouvez également utiliser la boîte de dialogue Exécuter dans Windows.
Tapez :
PowerShell -NoProfile
Pour obtenir la liste complète des paramètres de PowerShell.exe, tapez :
PowerShell -?
Profils et stratégie d’exécution
La stratégie d’exécution PowerShell détermine, en partie, si vous pouvez exécuter des scripts et charger des fichiers de configuration, y compris les profils. La stratégie d’exécution restreinte est la valeur par défaut. Il empêche l’exécution de tous les scripts, y compris les profils. Si vous utilisez la stratégie « Restreint », le profil ne s’exécute pas et son contenu n’est pas appliqué.
Une Set-ExecutionPolicy commande définit et modifie votre stratégie d’exécution. Il s’agit de l’une des rares commandes qui s’applique dans toutes les sessions PowerShell, car la valeur est enregistrée dans le Registre. Vous n’avez pas à le définir lorsque vous ouvrez la console, et vous n’avez pas besoin de stocker une Set-ExecutionPolicy commande dans votre profil.
Profils et sessions distantes
Les profils PowerShell ne sont pas exécutés automatiquement dans les sessions distantes, de sorte que les commandes que les profils ajoutent ne sont pas présentes dans la session distante. En outre, la $PROFILE variable automatique n’est pas remplie dans les sessions distantes.
Pour exécuter un profil dans une session, utilisez l’applet de commande Invoke-Command .
Par exemple, la commande suivante exécute le profil « Utilisateur actuel, Hôte actuel » à partir de l’ordinateur local dans la session dans $s.
Invoke-Command -Session $s -FilePath $PROFILE
La commande suivante exécute le profil « Utilisateur actuel, Hôte actuel » à partir de l’ordinateur distant dans la session dans $s. Étant donné que la $PROFILE variable n’est pas remplie, la commande utilise le chemin explicite du profil. Nous utilisons l’opérateur d’approvisionnement de points afin que le profil s’exécute dans l’étendue actuelle sur l’ordinateur distant et non dans sa propre étendue.
Invoke-Command -Session $s -ScriptBlock {
. "$HOME\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1"
}
Après avoir exécuté cette commande, les commandes que le profil ajoute à la session sont disponibles dans $s.