New-ModuleManifest

Spécifie les alias que le module exporte. Les caractères génériques sont autorisés.

Vous pouvez utiliser ce paramètre pour restreindre les alias exportés par le module. Elle peut supprimer des alias de la liste d'alias exportés, mais ne peut pas ajouter d'alias à la liste.

Si vous omettez ce paramètre, New-ModuleManifest crée une clé AliasesToExport ayant la valeur * (tous), ce qui signifie que tous les alias exportés par le module sont exportés par le manifeste.

Spécifie l'auteur du module.

Ce paramètre est requis par l'applet de commande, mais la clé Author n'est pas obligatoire dans le manifeste. Si vous omettez ce paramètre et que vous n'entrez pas de valeur lorsque vous y êtes invité, New-ModuleManifest crée une clé Author portant le nom de l'utilisateur actuel.

Spécifie la version du Common Language Runtime (CLR) du Microsoft .NET Framework requis par le module.

Si vous omettez ce paramètre, New-ModuleManifest crée une clé CLRVersion avec une valeur de chaîne vide.

Spécifie les applets de commande que le module exporte. Les caractères génériques sont autorisés.

Vous pouvez utiliser ce paramètre pour restreindre les applets de commande exportées par le module. Elle peut supprimer des applets de commande de la liste d'applets de commande exportées, mais elle ne peut pas ajouter d'applets de commande à la liste.

Si vous omettez ce paramètre, New-ModuleManifest crée une clé CmdletsToExport ayant la valeur * (tous), ce qui signifie que toutes les applets de commande exportées par le module sont exportées par le manifeste.

Identifie la société ou le fournisseur qui a créé le module.

Ce paramètre est requis par l'applet de commande, mais la clé CompanyName n'est pas obligatoire dans le manifeste. Si vous omettez ce paramètre et que vous n'entrez pas de valeur lorsque vous y êtes invité, New-ModuleManifest crée une clé CompanyName ayant la valeur « Unknown ».

Spécifie une déclaration de copyright pour le module.

Ce paramètre est requis par l'applet de commande, mais la clé Copyright n'est pas obligatoire dans le manifeste. Si vous omettez ce paramètre et que vous n'entrez pas de valeur lorsque vous y êtes invité, New-ModuleManifest crée une clé Copyright ayant la valeur « (c) <année> <nom_utilisateur>. All rights reserved.» où <année> correspond à l'année en cours et <nom_utilisateur> représente la valeur de la clé Author (si elle est spécifiée) ou le nom de l'utilisateur actuel.

Décrit le contenu du module.

Ce paramètre est requis par l'applet de commande, mais la clé Description n'est pas obligatoire dans le manifeste. Si vous omettez ce paramètre et que vous n'entrez pas de valeur lorsque vous y êtes invité, New-ModuleManifest crée une clé Description avec une valeur de chaîne vide.

Spécifie la version du Microsoft .NET Framework requise par le module.

Si vous omettez ce paramètre, New-ModuleManifest crée une clé DotNetFrameWorkVersion avec une valeur de chaîne vide.

Spécifie tous les éléments inclus dans le module.

Cette clé est conçue pour servir d'inventaire de module. Ces fichiers ne sont pas exportés automatiquement avec le module.

Ce paramètre est requis par l'applet de commande, mais la clé FileList n'est pas obligatoire dans le manifeste. Si vous omettez ce paramètre et que vous n'entrez pas de valeur lorsque vous y êtes invité, New-ModuleManifest crée une clé FileList avec une valeur de tableau vide.

Spécifie les fichiers de mise en forme (.ps1xml) qui sont exécutés lorsque le module est importé.

Lorsque vous importez un module, Windows PowerShell exécute l'applet de commande Update-FormatData avec les fichiers spécifiés. Étant donné qu'aucune portée n'est définie pour les fichiers de mise en forme, ils affectent tous les états de la session.

Ce paramètre est requis par l'applet de commande, mais la clé FormatsToProcess n'est pas obligatoire dans le manifeste. Si vous omettez ce paramètre et que vous n'entrez pas de valeur lorsque vous y êtes invité, New-ModuleManifest crée une clé FormatsToProcess avec une valeur de tableau vide.

Spécifie les fonctions que le module exporte. Les caractères génériques sont autorisés.

Vous pouvez utiliser ce paramètre pour restreindre les fonctions exportées par le module. Elle peut supprimer des fonctions de la liste d'alias exportés, mais ne peut pas ajouter de fonctions à la liste.

Si vous omettez ce paramètre, New-ModuleManifest crée une clé FunctionsToExport ayant la valeur * (tous), ce qui signifie que toutes les fonctions exportées par le module sont exportées par le manifeste.

