Guide pratique pour utiliser la documentation PowerShell

Bienvenue dans la documentation en ligne de PowerShell. Ce site contient des informations de référence sur les applets de commande des versions suivantes de PowerShell :

  • PowerShell 7.4 (LTS-actuel)
  • PowerShell 7.3
  • PowerShell 7.2 (LTS ou actuelle)
  • PowerShell 5.1

Capture d’écran montrant les divers éléments de la page web.

La page web contient plusieurs éléments qui vous aident à naviguer dans la documentation.

  • Navigation de niveau site - La navigation de niveau site apparaît en haut de la page. Elle contient des liens vers d’autres contenus de la plateforme Microsoft Learn.
  • Navigation du contenu associé - La barre de contenu associé se trouve juste en dessous de la navigation de niveau site. Elle contient des liens vers du contenu associé à l’ensemble de documentation actuel, à savoir PowerShell dans le cas présent.
  • Sélecteur de version - Le sélecteur de version apparaît au-dessus de la table des matières et permet de choisir la version de la référence d’applet de commande qui apparaît dans la table des matières.
  • Table des matières - La table des matières sur le côté gauche de la page est divisée en deux sections : conceptuel et informations de référence. Notez la ligne au-dessus du nœud Informations de référence de la table des matières. Les documents conceptuels apparaissent au-dessus de la ligne. Le contenu des informations de référence est répertorié dans le nœud Informations de référence sous la ligne.
  • Boutons d’action - Les boutons d’action permettent d’ajouter du contenu à une collection, de fournir des commentaires, de modifier le contenu ou de partager le contenu avec d’autres personnes.

Sélection de la version de PowerShell

Utilisez le sélecteur de version situé au-dessus de la table des matières pour sélectionner la version de PowerShell que vous voulez. Par défaut, la page se charge avec la version stable la plus récente sélectionnée. Le sélecteur de version permet de choisir la version de la référence d’applet de commande qui apparaît dans la table des matières sous le nœud Informations de référence. Certaines applets de commande fonctionnent différemment selon la version de PowerShell que vous utilisez. Veillez à consulter la documentation qui correspond à la version de PowerShell que vous utilisez.

Le sélecteur de version n’affecte pas la documentation conceptuelle. Les documents conceptuels s’affichent au-dessus du nœud Informations de référence dans la table des matières. Les mêmes articles conceptuels s’affichent pour chaque version sélectionnée. S’il existe des différences propres à la version, la documentation met en avant ces différences.

Animation montrant comment utiliser le sélecteur de version.

Vous pouvez vérifier la version de PowerShell que vous utilisez en inspectant la valeur $PSversionTable.PSVersion. L’exemple suivant montre la sortie pour Windows PowerShell 5.1.

$PSVersionTable.PSVersion
Major  Minor  Build  Revision
-----  -----  -----  --------
5      1      22621  963

Recherche d’articles

Il existe deux façons de rechercher du contenu dans la documentation.

  • La zone de recherche dans la barre de navigation au niveau du site effectue une recherche sur l’intégralité du site. Elle retourne une liste d’articles correspondants de tous les ensembles de documentation.
  • La zone de filtre TOC sous le sélecteur de version autorise le filtrage par mots qui apparaissent dans le titre d’un article. Le filtre affiche une liste d’articles correspondants à mesure que vous tapez. Vous pouvez également sélectionner l’option permettant de rechercher les mots d’un article. Lorsque vous effectuez une recherche ici, elle se limite à la documentation PowerShell.

Dans l’exemple suivant, la recherche dans la barre de navigation au niveau du site retourne 840 résultats pour le mot idempotent. La saisie du mot invoke dans la zone de filtre TOC affiche une liste d’articles qui contiennent le mot invoke dans le titre. La saisie du mot idempotent dans le filtre TOC n’affiche aucun article. Cliquez sur le lien de recherche pour rechercher idempotent dans la documentation PowerShell. Celle-ci retourne uniquement 9 résultats.

Animation illustrant l’utilisation des fonctionnalités de recherche.

Téléchargement de la documentation au format PDF

Pour télécharger la documentation au format PDF, cliquez sur le bouton Télécharger le PDF en bas de la table des matières.

Capture d’écran du bouton Télécharger le PDF.

  • Si vous consultez un article conceptuel, la plateforme Learn crée un fichier PDF contenant tout le contenu conceptuel de la version sélectionnée.
  • Si vous consultez un article d’informations de référence, la plateforme Learn crée un fichier PDF contenant tout le contenu des informations de référence de la version sélectionnée.

Recherche d’articles pour les versions précédentes

La documentation des versions antérieures de PowerShell est archivée sur notre site Versions précédentes. Vous pouvez choisir Versions précédentes dans le sélecteur de version.

Capture d’écran de l’option Versions précédentes.

Ce site contient la documentation pour les rubriques suivantes :

  • PowerShell 3.0
  • PowerShell 4.0
  • PowerShell 5.0
  • PowerShell 6
  • PowerShell 7.0
  • PowerShell 7.1
  • Flux de travail PowerShell
  • Accès web PowerShell