Update-ModuleManifest

Syntaxe

All

Update-ModuleManifest
    [-Path] <String>
    [-NestedModules <Object[]>]
    [-Guid <Guid>]
    [-Author <String>]
    [-CompanyName <String>]
    [-Copyright <String>]
    [-RootModule <String>]
    [-ModuleVersion <Version>]
    [-Description <String>]
    [-ProcessorArchitecture <ProcessorArchitecture>]
    [-CompatiblePSEditions <String[]>]
    [-PowerShellVersion <Version>]
    [-ClrVersion <Version>]
    [-DotNetFrameworkVersion <Version>]
    [-PowerShellHostName <String>]
    [-PowerShellHostVersion <Version>]
    [-RequiredModules <Object[]>]
    [-TypesToProcess <String[]>]
    [-FormatsToProcess <String[]>]
    [-ScriptsToProcess <String[]>]
    [-RequiredAssemblies <String[]>]
    [-FileList <String[]>]
    [-ModuleList <Object[]>]
    [-FunctionsToExport <String[]>]
    [-AliasesToExport <String[]>]
    [-VariablesToExport <String[]>]
    [-CmdletsToExport <String[]>]
    [-DscResourcesToExport <String[]>]
    [-PrivateData <Hashtable>]
    [-Tags <String[]>]
    [-ProjectUri <Uri>]
    [-LicenseUri <Uri>]
    [-IconUri <Uri>]
    [-ReleaseNotes <String[]>]
    [-Prerelease <String>]
    [-HelpInfoUri <Uri>]
    [-PassThru]
    [-DefaultCommandPrefix <String>]
    [-ExternalModuleDependencies <String[]>]
    [-PackageManagementProviders <String[]>]
    [-RequireLicenseAcceptance]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Exemples

Exemple 1 : Mettre à jour un manifeste de module

$Params = @{
  Path = "C:\Test\TestManifest.psd1"
  Author = "TestUser1"
  CompanyName = "Contoso Corporation"
  Copyright = "(c) 2019 Contoso Corporation. All rights reserved."
}

Update-ModuleManifest @Params

Paramètres

-AliasesToExport

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

Utilisez ce paramètre pour restreindre les alias exportés par le module. AliasesToExport peut supprimer des alias de la liste des alias exportés, mais il ne peut pas ajouter d’alias à la liste.

Propriétés des paramètres

Jeux de paramètres

-Author

Spécifie l’auteur du module.

Propriétés des paramètres

Jeux de paramètres

-ClrVersion

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

Propriétés des paramètres

Jeux de paramètres

-CmdletsToExport

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

Utilisez ce paramètre pour restreindre les applets de commande exportées par le module. CmdletsToExport peut supprimer des applets de commande de la liste des applets de commande exportées, mais elle ne peut pas ajouter d’applets de commande à la liste.

Propriétés des paramètres

Jeux de paramètres

-CompanyName

Spécifie l’entreprise ou le fournisseur qui a créé le module.

Propriétés des paramètres

Jeux de paramètres

-CompatiblePSEditions

Spécifie la compatible psEditions du module. Pour plus d’informations sur PSEdition, consultez Modules avec des éditions PowerShell compatibles.

Propriétés des paramètres

Jeux de paramètres

-Confirm

Vous invite à confirmer avant d’exécuter Update-ModuleManifest.

Propriétés des paramètres

Jeux de paramètres

-Copyright

Spécifie une instruction de copyright pour le module.

Propriétés des paramètres

Jeux de paramètres

-DefaultCommandPrefix

Spécifie le préfixe de commande par défaut.

Propriétés des paramètres

Jeux de paramètres

-Description

Spécifie une description du module.

Propriétés des paramètres

Jeux de paramètres

-DotNetFrameworkVersion

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

Propriétés des paramètres

Jeux de paramètres

-DscResourcesToExport

Spécifie les ressources DSC (Desired State Configuration) que le module exporte. Les caractères génériques sont autorisés.

Propriétés des paramètres

Jeux de paramètres

-ExternalModuleDependencies

