Ayuda de consola PowerShell.exe

Inicia Windows PowerShell desde la línea de comandos de otra herramienta, como por ejemplo Cmd.exe.

Sintaxis

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 | -? | /?

Parámetros

-EncodedCommand

Acepta una versión de cadena codificada en base 64 de un comando. Utilice este parámetro para enviar comandos a Windows PowerShell que requieren comillas o llaves complejas.

-ExecutionPolicy

Establece la directiva de ejecución predeterminada para la sesión. Este parámetro no cambia la directiva de ejecución de Windows PowerShell que se establece en el Registro.

-File

Ejecuta el script especificado. Escriba la ruta de acceso de script y los parámetros que corresponda.

-InputFormat

Describe el formato de los datos enviados a Windows PowerShell. Los valores válidos son "Text" (cadenas de texto) o "XML (formato CLIXML serializado).

-NoExit

No finaliza después de ejecutarse los comandos de inicio.

-NoLogo

Oculta el símbolo de copyright en el inicio.

-NonInteractive

No presenta un símbolo del sistema interactivo al usuario.

-NoProfile

No carga el perfil de Windows PowerShell.

-OutputFormat

Determina el formato de los resultados de Windows PowerShell. Los valores válidos son "Text" (cadenas de texto) o "XML (formato CLIXML serializado).

-PSConsoleFile

Carga el archivo de consola de Windows PowerShell especificado. Para crear un archivo de consola, use el cmdlet Export-Console de Windows PowerShell.

-Sta

Inicia el shell mediante el uso de un contenedor uniproceso.

-Version

Inicia la versión especificada de Windows PowerShell. Escriba un número de versión con el parámetro, como "-version 1.0".

-WindowStyle

Establece el estilo de ventana en Normal, Minimized, Maximized o Hidden.

-Command

Ejecuta los comandos especificados (y los parámetros) como si se escribieran en el símbolo del sistema de Windows PowerShell y, a continuación, finaliza la ejecución, a menos que se especifique NoExit. El valor de Command puede ser "-", una cadena o un bloque de script.

Si el valor de Command es "-", el texto del comando se lee de los datos de entrada estándar.

Los bloques de script se deben incluir entre llaves ({}). Puede especificar un bloque de script sólo al ejecutar PowerShell.exe en Windows PowerShell. Los resultados del script se devuelven al shell primario como objetos XML deserializados, no como objetos dinámicos.

Si el valor de Command es una cadena, Command debe ser el último parámetro en el comando, porque los caracteres escritos después del comando se interpretan como argumentos del mismo.

Para escribir una cadena que ejecute un comando de Windows PowerShell, utilice el formato:

"& {<command>}"

donde las comillas indican una cadena y el operador de llamada (&) produce la ejecución del comando.

-Help, -?, /?

Muestra este mensaje. Si está escribiendo un comando de PowerShell.exe en Windows PowerShell, anteponga un guión (-) a los parámetros, no una barra diagonal (/). Puede utilizar un guión o una barra diagonal en Cmd.exe.

EJEMPLOS

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