Compartilhar via


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