Écriture d’un module Windows PowerShellWriting a Windows PowerShell Module

Ce document est destiné aux administrateurs, aux développeurs de scripts et aux développeurs d’applets de commande qui doivent empaqueter et distribuer leurs applets de commande Windows PowerShell.This document is written for administrators, script developers, and cmdlet developers who need to package and distribute their Windows PowerShell cmdlets. À l’aide des modules Windows PowerShell, vous pouvez empaqueter et distribuer vos solutions Windows PowerShell sans utiliser de langage compilé.By using Windows PowerShell modules, you can package and distribute your Windows PowerShell solutions without using a compiled language.

Les modules Windows PowerShell vous permettent de partitionner, d’organiser et d’abstraire votre code Windows PowerShell en unités autonomes réutilisables.Windows PowerShell modules enable you to partition, organize, and abstract your Windows PowerShell code into self-contained, reusable units. Ces unités réutilisables vous permettent de partager facilement vos modules directement avec d’autres.With these reusable units, you can easily share your modules directly with others. Si vous êtes développeur de script, vous pouvez également reconditionner des modules tiers pour créer des applications basées sur des scripts personnalisés.If you are a script developer, you can also repackage third-party modules to create custom script-based applications. Les modules, similaires aux modules dans d’autres langages de script tels que Perl et Python, permettent des solutions de script prêtes pour la production qui utilisent des composants redistribuables réutilisables, avec l’avantage supplémentaire de vous permettre de reconditionner et d’abstraire plusieurs composants pour créer des solutions personnalisées.Modules, similar to modules in other scripting languages such as Perl and Python, enable production-ready scripting solutions that use reusable, redistributable components, with the added benefit of enabling you to repackage and abstract multiple components to create custom solutions.

Au niveau le plus basique, Windows PowerShell traite tout code de script Windows PowerShell valide enregistré dans un fichier. psm1 en tant que module.At their most basic, Windows PowerShell will treat any valid Windows PowerShell script code saved in a .psm1 file as a module. PowerShell traitera également automatiquement tout assembly d’applet de commande binaire comme un module.PowerShell will also automatically treat any binary cmdlet assembly as a module. Toutefois, vous pouvez également utiliser un module (ou plus spécifiquement, un manifeste de module) pour regrouper une solution entière.However, you can also use a module (or more specifically, a module manifest) to bundle an entire solution together. Les scénarios suivants décrivent les utilisations typiques des modules Windows PowerShell.The following scenarios describe typical uses for Windows PowerShell modules.

BibliothèquesLibraries

Les modules peuvent être utilisés pour empaqueter et distribuer des bibliothèques cohérentes de fonctions qui effectuent des tâches courantes.Modules can be used to package and distribute cohesive libraries of functions that perform common tasks. En règle générale, les noms de ces fonctions partagent un ou plusieurs noms qui reflètent la tâche courante pour laquelle ils sont utilisés.Typically, the names of these functions share one or more nouns that reflect the common task that they are used for. Ces fonctions peuvent également être similaires aux classes .NET Framework dans la mesure où elles peuvent avoir des membres publics et privés.These functions can also be similar to .NET Framework classes in that they can have public and private members. Par exemple, une bibliothèque peut contenir un ensemble de fonctions pour les transferts de fichiers.For example, a library can contain a set of functions for file transfers. Dans ce cas, le substantif qui reflète la tâche courante peut être « file ».In this case, the noun reflecting the common task might be "file."

ConfigurationConfiguration

Les modules peuvent être utilisés pour personnaliser votre environnement en ajoutant des applets de commande, des fournisseurs, des fonctions et des variables spécifiques.Modules can be used to customize your environment by adding specific cmdlets, providers, functions, and variables.

Développement et distribution de code compiléCompiled Code Development and Distribution

Les développeurs d’applets de commande et fournisseurs peuvent utiliser des modules pour tester et distribuer leur code compilé sans avoir besoin de créer des composants logiciels enfichables. Ils peuvent importer l’assembly qui contient le code compilé en tant que module (un module binaire) sans avoir à créer et inscrire des composants logiciels enfichables.Cmdlet and provider developers can use modules to test and distribute their compiled code without needing to create snap-ins. They can import the assembly that contains the compiled code as a module (a binary module) without needing to create and register snap-ins.

Voir aussiSee Also

Présentation d’un module Windows PowerShellUnderstanding a Windows PowerShell Module

Guide pratique pour écrire un module de script PowerShellHow to Write a PowerShell Script Module

Guide pratique pour écrire un module binaire PowerShellHow to Write a PowerShell Binary Module

Guide pratique pour écrire un manifeste de module PowerShellHow to Write a PowerShell Module Manifest

Modification du chemin d’Installation de PSModulePathModifying the PSModulePath Installation Path

Importation d’un module PowerShellImporting a PowerShell Module

Installation d’un module PowerShellInstalling a PowerShell Module