Spécifie un tableau de dépendances de module externe.

Propriétés des paramètres

Jeux de paramètres

-FileList

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

Propriétés des paramètres

Jeux de paramètres

-FormatsToProcess

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

Lorsque vous importez un module, PowerShell exécute l’applet de commande Update-FormatData avec les fichiers spécifiés. Étant donné que les fichiers de mise en forme ne sont pas délimités, ils affectent tous les états de la session.

Propriétés des paramètres

Jeux de paramètres

-FunctionsToExport

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

Utilisez ce paramètre pour restreindre les fonctions exportées par le module. FunctionsToExport peut supprimer des fonctions de la liste des alias exportés, mais elle ne peut pas ajouter de fonctions à la liste.

Propriétés des paramètres

Jeux de paramètres

-Guid

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

Propriétés des paramètres

Jeux de paramètres

-HelpInfoUri

Spécifie l’adresse Internet du fichier XML HelpInfo du module. Entrez un URI (Uniform Resource Identifier) commençant par http ou https.

Le fichier XML HelpInfo prend en charge la fonctionnalité d’aide pouvant être mise à jour qui a été introduite dans PowerShell version 3.0. Il contient des informations sur l’emplacement des fichiers d’aide téléchargeables du module et les numéros de version des fichiers d’aide les plus récents pour chaque paramètre régional pris en charge.

Pour plus d’informations sur Updatable Help, consultez about_Updatable_Help. Pour plus d’informations sur le fichier XML HelpInfo , consultez Prise en charge de l’aide pouvant être mise à jour.

Propriétés des paramètres

Jeux de paramètres

-IconUri

Spécifie l’URL d’une icône pour le module. L’icône spécifiée s’affiche sur la page web de la galerie pour le module.

Propriétés des paramètres

Jeux de paramètres

-LicenseUri

Spécifie l’URL des termes de licence pour le module.

Propriétés des paramètres

Jeux de paramètres

-ModuleList

Spécifie un tableau de modules inclus dans le module.

Entrez chaque nom de module sous forme de chaîne ou de table de hachage avec les clés ModuleName et ModuleVersion. La table de hachage peut également avoir une clé GUID facultative. Vous pouvez combiner des chaînes et des tables de hachage dans la valeur du paramètre.

Cette clé est conçue pour servir d’inventaire de module. Les modules répertoriés dans la valeur de cette clé ne sont pas traités automatiquement.

Propriétés des paramètres

Jeux de paramètres

-ModuleVersion

Spécifie la version du module.

Propriétés des paramètres

Jeux de paramètres

-NestedModules

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

Entrez chaque nom de module sous forme de chaîne ou de table de hachage avec les clés ModuleName et ModuleVersion. La table de hachage peut également avoir une clé GUID facultative. Vous pouvez combiner des chaînes et des tables de hachage dans la valeur du paramètre.

Propriétés des paramètres

Jeux de paramètres

-PackageManagementProviders

Spécifie un tableau de fournisseurs de gestion de package.

Propriétés des paramètres

Jeux de paramètres

-PassThru

Retourne un objet représentant l’élément avec lequel vous travaillez. Par défaut, Update-ModuleManifest ne génère aucune sortie.

Propriétés des paramètres

Jeux de paramètres

-Path

Spécifie le chemin d’accès et le nom de fichier du manifeste du module. Entrez un chemin d’accès et un nom de fichier avec une extension de nom de fichier .psd1, par exemple $PSHOME\Modules\MyModule\MyModule.psd1.

Si vous spécifiez le chemin d’accès à un fichier existant, Update-ModuleManifest remplace le fichier sans avertissement, sauf si le fichier a l’attribut en lecture seule.

Le manifeste doit se trouver dans le répertoire du module, et le nom du fichier manifeste doit être identique au nom du répertoire du module, mais avec une .psd1 extension.

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.

Propriétés des paramètres

Jeux de paramètres

-PowerShellHostName

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

Pour trouver le nom d’un programme hôte, dans le programme, tapez $Host.Name.

Propriétés des paramètres

