demande de rappel immédiat

PowerShell V3 : du nouveau dans l'aide

Posted by Jean-Paul Blanc Thursday, May 03, 2012 10:47:00 AM
Rate this Content 0 Votes

 

L'aide est un point fort de Microsoft PowerShell 1.0 et 2.0 avec notamment la disponibilité, en ligne de commande, des manuels de références et de programmation à travers l'applet de commande Get-Help.

# Manuel de référence pour une applet de commande :
Get-Help Get-Command -Full
# Manuels de programmation :
Get-Help About_*

D'ou la surprise quand on passe la première commande Get-Help dans la version 3.0 :

Aide dans PowerShell V3.0

REMARKS
Get-Help cannot find the Help files for this cmdlet on this computer. It is displaying only partial help.
      -- To download and install Help files for the module that includes this cmdlet, use Update-Help.
      -- To view the Help topic for this cmdlet online, type: "Get-Help Get-Command -Online" or
         go to http://go.microsoft.com/fwlink/?LinkID=113309.

Associé au fait que le dossier $pshome\en-us ne contient aucun fichier d'aide :

Contenu de dossier $pshome\En-US en PowerShell V3.0

En fait dans PowerShell 3.0 la documentation n'est pas installée avec le produit. La raison est que Microsoft à souhaité mettre en place le moyen de conserver une documentation à jour.

Pour cela, comme dans les versions précédentes, l'utilisateur peut utiliser le paramètre -Online de l'applet de commande Get-Help. Mais dans PowerShell 3.0 l'utilisateur peut en plus utiliser les nouvelles applets de commande Update-Help et Save-Help pour charger l'aide depuis Internet (par défaut) ou un disque local et la sauvegarder sur un disque local.

Remarque : J'ai installée 'Windows Management Framework 3.0 Beta' en version anglaise, sur un système Windows Seven anglais dont la culture courante est le français (histoire d'avoir le bon clavier). Afin de télécharger la documentation anglaise (la seule disponible à ce jour) il faut ajouter le paramètre -UICulture en-US. L'option -Force permet de forcer le rechargement de la documentation.

Les commandes suivantes permettent de télécharger l'aide depuis internet, de la sauvegarder sur un disque réseau puis ensuite de la télécharger depuis ce disque réseau. Cela illustre la possibilité de mettre la documentation à jour, mais aussi de la tenir à disposition pour des utilisateurs du réseau local qui n'auraient pas directement acces à Internet.

Mise à jour et sauvegarde de l'aide en PowerShell 3.0

L'aide est sauvegardée sous la forme de fichiers .Cab et .XML.

Microsoft.PowerShell.Core_00000000-0000-0000-0000-000000000000_en-US_HelpContent.cab
Microsoft.PowerShell.Core_00000000-0000-0000-0000-000000000000_HelpInfo.xml
Microsoft.PowerShell.Diagnostics_ca046f10-ca64-4740-8ff9-2565dba61a4f_en-US_HelpContent.cab
Microsoft.PowerShell.Diagnostics_ca046f10-ca64-4740-8ff9-2565dba61a4f_HelpInfo.xml
Microsoft.PowerShell.Host_56d66100-99a0-4ffc-a12d-eee9a6718aef_en-US_HelpContent.cab
Microsoft.PowerShell.Host_56d66100-99a0-4ffc-a12d-eee9a6718aef_HelpInfo.xml
Microsoft.PowerShell.Management_eefcb906-b326-4e99-9f54-8b4bb6ef3c6d_en-US_HelpContent.cab
Microsoft.PowerShell.Management_eefcb906-b326-4e99-9f54-8b4bb6ef3c6d_HelpInfo.xml
Microsoft.PowerShell.Security_a94c8c7e-9810-47c0-b8af-65089c13a35a_en-US_HelpContent.cab
Microsoft.PowerShell.Security_a94c8c7e-9810-47c0-b8af-65089c13a35a_HelpInfo.xml
Microsoft.PowerShell.Utility_1da87e53-152b-403e-98dc-74d7b4d63d59_en-US_HelpContent.cab
Microsoft.PowerShell.Utility_1da87e53-152b-403e-98dc-74d7b4d63d59_HelpInfo.xml
Microsoft.WSMan.Management_766204a6-330e-4263-a7ab-46c87afc366c_en-US_HelpContent.cab
Microsoft.WSMan.Management_766204a6-330e-4263-a7ab-46c87afc366c_HelpInfo.xml

Après la mise à jour de l'aide il est enfin possible de consulter l'aide en ligne de commande ansi que les fichier About_* dont about_Windows_PowerShell_3.0.

 Outre l'aide Internet une aide graphique sur le poste local est intégrée à PowerShell 3.0 à travers l'applet de commande Show-Command. Cette CmdLet est le pendant graphique de l'applet de commande Get-Command. Utilisée pour une applet de commande elle permet :

  1. De constituer une ligne de commande à partir d'un formulaire
    1. Pour l'exécuter directement
    2. Pour la copier dans le presse papier
  2. De discerner les jeux paramètres de chaque "ParameterSet"
  3. De discerner les paramètres communs

Exemple de fenêtre Show-Command

L'applet de commande Show-Command peut-être appelée seule, elle permet alors de découvrir la totalité des Cmdlets et des fonctions accessibles au travers des modules disponibles :

Fenêtre Show-Command

Comments are closed on this post.