Ajuda do Console do PowerShell.exe

Artigo
10/30/2009

Iniciar o Windows PowerShell a partir da linha de comando de outra ferramenta, como o Cmd.exe.

Sintaxe

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

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

-ExecutionPolicy

Define a diretiva de execução padrão para a sessão. Este parâmetro não altera a diretiva de execução do Windows PowerShell que é definida no Registro.

-File

Executa o script especificado. Digite o caminho do arquivo de script e os parâmetros.

-InputFormat

Descreve o formato de dados enviado ao Windows PowerShell. Valores válidos são "Texto" (cadeias de texto) ou "XML" (formato de CLIXML serializado).

-NoExit

Não sai depois de executar comandos de inicialização.

-NoLogo

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

-NonInteractive

Não apresenta um aviso interativo ao usuário.

-NoProfile

Não carrega o perfil do Windows PowerShell.

-OutputFormat

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

-PSConsoleFile

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

-Sta

Inicia o shell usando um single-threaded apartment.

-Version

Inicia a versão especificada do Windows PowerShell. Insira um número de versão com o parâmetro, por exemplo, "-versão 1.0".

-WindowStyle

Define o estilo de janela como Normal, Minimizado, Maximizado ou Oculto.

-Command

Executa os comandos especificados (e qualquer parâmetro) como se eles tivessem sido digitados no prompt de comando do Windows PowerShell, e então sai, a menos que NoExit seja especificado. O valor de Command pode ser "-", uma cadeia de caracteres ou um bloco de scripts.

Se o valor de Command for "-", o texto de comando será lido pela entrada padrão.

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

Se o valor de Command for uma cadeia de caracteres, Command deve ser o último parâmetro do comando, porque qualquer caractere digitado depois do comando será interpretado como os argumentos do comando.

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

"& {<command>}"

onde as aspas indicam uma cadeia de caracteres e o operador de invocação (&) faz o comando ser executado.

-Help, -?, /?

Mostra esta mensagem. Se você estiver digitando um comando do PowerShell.exe no Windows PowerShell, coloque um hífen (-) antes dos parâmetros de comando, não uma barra (/). Você pode usar hífen ou barra no Cmd.exe.

EXEMPLOS

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

Compartilhar via