Start-Process

Inicia um ou mais processos no computador local.

Sintaxe

Start-Process [-FilePath] <string> [[-ArgumentList] <string[]>] [-Credential <PSCredential>] [-LoadUserProfile] [-NoNewWindow] [-PassThru] [-RedirectStandardError <string>] [-RedirectStandardInput <string>] [-RedirectStandardOutput <string>] [-UseNewEnvironment] [-Aguardar] [-WorkingDirectory <string>] [<CommonParameters>]

Start-Process [-FilePath] <string> [[-ArgumentList] <string[]>] [-PassThru] [-Verb <string>] [-Aguardar] [-WindowStyle {<Normal> | <Hidden> | <Minimized> | <Maximized>}] [-WorkingDirectory <string>] [<CommonParameters>]

Descrição

Inicia um ou mais processos no computador local. Para especificar o programa executado no processo, insira um arquivo executável ou um arquivo de script, ou um arquivo que possa ser aberto usando um programa no computador. Se você especificar um arquivo não executável, Start-Process iniciará o programa associado ao arquivo, assim como o cmdlet Invoke-Item.

Você pode usar os parâmetros de Start-Process para especificar opções, como carregar o perfil de um usuário, iniciar o processo em uma nova janela ou usar credenciais alternativas.

Parâmetros

-ArgumentList <string[]>

Especifica parâmetros ou valores de parâmetros para serem usados quando o processo é iniciado. O nome do parâmetro (“Arguments”) é opcional.

Necessário?	false
Posição?	2
Valor padrão	Nenhum
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Credential <PSCredential>

Especifica uma conta de usuário com permissão para executar essa ação. Digite um nome de usuário, como "User01" ou "Domain01\User01" ou insira um objeto PSCredential, como aquele do cmdlet Get-Credential. Por padrão, o cmdlet usa as credenciais do usuário atual.

Necessário?	false
Posição?	named
Valor padrão	Usuário atual.
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-FilePath <string>

Especifica o caminho (opcional) e o nome do arquivo do programa que é executado no processo. Insira o nome de um arquivo executável ou de um documento, como um arquivo .txt ou .doc, que esteja associado a um programa no computador. Esse parâmetro é obrigatório.

Se você especificar apenas o nome do arquivo, use o parâmetro WorkingDirectory para especificar o caminho.

Necessário?	true
Posição?	1
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-LoadUserProfile

Carrega o perfil do usuário do Windows armazenado na chave do Registro HKEY_USERS para o usuário atual. O valor padrão é FALSE.

Esse parâmetro não afeta os perfis do Windows PowerShell. (Consulte about_Profiles.)

Necessário?	false
Posição?	named
Valor padrão	False
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-NoNewWindow

Impede que o processo seja executado em uma nova janela. Por padrão, o processo é executado em uma nova janela.

Necessário?	false
Posição?	named
Valor padrão	False
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-PassThru

Retorna um objeto de processo para cada processo iniciado pelo cmdlet. Por padrão, este cmdlet não gera nenhuma saída.

Necessário?	false
Posição?	named
Valor padrão	False
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-RedirectStandardError <string>

Envia todos os erros gerados pelo processo para um arquivo especificado por você. Insira o caminho e o nome do arquivo. Por padrão, os erros são exibidos no console.

Necessário?	false
Posição?	named
Valor padrão	Os erros são exibidos no console
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-RedirectStandardInput <string>

Lê as entradas do arquivo especificado. Insira o caminho e o nome do arquivo de entrada. Por padrão, o processo obtém as entradas do teclado.

Necessário?	false
Posição?	named
Valor padrão	Teclado
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-RedirectStandardOutput <string>

Envia as saídas geradas pelo processo para um arquivo especificado por você. Insira o caminho e o nome do arquivo. Por padrão, a saída é exibida no console.

Necessário?	false
Posição?	named
Valor padrão	FALSE
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-UseNewEnvironment

Usa novas variáveis de ambiente especificadas para o processo. Por padrão, o processo iniciado é executado com as variáveis de ambiente especificadas para o computador e o usuário.

Necessário?	false
Posição?	named
Valor padrão	False
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Verb <string>

Especifica um verbo para ser usado quando o processo está sendo iniciado, como Edit, Open ou Print.

Cada tipo de arquivo tem um conjunto de verbos que você pode usar. Para localizar os verbos que podem ser usados com o processo, use a propriedade Verbs do objeto.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Aguardar

Aguarda a conclusão do processo especificado antes de aceitar mais entradas. Este parâmetro suprime o prompt de comando ou retém a janela até que o processo seja concluído.

Necessário?	false
Posição?	named
Valor padrão	False
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-WindowStyle <ProcessWindowStyle>

Especifica o estado das janelas usadas para o processo. Os valores válidos são Normal, Hidden, Minimized e Maximized. O valor padrão é Normal.

Necessário?	false
Posição?	named
Valor padrão	Normal
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-WorkingDirectory <string>

Especifica o local do arquivo executável ou documento que executa o processo. O padrão é o diretório atual.

Necessário?	false
Posição?	named
Valor padrão	Diretório atual
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas	Nenhum Não é possível enviar a entrada para Start-Process.
Saídas	Nenhum ou System.Diagnostics.Process Quando você usa o parâmetro PassThru, Start-Process gera um System.Diagnostics.Process. Caso contrário, este cmdlet não retorna nenhuma saída.

Observações

Este cmdlet é implementado usando o método Start da classe System Diagnostics,Process. Para obter mais informações sobre esse método, consulte "Process.Start Method" na biblioteca do MSDN (Microsoft Developer Network) em (o site pode estar em inglês).

Exemplo 1

C:\PS>start-process sort.exe

Descrição
-----------
Esse comando inicia um processo que usa o arquivo Sort.exe no diretório atual. O comando usa todos os valores padrões, incluindo o estilo de janela padrão, o diretório de trabalho e as credenciais.

Exemplo 2

C:\PS>start-process myfile.txt -workingdirectory "C:\PS-Test" -verb Print

Descrição
-----------
Esse comando inicia um processo que imprime o arquivo C:\PS-Test\MyFile.txt.

Exemplo 3

C:\PS>start-process Sort.exe -RedirectStandardInput Testsort.txt -RedirectStandardOutput Sorted.txt -RedirectStandardError SortError.txt -UseNewEnvironment

Descrição
-----------
Esse comando inicia um processo que classifica itens no arquivo Testsort.txt e retorna os itens classificados no arquivo Sorted.txt. Os erros são gravados no arquivo SortError.txt. 

O parâmetro UseNewEnvironment especifica que o processo é executado com suas próprias variáveis de ambiente.

Exemplo 4

C:\PS>start-process notepad -wait -windowstyle Maximized

Descrição
-----------
Esse comando inicia o processo do Bloco de Notas. Ele maximiza e retém a janela até que o processo seja concluído.

Consulte também

Conceitos

Start-Service
Get-Process
Stop-Process
Wait-Process
Debug-Process