Partager via

Export-CrescendoModule

  • Référence
Module:
Microsoft.PowerShell.Crescendo

Crée un module à partir de fichiers de configuration JSON PowerShell Crescendo

Syntax

Export-CrescendoModule
      [-ConfigurationFile] <String[]>
      [-ModuleName] <String>
      [-Force]
      [-NoClobberManifest]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Cette applet de commande exporte un objet qui peut être converti en fonction qui sert de proxy pour une commande spécifique à la plateforme. Le fichier de module résultant doit être exécutable jusqu’à la version 5.1 de PowerShell.

L’applet de commande crée le module .psm1 et les fichiers manifeste .psd1 du module. Cela peut créer des problèmes lorsque vous avez personnalisé le manifeste du module au-delà de l’étendue de Crescendo. Utilisez le paramètre NoClobberManifest pour empêcher le remplacement du manifeste.

Exemples

EXEMPLE 1

Export-CrescendoModule -ModuleName netsh -ConfigurationFile netsh*.json
Import-Module ./netsh.psm1

EXEMPLE 2

Export-CrescendoModule netsh netsh*.json -force

Paramètres

-ConfigurationFile

Il s’agit d’une liste de fichiers JSON qui représentent les proxys pour le module.

Type:String[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Par défaut, si Export-CrescendoModule ne remplace pas un module existant. Utilisez le paramètre Force pour remplacer le fichier existant ou supprimez-le avant d’exécuter Export-CrescendoModule.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ModuleName

Nom du fichier de module que vous souhaitez créer. Vous pouvez omettre la fin ..psm1

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NoClobberManifest

Empêche le remplacement du manifeste du module.

Vous devez mettre à jour manuellement le manifeste avec les nouvelles applets de commande et paramètres.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Émettez un objet avec le chemin d’accès au .psm1 et les arguments à New-ModuleManifest.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

String[]

Sorties

Object

Notes

En interne, cette fonction appelle l’applet de Import-CommandConfiguration commande qui retourne un objet de commande. Tous les fichiers fournis dans le paramètre ConfigurationFile sont ensuite utilisés pour créer chaque fonction individuelle. Enfin, tous les proxys sont utilisés pour créer un appel de Export-ModuleMember commande. Par conséquent, lorsque le module résultant est importé, tous les proxys de commande sont disponibles dans le module.

Export-CrescendoModule ajoute la balise CrescendoBuilt au manifeste du module. Vous pouvez utiliser cette balise pour rechercher des modules dans le PowerShell Gallery qui ont été créés à l’aide de Crescendo. Pour plus d'informations, consultez les pages suivantes :