Guide pratique pour créer un shell de console

Windows PowerShell fournit un outil Make-Shell, également appelé « make-kit », qui est utilisé pour créer un interpréteur de commandes de console qui n’est pas extensible. les coques créées avec ce nouvel outil ne peuvent pas être étendues ultérieurement via un composant logiciel enfichable Windows PowerShell.

Syntax

Voici la syntaxe utilisée pour exécuter Make-Shell à partir d’un fichier make-file.

make-shell
  -out n.exe
  -namespace ns
  [ -lib libdirectory1[,libdirectory2,..] ]
  [ -reference ca1.dll[,ca2.dll,...] ]
  [ -formatdata fd1.format.ps1xml[,fd2.format.ps1xml,...] ]
  [ -typedata td1.type.ps1xml[,td2.type.ps1xml,...] ]
  [ -source c1.cs [,c2.cs,...] ]
  [ -authorizationmanager authorizationManagerType ]
  [ -win32icon i.ico ]
  [ -initscript p.ps1 ]
  [ -builtinscript s1.ps1[,s2.ps1,...] ]
  [ -resource resourcefile.txt ]
  [ -cscflags cscFlags ]
  [ -? | -help ]

Paramètres

Voici une brève description des paramètres de make-shell.

Attention

Les chemins d’accès UNC aux assemblys ne sont pas pris en charge par make-shell.

Paramètre	Description
-out n.exe	Obligatoire. Nom de l’interpréteur de commandes à produire. Le chemin d’accès est spécifié dans le cadre de ce paramètre. Make-shell ajoute « .exe » à cette valeur si elle n’est pas spécifiée. Attention : Ne créez pas de fichier de sortie portant le même nom que le fichier .dll référencé. Si vous tentez cette opération, l’outil Make-Shell crée un fichier. cs portant le même nom, ce qui remplacera le fichier. cs qui contient le code source de votre applet de commande.
-namespace NS	Obligatoire. Espace de noms à utiliser pour la classe System. Management. Automation. instances d’exécution. Runspaceconfiguration dérivée que make-Kit génère et compile.
-lib libdirectory1 [, libdirectory2,..]	les répertoires dans lesquels sont recherchés les assemblys .net, y compris les assemblys Windows PowerShell, les assemblys spécifiés par le reference paramètre, les assemblys référencés indirectement par un autre assembly et les assemblys système .net.
-Reference ca1.dll [, ca2.dll,...]	Liste séparée par des virgules des assemblys à inclure dans l’interpréteur de commandes. Ces assemblys incluent tous les assemblys d’applet de commande et de fournisseur, ainsi que les assemblys de ressource qui doivent être chargés. Si ce paramètre n’est pas spécifié, un interpréteur de commandes qui contient uniquement les applets de commande et les fournisseurs de base fournis par Windows PowerShell. Les assemblys peuvent être spécifiés à l’aide de leur chemin d’accès complet. dans le cas contraire, ils seront recherchés à l’aide du chemin d’accès spécifié par le lib paramètre.
-FormatData FD1 en. format. ps1xml [, FD2. format. ps1xml,...]	Liste séparée par des virgules des données de format à inclure dans l’interpréteur de commandes. Si ce paramètre n’est pas spécifié, un interpréteur de commandes qui contient uniquement les données de format fournies par Windows PowerShell est généré.
-TypeData TD1. type. ps1xml [, TD2. type. ps1xml,...]	Liste séparée par des virgules des données de type à inclure dans l’interpréteur de commandes. Si ce paramètre n’est pas spécifié, un interpréteur de commandes qui contient uniquement les données de type fournies par Windows PowerShell est généré.
-source C1. cs [, C2. cs,...]	Nom d’un fichier, fourni par le développeur de l’interpréteur de commandes, qui contient le code source nécessaire pour générer le shell. Le fichier de code source peut contenir l’un des codes source suivants : : Implémentation du gestionnaire d’autorisations qui remplace le gestionnaire d’autorisations par défaut. (Cela peut également être fourni dans un assembly.) -Déclarations d’attribut d’informations d’assembly : telles que AssemblyCompanyAttribute, AssemblyCopyrightAttribute, AssemblyFileVersionAttribute, AssemblyInformationalVersionAttribute, AssemblyProductAttribute et AssemblyTrademarkAttribute.
-authorizationmanager authorizationManagerType	Type qui contient l’implémentation du gestionnaire d’autorisations. Cela peut être défini dans le code source ou compilé dans un assembly (spécifié par le reference paramètre). Si ce paramètre n’est pas spécifié, le gestionnaire de sécurité par défaut est utilisé. La valeur doit être le nom de type complet, y compris les espaces de noms.
-win32icon i. ico	Icône du fichier .exe pour l’interpréteur de commandes. S’il n’est pas spécifié, l’interpréteur de commandes aura l’icône include par le compilateur c# (le cas échéant).
-initscript p.ps1	Profil de démarrage de l’interpréteur de commandes. Le fichier est inclus « en l’or »; aucune vérification de validité n’est effectuée par make-shell.
-builtinscript s1.ps1 [, s2.ps1,...]	Liste de scripts intégrés pour l’interpréteur de commandes. Ces scripts sont découverts avant les scripts dans le chemin d’accès et leur contenu ne peut pas être modifié une fois l’interpréteur de commandes généré. Les fichiers sont inclus « en l’absence »; aucune vérification de validité n’est effectuée par make-shell.
-ressource resourcefile.txt	Fichier .txt contenant des ressources d’aide et de bannière pour l’interpréteur de commandes. La première ressource est nommée ShellHelp et contient le texte affiché si l’interpréteur de commandes est appelé avec le help paramètre. La deuxième ressource est nommée ShellBanner et contient le texte et les informations de copyright affichés lorsque l’interpréteur de commandes est lancé en mode interactif. Si ce paramètre n’est pas fourni, ou si ces ressources ne sont pas présentes, une aide et une bannière génériques sont utilisées.
-cscflags cscFlags	Indicateurs qui doivent être passés au compilateur C# (csc.exe). Celles-ci sont transmises sans modification. Si ce paramètre comprend des espaces, il doit être placé entre guillemets doubles.
-? -help	Affiche le message de copyright et les options de ligne de commande Make-Shell.
-verbose	Affiche des informations détaillées pendant la création de l’interpréteur de commandes.

Voir aussi

Guide de programmation pour Windows PowerShell

Windows PowerShell SDK