Spécifie un identificateur unique pour le module. Le GUID peut être utilisé pour distinguer les modules ayant un nom identique.

Si vous omettez ce paramètre, New-ModuleManifest crée une clé GUID dans le manifeste et génère un GUID pour la valeur.

Pour créer un GUID dans Windows PowerShell, tapez « [guid]::NewGuid() ».

Répertorie tous les modules fournis avec ce module.

Entrez chaque nom de module sous forme de chaîne ou une table de hachage comportant les clés ModuleName et GUID. La table de hachage peut également inclure une clé ModuleVersion facultative.

Cette clé est conçue pour servir d'inventaire de module. Ces modules ne sont pas traités automatiquement.

Si vous omettez ce paramètre, New-ModuleManifest crée une clé ModuleList dans le manifeste avec une valeur de tableau vide.

Spécifie le fichier principal ou « racine » du module. Lorsque le module est importé, les membres exportés à partir du fichier de module racine sont importés dans l'état de session de l'appelant. Entrez le nom de fichier d'un module de script (.psm1) ou d'un module binaire (.dll).

Si un module comporte un fichier manifeste et qu'aucun fichier racine n'a été désigné dans la clé ModuleToProcess, le manifeste devient le fichier principal du module et le module devient un « module manifeste » (ModuleType = Manifest).

Pour exporter des membres de fichiers .psm1 ou .dll dans un module comportant un manifeste, les noms de ces fichiers doivent être spécifiés dans les valeurs des clés ModuleToProcess ou NestedModules du manifeste. Sinon, leurs membres ne sont pas exportés.

Ce paramètre est requis par l'applet de commande, mais la clé ModuleToProcess n'est pas obligatoire dans le manifeste. Si vous omettez ce paramètre et que vous n'entrez pas de valeur lorsque vous y êtes invité, New-ModuleManifest crée une clé ModuleToProcess avec une valeur de chaîne vide.

Spécifie la version du module.

Ce paramètre n'est pas requis par l'applet de commande, mais une clé ModuleVersion est obligatoire dans le manifeste. Si vous omettez ce paramètre, New-ModuleManifest crée une clé ModuleVersion dont la valeur est « 1.0 ».

Spécifie les modules de script (.psm1) et les modules binaires (.dll) qui sont importés dans l'état de session du module. Les fichiers de la clé NestedModules sont exécutés dans l'ordre dans lequel ils apparaissent dans la valeur.

En général, les modules imbriqués contiennent les commandes dont le module racine a besoin pour son traitement interne. Par défaut, les commandes des modules imbriqués sont exportées à partir de l'état de session du module dans l'état de session de l'appelant, mais le module racine peut restreindre les commandes qu'il exporte (par exemple, en utilisant une commande Export-Module).

Les modules imbriqués de l'état de session du module sont disponibles pour le module racine, mais ils ne sont pas retournés par une commande Get-Module dans l'état de session de l'appelant.

Les scripts (.ps1) qui apparaissent dans la clé NestedModules sont exécutés dans l'état de session du module, mais pas dans l'état de session de l'appelant. Pour exécuter un script dans l'état de session de l'appelant, répertoriez le nom du fichier de script dans la valeur de la clé ScriptsToProcess du manifeste.

Ce paramètre est requis par l'applet de commande, mais la clé NestedModules n'est pas obligatoire dans le manifeste. Si vous omettez ce paramètre et que vous n'entrez pas de valeur lorsque vous y êtes invité, New-ModuleManifest crée une clé NestedModules avec une valeur de tableau vide.

Écrit le manifeste de module résultant sur la console, en plus de créer un fichier .psd1. Par défaut, cette applet de commande ne génère aucune sortie.

Spécifie le chemin d'accès et le nom du nouveau manifeste de module. Entrez un chemin d'accès et un nom de fichier comportant l'extension de nom de fichier .psd1, comme « $pshome\Modules\MyModule\MyModule.psd1 ». Ce paramètre est obligatoire.

Si vous spécifiez le chemin d'accès à un fichier existant, New-ModuleManifest remplace le fichier sans prévenir, à moins que le fichier ait l'attribut de lecture seule.

Le manifeste doit se trouver dans le répertoire de module et le nom de fichier manifeste doit être identique à celui du répertoire de module, mais avec l'extension de nom de fichier .psd1.

Remarque : vous ne pouvez pas utiliser de variables, telles que $pshome ou $home, en réponse à une invite pour une valeur de paramètre Path. Pour utiliser une variable, incluez le paramètre Path dans la commande.

Spécifie le nom du programme hôte Windows PowerShell requis par le module. Entrez le nom du programme hôte, tel que « Hôte Windows PowerShell ISE » ou « ConsoleHost ». Les caractères génériques ne sont pas autorisés.

