about_PowerShell.exe

Aplica-se a: Windows PowerShell 2.0, Windows PowerShell 3.0

TÓPICO

about_PowerShell.exe

DESCRIÇÃO BREVE

Explica como usar a ferramenta de linha de comando PowerShell.exe. Exibe a sintaxe e descreve as opções da linha de comando.

A PowerShell.exe inicia uma sessão do Windows PowerShell®. Você pode usá-la em Cmd.exe e no Windows PowerShell.

DESCRIÇÃO LONGA

SINTAXE

     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 <Comando codificado em base 64>

Aceita uma versão de cadeia de caracteres codificada em base 64 de um comando. Use esse parâmetro para enviar ao Windows PowerShell comandos que exijam aspas complexas ou chaves.

-ExecutionPolicy <Política de execução>

Configura a política de execução padrão para a sessão atual e a salva na variável de ambiente $env:PSExecutionPolicyPreference. Esse parâmetro não altera a política de execução do Windows PowerShell que é configurada no Registro. Para obter informações sobre as políticas de execução do Windows PowerShell, incluindo uma lista de valores válidos, consulte about_Execution_Policies (https://go.microsoft.com/fwlink/?LinkID=135170).

-File <Caminho do arquivo> [<Parâmetros>]

Executa o script especificado no escopo local (iniciado com ponto), para que as funções e variáveis criadas pelo script estejam disponíveis na sessão atual. Digite o caminho do arquivo de script e os parâmetros. O arquivo deve ser o último parâmetro do comando, já que todos os caracteres digitados após o nome do parâmetro File são interpretados como o caminho do arquivo de script seguido pelos parâmetros do script.

Você pode incluir os parâmetros de um script e os valores de parâmetro no valor do parâmetro File. Por exemplo:

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

Normalmente, os parâmetros de opção de um script são incluídos ou omitidos. Por exemplo, o comando a seguir usa o parâmetro All do arquivo de script Get-Script.ps1:

-File .\Get-Script.ps1 -All

Em casos raros, talvez seja necessário fornecer um valor booliano para um parâmetro de opção. Para fornecer um valor booliano para um parâmetro de opção no valor do parâmetro File, coloque o nome do parâmetro e o valor entre chaves, como a seguir:

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

-InputFormat {Text | XML}

Descreve o formato dos dados enviados ao Windows PowerShell. Os valores válidos são "Text" (cadeias de texto) ou "XML" (formato CLIXML serializado).

-Mta

Inicia o Windows PowerShell usando um multi-threaded apartment. Este parâmetro é introduzido no Windows PowerShell 3.0. No Windows PowerShell 2.0, MTA (multi-threaded apartment) é o padrão. No Windows PowerShell 3,0, STA (single-threaded apartment) é o padrão.

-NoExit

Não é encerrado depois de executar comandos de inicialização.

-NoLogo

Oculta a faixa de direitos autorais na inicialização.

-NonInteractive

Não exibe um prompt interativo para o usuário.

-NoProfile

Não carrega o perfil do Windows PowerShell.

-OutputFormat {Text | XML}

Determina como a saída do Windows PowerShell será formatada. Os valores válidos são "Text" (cadeias de texto) ou "XML" (formato CLIXML serializado).

-PSConsoleFile <Caminho do arquivo>

Carrega o arquivo de console do Windows PowerShell especificado. Digite o caminho e o nome do arquivo de console. Para criar um arquivo de console, use o cmdlet Export-Console no Windows PowerShell.

-Sta

Inicia o Windows PowerShell usando um single-threaded apartment. No Windows PowerShell 2.0, MTA (multi-threaded apartment) é o padrão. No Windows PowerShell 3,0, STA (single-threaded apartment) é o padrão.

-Version <Versão do Windows PowerShell>

Inicia a versão especificada do Windows PowerShell. Os valores válidos são 2.0 e 3.0. A versão especificada deve estar instalada no sistema. Se o Windows PowerShell 3.0 estiver instalado no computador, "3.0" será a versão padrão. Caso contrário, "2.0" será a versão padrão. Para obter mais informações, consulte "Como instalar o Windows PowerShell" no Guia de Introdução ao Windows PowerShell.

-WindowStyle <Estilo da janela>

Configura o estilo da janela da sessão. Os valores válidos são Normal, Minimized, Maximized e Hidden.

-Command -param

Executa os comandos especificados (e todos os parâmetros) como se eles tivessem sido digitados no prompt de comando do Windows PowerShell; em seguida, encerra a sessão, a menos que o parâmetro NoExit esteja especificado.

O valor de Command pode ser "-", uma cadeia de caracteres ou um bloco de script. Se o valor de Command for "-", o texto do comando será lido na entrada padrão.

Os blocos de script devem ser colocados entre chaves ({}). Você somente pode especificar um bloco de script ao executar PowerShell.exe no Windows PowerShell. Os resultados do script são retornados ao shell pai como objetos XML desserializados, não como objetos ativos.

Se o valor de Command for uma cadeia de caracteres, ele deve ser o último parâmetro do comando, já que todos os caracteres digitados depois do comando são interpretados como argumentos de comando.

Para gravar uma cadeia de caracteres que executa um comando do Windows PowerShell, use o formato:

         "& {<command>}"

em que as aspas indicam uma cadeia de caracteres e o operador de invocação (&) faz com que o comando seja executado.

-Help, -?, /?

Exibe a ajuda para PowerShell.exe. Se você estiver digitando um comando PowerShell.exe no Windows PowerShell, preceda os parâmetros do comando com um hífen (-), e não uma barra (/). Você pode usar um hífen ou uma barra invertida no Cmd.exe.

COMENTÁRIOS

Observação de solução de problemas: no Windows PowerShell 2.0, iniciar alguns programas no console do Windows PowerShell falhará com um LastExitCode de 0xc0000142.

EXEMPLOS

    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

CONSULTE TAMBÉM

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