Caution
Ne stockez jamais de mots de passe dans le code source !
Consultez ici pour plus de détails.
ps12exe est un module PowerShell qui vous permet de créer des fichiers exécutables à partir de scripts .ps1.
Install-Module ps12exe # Installer le module ps12exe
Set-ps12exeContextMenu # Définir le menu contextuel du clic droit(Vous pouvez également cloner ce référentiel et exécuter directement .\ps12exe.ps1)
La migration de PS2EXE vers ps12exe est-elle difficile ? Pas de problème !
PS2EXE2ps12exe peut relier les appels de PS2EXE à ps12exe. Il vous suffit de désinstaller PS2EXE et d’installer ceci, puis de l’utiliser comme vous le feriez avec PS2EXE.
Uninstall-Module PS2EXE
Install-Module PS2EXE2ps12exeUne fois que vous avez défini Set-ps12exeContextMenu, vous pouvez cliquer avec le bouton droit sur n'importe quel fichier ps1 pour le compiler rapidement en exe ou ouvrir ps12exeGUI pour ce fichier.
ps12exeGUIps12exe .\source.ps1 .\target.exeCompile source.ps1 en target.exe (si .\target.exe est omis, la sortie sera écrite dans .\source.exe).
'"Bonjour le monde !"' | ps12exeCompile "Bonjour le monde !" en un fichier exécutable et le sort dans .\a.exe.
ps12exe https://raw.githubusercontent.com/steve02081504/ps12exe/master/src/GUI/Main.ps1Compile Main.ps1 depuis Internet en un fichier exécutable et le sort dans .\Main.exe.
Start-ps12exeWebServerDémarre un service Web qui permet aux utilisateurs de compiler du code PowerShell en ligne.
ps12exeGUI [[-ConfigFile] '<fichier_de_configuration>'] [-PS1File '<fichier_de_script>'] [-Localize '<code_de_langue>'] [-UIMode 'Dark'|'Light'|'Auto'] [-help]
ps12exeGUI [[-PS1File] '<fichier_de_script>'] [-Localize '<code_de_langue>'] [-UIMode 'Dark'|'Light'|'Auto'] [-help]ConfigFile : Fichier de configuration à charger.
PS1File : Fichier de script à compiler.
Localize : Code de langue à utiliser.
UIMode : Mode de l'interface utilisateur à utiliser.
help : Affiche cette aide.
[input |] ps12exe [[-inputFile] '<nom_de_fichier|url>' | -Content '<script>'] [-outputFile '<nom_de_fichier>']
[-CompilerOptions '<options>'] [-TempDir '<dossier>'] [-minifyer '<scriptblock>'] [-noConsole]
[-architecture 'x86'|'x64'] [-threadingModel 'STA'|'MTA'] [-prepareDebug] [-lcid <lcid>]
[-resourceParams @{iconFile='<nom_de_fichier|url>'; title='<titre>'; description='<description>'; company='<société>';
product='<produit>'; copyright='<copyright>'; trademark='<marque_déposée>'; version='<version>'}]
[-UNICODEEncoding] [-credentialGUI] [-configFile] [-noOutput] [-noError] [-noVisualStyles] [-exitOnCancel]
[-DPIAware] [-winFormsDPIAware] [-requireAdmin] [-supportOS] [-virtualize] [-longPaths] [-targetRuntime '<version_du_runtime>']
[-SkipVersionCheck] [-GuestMode] [-PreprocessOnly] [-Localize '<code_de_langue>'] [-help]input : Chaîne de caractères du contenu du script PowerShell, identique à -Content.
inputFile : Chemin d'accès ou URL du fichier de script PowerShell que vous souhaitez convertir en exécutable (le fichier doit être encodé en UTF8 ou UTF16).
Content : Contenu du script PowerShell que vous souhaitez convertir en exécutable.
outputFile : Nom de fichier ou dossier de l'exécutable cible, par défaut le nom de inputFile avec l'extension '.exe'.
CompilerOptions : Options de compilation supplémentaires (voir https://msdn.microsoft.com/en-us/library/78f4aasd.aspx).
TempDir : Répertoire pour stocker les fichiers temporaires (par défaut un répertoire temporaire aléatoire généré dans %temp%).
minifyer : Bloc de script pour réduire la taille du script avant la compilation.
lcid : ID de localisation du fichier exécutable compilé. Si non spécifié, la culture de l'utilisateur actuel sera utilisée.
prepareDebug : Crée des informations utiles pour le débogage.
architecture : Compile uniquement pour un runtime spécifique. Les valeurs possibles sont 'x64', 'x86' et 'anycpu'.
threadingModel : Mode 'Appartement à un seul thread' ou 'Appartement à plusieurs threads'.
noConsole : Le fichier exécutable généré sera une application Windows Forms sans fenêtre de console.
UNICODEEncoding : Encode la sortie en UNICODE en mode console.
credentialGUI : Utilise une invite GUI pour les informations d'identification en mode console.
resourceParams : Table de hachage contenant les paramètres de ressource du fichier exécutable compilé.
configFile : Écrit un fichier de configuration (<fichier_de_sortie>.exe.config).
noOutput : Le fichier exécutable généré ne produira pas de sortie standard (y compris les flux détaillés et d'informations).
noError : Le fichier exécutable généré ne produira pas de sortie d'erreur (y compris les flux d'avertissement et de débogage).
noVisualStyles : Désactive les styles visuels pour les applications Windows GUI générées (utilisé uniquement avec -noConsole).
exitOnCancel : Quitte le programme lorsqu'Annuler ou 'X' est sélectionné dans la boîte de dialogue Read-Host (utilisé uniquement avec -noConsole).
DPIAware : Les contrôles GUI seront mis à l'échelle autant que possible si le mise à l'échelle de l'affichage est activée.
winFormsDPIAware : WinForms utilisera la mise à l'échelle DPI si la mise à l'échelle de l'affichage est activée (nécessite Windows 10 et .Net 4.7 ou supérieur).
requireAdmin : Si UAC est activé, l'exécutable compilé ne peut s'exécuter que dans un contexte élevé (une boîte de dialogue UAC apparaîtra si nécessaire).
supportOS : Utilise les fonctionnalités de la dernière version de Windows (exécutez [Environment]::OSVersion pour voir la différence).
virtualize : La virtualisation de l'application est activée (force le runtime x86).
longPaths : Active les chemins longs (> 260 caractères) si activé sur l'OS (ne fonctionne qu'avec Windows 10 ou plus récent).
targetRuntime : Version du runtime cible, par défaut 'Framework4.0', prend également en charge 'Framework2.0'.
SkipVersionCheck : Ignore la vérification de la nouvelle version de ps12exe.
GuestMode : Compile le script avec une protection supplémentaire, évite l'accès aux fichiers natifs.
PreprocessOnly : Prétraite le script d'entrée et le retourne sans compilation.
Localize : Spécifie la langue de localisation.
Help : Affiche cette aide.
Contrairement à la plupart des fonctions PowerShell, ps12exe définit la variable $LastExitCode pour indiquer les erreurs, mais ne garantit pas l'absence totale d'exceptions.
Vous pouvez utiliser quelque chose comme ceci pour vérifier si des erreurs se sont produites :
$LastExitCodeBackup = $LastExitCode
try {
'"un peu de code !"' | ps12exe
if ($LastExitCode -ne 0) {
throw "ps12exe a échoué avec le code de sortie $LastExitCode"
}
}
finally {
$LastExitCode = $LastExitCodeBackup
}Les différentes valeurs de $LastExitCode représentent différents types d'erreurs :
| Type d'erreur | Valeur de $LastExitCode |
|---|---|
| 0 | Pas d'erreur |
| 1 | Erreur dans le code d'entrée |
| 2 | Erreur de format d'appel |
| 3 | Erreur interne ps12exe |
ps12exe prétraite le script avant la compilation.
# Lit le cadre de programme à partir du fichier ps12exe.cs
#_if PSEXE # Ce code de prétraitement est utilisé lorsque ce script est compilé par ps12exe
#_include_as_value programFrame "$PSScriptRoot/ps12exe.cs" # Inclut le contenu de ps12exe.cs dans ce script
#_else # Sinon, lit le fichier cs normalement
[string]$programFrame = Get-Content $PSScriptRoot/ps12exe.cs -Raw -Encoding UTF8
#_endif$LocalizeData =
#_if PSScript
. $PSScriptRoot\src\LocaleLoader.ps1
#_else
#_include "$PSScriptRoot/src/locale/en-UK.psd1"
#_endifSeules les conditions suivantes sont prises en charge pour le moment : PSEXE et PSScript.
PSEXE est vrai ; PSScript est faux.
#_include <nom_de_fichier|url>
#_include_as_value <nom_de_valeur> <fichier|url>Inclut le contenu du fichier <nom_de_fichier|url> ou <fichier|url> dans le script. Le contenu du fichier est inséré à la position de la commande #_include/#_include_as_value.
Contrairement à l'instruction #_if, si vous n'entourez pas le nom de fichier avec des guillemets, les commandes de prétraitement #_include considèrent également les espaces de fin et # comme faisant partie du nom de fichier.
#_include $PSScriptRoot/super #nomdefichierbizarre.ps1
#_include "$PSScriptRoot/nomdefichier.ps1" #commentaire sécurisé !Lors de l'utilisation de #_include, le contenu du fichier est prétraité, ce qui vous permet d'inclure plusieurs niveaux de fichiers.
#_include_as_value insère le contenu du fichier dans le script en tant que valeur de chaîne. Le contenu du fichier n'est pas prétraité.
Dans la plupart des cas, vous n'avez pas besoin d'utiliser les commandes de prétraitement #_if et #_include pour que les sous-scripts soient correctement inclus après la conversion du script en exe, ps12exe gérera automatiquement les cas comme ceux qui suivent et considérera que le script cible doit être inclus :
. $PSScriptRoot/un_autre.ps1
& $PSScriptRoot/un_autre.ps1
$result = & "$PSScriptRoot/un_autre.ps1" -args#_include_as_base64 <nom_de_valeur> <fichier|url>
#_include_as_bytes <nom_de_valeur> <fichier|url>Convertit le contenu du fichier en une chaîne base64 ou un tableau d'octets au cours de l'étape de prétraitement et l'insère dans le script. Le contenu du fichier n'est pas prétraité.
Voici un exemple simple de packer :
#_include_as_bytes mesdonnées $PSScriptRoot/données.bin
[System.IO.File]::WriteAllBytes("données.bin", $mesdonnées)L'exe libérera le fichier données.bin qui a été incorporé dans le script lors de la compilation une fois exécuté.
$Script:eshDir =
#_if PSScript #Il ne peut pas y avoir de $EshellUI dans PSEXE
if (Test-Path "$($EshellUI.Sources.Path)/path/esh") { $EshellUI.Sources.Path }
elseif (Test-Path $PSScriptRoot/../path/esh) { "$PSScriptRoot/.." }
elseif
#_else
#_!!if
#_endif
(Test-Path $env:LOCALAPPDATA/esh) { "$env:LOCALAPPDATA/esh" }Toute ligne commençant par #_!! verra son #_!! initial supprimé.
#_require ps12exe
#_pragma Console 0
$Number = [bigint]::Parse('0')
$NextNumber = $Number+1
$NextScript = $PSEXEscript.Replace("Parse('$Number')", "Parse('$NextNumber')")
$NextScript | ps12exe -outputFile $PSScriptRoot/$NextNumber.exe *> $null
$Number#_require compte les modules nécessaires dans l'ensemble du script et ajoute un script équivalent au code suivant avant le premier #_require:
$modules | ForEach-Object{
if(!(Get-Module $_ -ListAvailable -ea SilentlyContinue)) {
Install-Module $_ -Scope CurrentUser -Force -ea Stop
}
}Il convient de noter que le code généré ne fera qu'installer les modules, et non les importer.
Veuillez utiliser Import-Module en conséquence.
Lorsque vous devez requérir plusieurs modules, vous pouvez utiliser des espaces, des virgules ou des points-virgules, des virgules inversées comme séparateurs, et vous n'avez pas besoin d'écrire plusieurs instructions require.
#_require module1 module2;module3、module4,module5Les directives de prétraitement pragma n'ont aucun effet sur le contenu du script, mais modifient les paramètres utilisés pour la compilation.
Voici un exemple :
PS C:\Users\steve02081504> '12' | ps12exe
Fichier compilé écrit -> 1 024 octets
PS C:\Users\steve02081504> ./a.exe
12
PS C:\Users\steve02081504> '#_pragma Console no
>> 12' | ps12exe
Script prétraité -> 23 octets
Fichier compilé écrit -> 2 560 octetsComme vous pouvez le voir, #_pragma Console no fait fonctionner le fichier exe généré en mode fenêtre, même si nous n'avons pas spécifié -noConsole lors de la compilation.
La commande pragma peut définir tous les paramètres de compilation :
#_pragma noConsole # Mode fenêtre
#_pragma Console # Mode console
#_pragma Console no # Mode fenêtre
#_pragma Console true # Mode console
#_pragma icon $PSScriptRoot/icon.ico # Définit l'icône
#_pragma title "title" # Définit le titre de l'exe#_balus <code_de_sortie>
#_balusLorsque le code est exécuté jusqu'à ce point, il quitte le processus avec le code de sortie donné et supprime le fichier exe.
Étant donné que la "compilation" de ps12exe incorpore tout le contenu du script en tant que ressource mot pour mot dans le fichier exécutable généré, si le script contient un grand nombre de chaînes de caractères inutiles, le fichier exécutable généré sera très volumineux.
Vous pouvez utiliser le paramètre -Minifyer pour spécifier un bloc de script qui prétraitera le script avant la compilation afin d'obtenir un fichier exécutable généré plus petit.
Si vous ne savez pas comment écrire un tel bloc de script, vous pouvez utiliser psminnifyer.
& ./ps12exe.ps1 ./main.ps1 -NoConsole -Minifyer { $_ | &./psminnifyer.ps1 }Les commandes d'entrée/sortie de base de ps12exe doivent être réécrites en C#. Celles qui ne sont pas implémentées sont Write-Progress en mode console (trop de travail) et Start-Transcript/Stop-Transcript (Microsoft n'a pas d'implémentation de référence appropriée).
Par défaut, le format de sortie des petites commandes dans PowerShell est une ligne par ligne (en tant que tableaux de chaînes de caractères). Lorsqu'une commande génère 10 lignes de sortie et utilise la sortie GUI, il y aura 10 boîtes de message, chacune attendant d'être confirmée. Pour éviter que cela ne se produise, importez la commande Out-String dans la ligne de commande. Cela convertira la sortie en un tableau de chaînes de caractères de 10 lignes, et toutes les sorties seront affichées dans une seule boîte de message (par exemple : dir C:\| Out-String).
ps12exe peut créer des fichiers de configuration, avec le nom de fichier fichier exécutable généré + ".config". Dans la plupart des cas, ces fichiers de configuration ne sont pas nécessaires, ils sont simplement un manifeste qui vous indique quelle version du .Net Framework doit être utilisée. Comme vous utiliserez généralement le .Net Framework réel, essayez d'exécuter votre fichier exécutable sans utiliser de fichier de configuration.
Les scripts compilés gèrent les paramètres comme le script d'origine. Une des limitations provient de l'environnement Windows : pour tous les exécutables, tous les types de paramètres sont des chaînes de caractères, et si le type de paramètre n'est pas implicitement converti, il doit être explicitement converti dans le script. Vous pouvez même transmettre le contenu par canalisation à un fichier exécutable, mais avec les mêmes limitations (toutes les valeurs transmises par canalisation sont de type chaîne de caractères).
Ne stockez jamais de mots de passe dans les scripts compilés !
L'ensemble du script est facilement visible pour n'importe quel décompilateur .net.
Vous pouvez utiliser $Host.Name pour déterminer si un script est exécuté dans un exe compilé ou dans un script.
if ($Host.Name -eq "PSEXE") { Write-Output "ps12exe" } else { Write-Output "Un autre hôte" }Étant donné que ps12exe convertit les scripts en fichiers exécutables, la valeur de la variable $MyInvocation est différente de celle du script.
Vous pouvez toujours utiliser $PSScriptRoot pour obtenir le chemin d'accès au répertoire où se trouve le fichier exécutable, et utiliser le nouveau $PSEXEpath pour obtenir le chemin d'accès au fichier exécutable lui-même.
Lorsque vous ouvrez une fenêtre externe dans un script qui utilise le mode -noConsole (par exemple Get-Credential ou des commandes nécessitant cmd.exe), une fenêtre s'ouvrira en arrière-plan.
La raison en est que lorsque vous fermez une fenêtre externe, Windows essaie d'activer la fenêtre parente. Étant donné qu'il n'y a pas de fenêtre pour le script compilé, cela activera la fenêtre parente du script compilé, généralement l'explorateur ou la fenêtre Powershell.
Pour résoudre ce problème, vous pouvez utiliser $Host.UI.RawUI.FlushInputBuffer() pour ouvrir une fenêtre invisible qui peut être activée. L'appel suivant à $Host.UI.RawUI.FlushInputBuffer() fermera cette fenêtre (et ainsi de suite).
L'exemple suivant n'ouvrira plus la fenêtre en arrière-plan, contrairement au fait d'appeler ipconfig | Out-String une seule fois :
$Host.UI.RawUI.FlushInputBuffer()
ipconfig | Out-String
$Host.UI.RawUI.FlushInputBuffer()| Comparaison | ps12exe | MScholtes/PS2EXE@678a892 |
|---|---|---|
| Référentiel de script pur 📦 | ✔️ Tous les fichiers sont des fichiers texte sauf les images et les dépendances | ❌ Contient des fichiers exe avec des licences open source |
| Commande requise pour générer hello world 🌍 | 😎'"Bonjour le monde !"' | ps12exe |
🤔echo "Bonjour le monde !" *> a.ps1; PS2EXE a.ps1; rm a.ps1 |
| Taille du fichier exécutable hello world généré 💾 | 🥰1 024 octets | 😨25 088 octets |
| Prise en charge multilingue de l'interface graphique 🌐 | ✔️ | ❌ |
| Vérification de la syntaxe lors de la compilation ✔️ | ✔️ | ❌ |
| Fonction de prétraitement 🔄 | ✔️ | ❌ |
Analyse des paramètres spéciaux tels que -extract 🧹 |
🗑️ Supprimé | 🥲 Nécessite la modification du code source |
| Degré d'accueil des PR 🤝 | 🥰 Bienvenue ! | 🤷 14 PR dont 13 fermées |
Par rapport à MScholtes/PS2EXE@678a892, ce projet apporte les améliorations suivantes :
| Amélioration | Description |
|---|---|
| ✔️ Vérification de la syntaxe lors de la compilation | Effectue la vérification de la syntaxe lors de la compilation pour améliorer la qualité du code |
| 🔄 Puissantes fonctions de prétraitement | Prétraite les scripts avant la compilation, plus besoin de copier-coller tout le contenu dans le script |
🛠️ Paramètre -CompilerOptions |
Ajout d'un nouveau paramètre qui vous permet de personnaliser davantage le fichier exécutable généré |
📦️ Paramètre -Minifyer |
Prétraite les scripts avant la compilation afin de générer des fichiers exécutables plus petits |
| 🌐 Prise en charge de la compilation de scripts et de l'inclusion de fichiers depuis des URL | Prise en charge du téléchargement d'icônes depuis une URL |
🖥️ Optimisation du paramètre -noConsole |
Optimisation du traitement des options et de l'affichage du titre de la fenêtre, vous pouvez maintenant définir le titre des fenêtres popup personnalisées |
| 🧹 Suppression du fichier exe | Suppression des fichiers exe du référentiel de code |
| 🌍 Prise en charge multilingue, interface graphique en pur script | Meilleure prise en charge multilingue, interface graphique en pur script, prise en charge du mode sombre |
| 📖 Séparation du fichier cs du fichier ps1 | Plus facile à lire et à entretenir |
| 🚀 Plus d'améliorations | Et bien plus encore... |