about_PowerShell.exe

Se aplica a: Windows PowerShell 2.0, Windows PowerShell 3.0

TEMA

about_PowerShell.exe

DESCRIPCIÓN BREVE

Explica cómo utilizar la herramienta de línea de comandos de PowerShell.exe. Muestra la sintaxis y describe los modificadores de línea de comandos.

PowerShell.exe inicia una sesión de Windows PowerShell®. Puede usarla en Cmd.exe y en Windows PowerShell.

DESCRIPCIÓN LARGA

SINTAXIS

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

PARÁMETROS

-EncodedCommand <ComandoCodificadoenBase64>

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

-ExecutionPolicy <DirectivadeEjecución>

Establece la directiva de ejecución predeterminada de la sesión actual y la guarda en la variable de entorno $env:PSExecutionPolicyPreference. Este parámetro no modifica la directiva de ejecución de Windows PowerShell que se establece en el registro. Para obtener información sobre las directivas de ejecución de Windows PowerShell, incluida una lista de valores válidos, vea about_Execution_Policies (https://go.microsoft.com/fwlink/?LinkID=135170).

-File <RutadeArchivo> [<Parámetros>]

Ejecuta el script especificado en el ámbito local ("mediante el operador punto"), de forma que las funciones y variables que crea el script estén disponibles en la sesión actual. Escriba la ruta de acceso del archivo de script y los parámetros. El archivo debe ser el último parámetro del comando, dado que todos los caracteres escritos después del nombre del parámetro File se interpretan como la ruta de acceso del archivo de script seguida de los parámetros del script.

Puede incluir los parámetros de un script y los valores de los parámetros en el valor del parámetro File. Por ejemplo:

-File .\Get-Script.ps1 -Domain Central

Normalmente, los parámetros de modificador de un script se incluyen o se omiten. Por ejemplo, el siguiente comando utiliza el parámetro All del archivo de script Get-Script.ps1:

-File .\Get-Script.ps1 -All

En contadas ocasiones deberá proporcionar un valor booleano para un parámetro de modificador. Para proporcionar un valor booleano para un parámetro de modificador en el valor del parámetro File, incluya el nombre y el valor del parámetro entre llaves, como se muestra a continuación:

-File .\Get-Script.ps1 {-All:$False}.

-InputFormat {Text | XML}

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

-Mta

Inicia Windows PowerShell con un contenedor multiproceso. Este parámetro se incorporó en Windows PowerShell 3.0. En Windows PowerShell 2.0, el contenedor multiproceso (MTA) es el valor predeterminado. En Windows PowerShell 3,0, el contenedor uniproceso (MTA) es el valor predeterminado.

-NoExit

No se cierra después de ejecutar comandos de inicio.

-NoLogo

Oculta la pancarta 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 {Text | XML}

Determina cómo se da formato a los resultados de Windows PowerShell. Los valores válidos son "Text" (cadenas de texto) o "XML" (formato CLIXML serializado).

-PSConsoleFile <RutadeArchivo>

Carga el archivo de consola de Windows PowerShell especificado. Escriba la ruta de acceso y el nombre del archivo de consola. Para crear un archivo de consola, utilice el cmdlet Export-Console en Windows PowerShell.

-Sta

Inicia Windows PowerShell con un contenedor uniproceso. En Windows PowerShell 2.0, el contenedor multiproceso (MTA) es el valor predeterminado. En Windows PowerShell 3,0, el contenedor uniproceso (MTA) es el valor predeterminado.

-Version <Versión de Windows PowerShell>

Inicia la versión especificada de Windows PowerShell. Los valores válidos son 2.0 y 3.0. La versión que especifique debe estar instalada en el sistema. Si Windows PowerShell 3.0 está instalado en el equipo, "3.0" es la versión predeterminada. De lo contrario, "2.0" será la versión predeterminada. Para más información, vea "Instalación de Windows PowerShell" en la Guía de introducción de Windows PowerShell.

-WindowStyle <Estilo de ventana>

Establece el estilo de ventana de la sesión. Los valores válidos son Normal, Minimized, Maximized y Hidden.

-Command -param

Ejecuta los comandos (y parámetros) especificados como si se hubieran escrito en el símbolo del sistema de Windows PowerShell y después se cierra, a menos que se especifique el parámetro 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 la entrada estándar.

Los bloques de scripts deben especificarse entre llaves ({}). Solo puede especificar un bloque de script si ejecuta PowerShell.exe en Windows PowerShell. Los resultados del script se devuelven al shell principal como objetos XML deserializados, no como objetos activos.

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

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

         "& {<command>}"

donde las comillas indican una cadena y el operador de invocación (&) hace que el comando se ejecute.

-Help, -?, /?

Muestra la ayuda de PowerShell.exe. Si está escribiendo un comando PowerShell.exe en Windows PowerShell, incluya delante de los parámetros del comando un guión (-) y no una barra diagonal (/). Puede utilizar un guión o una barra diagonal en Cmd.exe.

COMENTARIOS

Nota para la solución de problemas: En Windows PowerShell 2.0, al iniciar algunos programas desde la consola de Windows PowerShell se produce un error con un valor de LastExitCode de 0xc0000142.

EJEMPLOS

    PowerShell -PSConsoleFile sqlsnapin.psc1

    PowerShell -Version 2.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

VEA TAMBIÉN

about_PowerShell_Ise.exe (https://go.microsoft.com/fwlink/?LinkID=256512)