Pour rechercher le nom d'un programme hôte, tapez « $host.name » dans le programme.

Si vous omettez ce paramètre, New-ModuleManifest crée une clé PowerShellHostName avec une valeur de chaîne vide.

Spécifie la version minimale du programme hôte Windows PowerShell qui fonctionne avec le module. Entrez un numéro de version, tel que 1.1.

Si vous omettez ce paramètre, New-ModuleManifest crée une clé PowerShellHostName avec une valeur de chaîne vide.

Spécifie la version minimale de Windows PowerShell qui fonctionnera avec ce module. Entrez 1.0 ou 2.0. Les exigences des versions supérieures à 2.0 ne sont pas mises en vigueur.

Si vous omettez ce paramètre, New-ModuleManifest crée une clé PowerShellVersion avec une valeur de chaîne vide.

Spécifie les données qui sont passées au module lorsqu'il est importé.

Si vous omettez ce paramètre, New-ModuleManifest crée une clé PrivateData avec une valeur de chaîne vide.

Spécifie l'architecture de processeur requise par le module. Les valeurs valides sont x86, AMD64, IA64 et None (inconnu ou non spécifié).

Si vous omettez ce paramètre, New-ModuleManifest crée une clé ProcessorArchitecture avec une valeur de chaîne vide.

Spécifie les fichiers d'assembly (.dll) requis par le module. Windows PowerShell charge les assemblys spécifiés avant de mettre à jour les types ou les formats, et d'importer les modules imbriqués ou le fichier de module qui est indiqué dans la valeur de la clé ModuleToProcess.

Utilisez ce paramètre pour répertorier tous les assemblys requis par le module, notamment les assemblys qui doivent être chargés pour mettre à jour tout fichier de mise en forme ou de type répertorié dans les clés FormatsToProcess ou TypesToProcess, même si ces assemblys sont également répertoriés comme modules binaires dans la clé NestedModules.

Ce paramètre est requis par l'applet de commande, mais la clé RequiredAssemblies n'est pas obligatoire dans le manifeste. Si vous omettez ce paramètre et que vous n'entrez pas de valeur lorsque vous y êtes invité, New-ModuleManifest crée une clé RequiredAssemblies avec une valeur de tableau vide.

Spécifie les modules qui doivent se trouver dans l'état de session global. Si les modules requis ne se trouvent pas dans l'état de session global, les tentatives effectuées pour les importer échouent.

Entrez chaque nom de module sous forme de chaîne ou une table de hachage comportant les clés ModuleName et GUID. La table de hachage peut également inclure une clé ModuleVersion facultative. Pour plus d'informations, consultez les exemples.

Windows PowerShell n'importe pas automatiquement les modules requis, mais vérifie uniquement qu'ils sont présents. Toutefois, les modules peuvent inclure des scripts (.ps1) qui importent les modules requis dans l'état de session global.

Si vous omettez ce paramètre, New-ModuleManifest crée une clé RequiredModules avec une valeur de tableau vide.

Spécifie les fichiers de script (.ps1) qui sont exécutés dans l'état de session de l'appelant lorsque le module est importé. Vous pouvez utiliser ces scripts pour préparer un environnement, tout comme vous utiliseriez un script de connexion.

Pour spécifier des scripts qui sont exécutés dans l'état de session du module, utilisez la clé NestedModules.

Si vous omettez ce paramètre, New-ModuleManifest crée une clé ScriptsToProcess avec une valeur de tableau vide.

Spécifie les fichiers de type (.ps1xml) qui sont exécutés lorsque le module est importé.

Lorsque vous importez le module, Windows PowerShell exécute l'applet de commande Update-TypeData avec les fichiers spécifiés. Étant donné qu'aucune portée n'est définie pour les fichiers de type, ils affectent tous les états de la session.

Ce paramètre est requis par l'applet de commande, mais la clé TypesToProcess n'est pas obligatoire dans le manifeste. Si vous omettez ce paramètre et que vous n'entrez pas de valeur lorsque vous y êtes invité, New-ModuleManifest crée une clé TypesToProcess avec une valeur de tableau vide.

Spécifie les variables que le module exporte. Les caractères génériques sont autorisés.

Vous pouvez utiliser ce paramètre pour restreindre les variables exportées par le module. Elle peut supprimer des variables de la liste des variables exportées, mais elle ne peut pas ajouter de variables à la liste.

Si vous omettez ce paramètre, New-ModuleManifest crée une clé VariablesToExport ayant la valeur * (tous), ce qui signifie que toutes les variables exportées par le module sont exportées par le manifeste.

Vous invite à confirmer l'exécution de la commande.

Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.