Différences

Ci-dessous, les différences entre deux révisions de la page.

--- dev:powershell:ecrire_un_module_powershell [2023/08/23 10:51] – yoann
+++ dev:powershell:ecrire_un_module_powershell [2023/08/27 12:25] (Version actuelle) – yoann
@@ Ligne 4: / Ligne 4: @@
 ====== Powershell : Créer un module ======
-===== Fichier Manifest =====
+===== Le fichier Manifest =====
-Une bonne pratique consiste à générer le fichier manifest du module via la cmdlet **New-ModuleManifest** :
+Le fichier manifeste de module est un fichier de données PowerShell avec l'extension ''.psd1''. Il contient une simple table de hachage. Les paires clé-valeur dans la table de hachage permettent de :
+  * Décrire le contenu et les attributs du module ;
+  * Définir les prérequis au fonctionnement du module ;
+  * Contrôler la façon dont les composants sont traités.
+Une bonne pratique consiste à générer le fichier manifest du module via la cmdlet **New-ModuleManifest**. L'appel sans paramètre permet de créer une table de hachage minimale :
 <code powershell>
-New-ModuleManifest -Path C:\myModuleName.psd1 -ModuleVersion "2.0" -Author "YourNameHere"
+New-ModuleManifest -Path C:\My.Module.Name.psd1 -ModuleVersion "2.0" -Author "YourNameHere"
 </code>
@@ Ligne 16: / Ligne 21: @@
 <code powershell>
 # Définition des paramètres
+$module_properties = @{
+   RootModule = '.\aScriptExample.psm1'
+   ModuleVersion = '0.0.0.1'
+   GUID = New-Guid | Select-Object -ExpandProperty Guid
+   Author = 'anAuthorName'
+   CompanyName = 'aCompanyName'
+   Description = "a module short description"
+   PowerShellVersion = '5.1'
+   FunctionsToExport = @("aFunction1", "aFunction2", "aFunction3")
+   CmdletsToExport = @()
+   AliasesToExport = @()
+   VariablesToExport = @('$aVarName1', '$aVarName2')
+}
+New-ModuleManifest -Path .\My.Module.Name.psd1 @module_properties
 </code>
@@ Ligne 28: / Ligne 47: @@
 La cmdlet **Test-ModuleManifest** permet de vérifier la syntaxe du fichier module manifest :
 <code powershell>
+Test-ModuleManifest .\Phobos.Epsilon.filehash.psd1
+</code>
+===== Sélection des objets à exporter =====
+Fonctions, alias et variables doivent être sélectionnés pour être exportés :
+  * Depuis le script ;
+  * Depuis le fichier manifest.
+Dans le script on utilise la cmdlet **Export-ModuleMember**
+<code powershell>
+Export-ModuleMember -Function Get-Test, New-Test, Start-Test -Alias gtt, ntt, stt -Variable aVarName
+</code>
+Depuis la table de hachage du fichier manifest, on renseigne la valeur de la clé **VariablesToExport**
+<code powershell>
+@{
+  # Par défaut toutes les variables sont exportés. Ici on définit
+  # Précisément les variables qu'on souhaite exporter.
+  VariablesToExport = @('$aVarName1', '$aVarName2')
+}
+</code>
+===== Charger le module =====
+Pour charger le module dans la session active :
+<code powershell>
+Import-Module .\aModuleName.psd1
+</code>
+Ce chargement dynamique est éphémère et ne concerne que le shell en cours d'exécution. Pour que le module soit chargé automatiquement lors du lancement de Powershell, il doit être installé voir la note .
+===== Décharger le module =====
+<code powershell>
+Remove-Module aModuleName
 </code>

wikinotes

Outils pour utilisateurs

Outils du site

Différences

Outils de la page