Aide de la console PowerShell.exe

Article
01/13/2010

Démarre Windows PowerShell à partir de la ligne de commande d'un autre outil, tel que Cmd.exe.

Syntaxe

PowerShell[.exe]
       [-PSConsoleFile <file> | -Version <version>]
       [-EncodedCommand <Base64EncodedCommand>]
       [-ExecutionPolicy <ExecutionPolicy>]
       [-File <filePath> <args>]
       [-InputFormat {Text | XML}] 
       [-NoExit]
       [-NoLogo]
       [-NonInteractive] 
       [-NoProfile] 
       [-OutputFormat {Text | XML}] 
       [-Sta]
       [-WindowStyle <style>]
       [-Command { - | <script-block> [-args <arg-array>]
                     | <string> [<CommandParameters>] } ]

PowerShell[.exe] -Help | -? | /?

Paramètres

-EncodedCommand

Accepte une version chaîne encodée en base 64 d'une commande. Utilisez ce paramètre pour envoyer à Windows PowerShell des commandes qui nécessitent des guillemets ou des accolades complexes.

-ExecutionPolicy

Définit la stratégie d'exécution par défaut pour la session. Ce paramètre ne modifie pas la stratégie d'exécution Windows PowerShell qui est définie dans le Registre.

-File

Exécute le script spécifié. Entrez le chemin d'accès et les paramètres d'un fichier script.

-InputFormat

Décrit le format des données envoyées à Windows PowerShell. Les valeurs valides sont « Texte » (chaînes de texte) ou « XML » (format CLIXML sérialisé).

-NoExit

Ne quitte pas après l'exécution des commandes de démarrage.

-NoLogo

Masque la bannière de copyright au démarrage.

-NonInteractive

Ne présente aucune invite interactive à l'utilisateur.

-NoProfile

Ne charge pas le profil Windows PowerShell.

-OutputFormat

Détermine la mise en forme de la sortie de Windows PowerShell. Les valeurs valides sont « Texte » (chaînes de texte) ou « XML » (format CLIXML sérialisé).

-PSConsoleFile

Charge le fichier console Windows PowerShell spécifié. Pour créer un fichier console, utilisez l'applet de commande Export-Console dans Windows PowerShell.

-Sta

Démarre l'interpréteur de commandes à l'aide d'un thread unique cloisonné.

-Version

Démarre la version spécifiée de Windows PowerShell. Entrez un numéro de version avec ce paramètre, tel que « -version 1.0 ».

-WindowStyle

Définit le style de fenêtre sur Normale, Réduite, Agrandie ou Masquée.

-Command

Exécute les commandes spécifiées (ainsi que tous les paramètres) comme si vous les tapiez à l'invite de commandes Windows PowerShell, puis quitte, sauf si le paramètre NoExit est spécifié. La valeur du paramètre Command peut être « - », une chaîne ou un bloc de script.

Si la valeur de Command est « - », le texte de la commande est lu à partir de l'entrée standard.

Les blocs de script doivent être indiqués entre accolades ({}). Vous ne pouvez spécifier un bloc de script que lorsque vous exécutez PowerShell.exe dans Windows PowerShell. Les résultats du script sont retournés à l'interpréteur de commandes parent sous forme d'objets XML désérialisés, et non en tant qu'objets directs.

Si la valeur de Command est une chaîne, Command doit être le dernier paramètre de la commande, car tous les caractères tapés après la commande sont interprétés comme des arguments de commande.

Pour écrire une chaîne qui exécute une commande Windows PowerShell, utilisez le format suivant :

"& {<command>}"

où les guillemets indiquent une chaîne et l'opérateur d'appel (&) provoque l'exécution de la commande.

-Help, -?, /?

Affiche ce message. Si vous tapez une commande PowerShell.exe dans Windows PowerShell, faites précéder les paramètres de commande d'un trait d'union (-), et non d'une barre oblique (/). Dans Cmd.exe, vous pouvez utiliser un trait d'union ou une barre oblique.

EXEMPLES

PowerShell -PSConsoleFile sqlsnapin.psc1

PowerShell -version 1.0 -NoLogo -InputFormat text -OutputFormat XML

PowerShell -Command {Get-EventLog -LogName security}

PowerShell -Command "& {Get-EventLog -LogName security}"

# To use the -EncodedCommand parameter:
$command = "dir 'c:\program files' "
$bytes = [System.Text.Encoding]::Unicode.GetBytes($command)
$encodedCommand = [Convert]::ToBase64String($bytes)
powershell.exe -encodedCommand $encodedCommand

Partager via