Jeux de paramètres

-PowerShellHostVersion

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

Propriétés des paramètres

Jeux de paramètres

-PowerShellVersion

Spécifie la version minimale de PowerShell qui fonctionnera avec ce module. Par exemple, vous pouvez spécifier 3.0, 4.0 ou 5.0 comme valeur de ce paramètre.

Propriétés des paramètres

Jeux de paramètres

-Prerelease

Indique que le module est préversion.

Propriétés des paramètres

Jeux de paramètres

-PrivateData

Spécifie les données transmises au module lorsqu’elles sont importées.

Propriétés des paramètres

Jeux de paramètres

-ProcessorArchitecture

Spécifie l’architecture du processeur requise par le module.

Les valeurs acceptables pour ce paramètre sont les suivantes :

• Amd64
• ARM
• IA64
• MSIL
• Aucun (inconnu ou non spécifié)
• X86

Propriétés des paramètres

Jeux de paramètres

-ProjectUri

Spécifie l’URL d’une page web sur ce projet.

Propriétés des paramètres

Jeux de paramètres

-ReleaseNotes

Spécifie un tableau de chaînes qui contient des notes de publication ou des commentaires que vous souhaitez mettre à disposition pour cette version du script.

Propriétés des paramètres

Jeux de paramètres

-RequiredAssemblies

Spécifie les fichiers d’assembly (.dll) requis par le module. Entrez les noms des fichiers d’assembly. PowerShell charge les assemblys spécifiés avant de mettre à jour des types ou des formats, d’importer des modules imbriqués ou d’importer le fichier de module spécifié dans la valeur de la clé de RootModule.

Utilisez ce paramètre pour spécifier tous les assemblys requis par le module, y compris les assemblys qui doivent être chargés pour mettre à jour les fichiers de mise en forme ou de type répertoriés dans les clés FormatsToProcess ou TypesToProcess , même si ces assemblys sont également répertoriés en tant que modules binaires dans la clé NestedModules .

Propriétés des paramètres

Jeux de paramètres

-RequiredModules

Spécifie les modules qui doivent être dans l’état de session globale. Si les modules requis ne sont pas dans l’état de session global, PowerShell les importe. Si les modules requis ne sont pas disponibles, la commande Import-Module échoue.

Propriétés des paramètres

Jeux de paramètres

-RequireLicenseAcceptance

Spécifie qu’une acceptation de licence est requise pour le module.

Propriétés des paramètres

Jeux de paramètres

-RootModule

Spécifie le fichier principal ou racine du module. Entrez le nom de fichier d’un script (), un module de.ps1 script (.psm1), un manifeste de module (.psd1), un assembly (.dll), un fichier XML de définition d’applet de commande (.cdxml) ou un workflow (.xaml). 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.

Si un module a un fichier manifeste et qu’aucun fichier racine n’a été spécifié dans la clé RootModule , le manifeste devient le fichier principal du module. Et, le module devient un module manifeste (ModuleType = Manifeste).

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

Dans PowerShell 2.0, cette clé a été appelée ModuleToProcess.

Propriétés des paramètres

Jeux de paramètres

-ScriptsToProcess

Spécifie les fichiers de script (.ps1) qui s’exécutent 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 pouvez utiliser un script de connexion.

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

Propriétés des paramètres

Jeux de paramètres

-Tags

Spécifie un tableau de balises.

Propriétés des paramètres

Jeux de paramètres

-TypesToProcess

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

Lorsque vous importez le module, PowerShell exécute l’applet de commande Update-TypeData avec les fichiers spécifiés. Étant donné que les fichiers de type ne sont pas délimités, ils affectent tous les états de session de la session.

Propriétés des paramètres

Jeux de paramètres

-VariablesToExport

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

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

Propriétés des paramètres

Jeux de paramètres

-WhatIf

Montre ce qui se passerait si Update-ModuleManifest s’exécute. L’applet de commande n’est pas exécutée.

Propriétés des paramètres

Jeux de paramètres

CommonParameters

Entrées

String

Sorties

Object

Notes