Start-Process

Sintaxe

Default (Predefinição)

Start-Process
    [-FilePath] <String>
    [[-ArgumentList] <String[]>]
    [-Credential <PSCredential>]
    [-WorkingDirectory <String>]
    [-LoadUserProfile]
    [-NoNewWindow]
    [-PassThru]
    [-RedirectStandardError <String>]
    [-RedirectStandardInput <String>]
    [-RedirectStandardOutput <String>]
    [-WindowStyle <ProcessWindowStyle>]
    [-Wait]
    [-UseNewEnvironment]
    [<CommonParameters>]

UseShellExecute

Start-Process
    [-FilePath] <String>
    [[-ArgumentList] <String[]>]
    [-WorkingDirectory <String>]
    [-PassThru]
    [-Verb <String>]
    [-WindowStyle <ProcessWindowStyle>]
    [-Wait]
    [<CommonParameters>]

Description

Exemplos

Exemplo 1: Iniciar um processo que usa valores padrão

Start-Process -FilePath "sort.exe"

Exemplo 2: Imprimir um ficheiro de texto

Start-Process -FilePath "myfile.txt" -WorkingDirectory "C:\PS-Test" -Verb Print

Exemplo 3: Iniciar um processo para classificar itens em um novo arquivo

Start-Process -FilePath "Sort.exe" -RedirectStandardInput "Testsort.txt" -RedirectStandardOutput "Sorted.txt" -RedirectStandardError "SortError.txt" -UseNewEnvironment

Exemplo 4: Iniciar um processo em uma janela maximizada

Start-Process -FilePath "notepad" -Wait -WindowStyle Maximized

Exemplo 5: Iniciar o PowerShell como administrador

Start-Process -FilePath "powershell" -Verb RunAs

Exemplo 6: Usando verbos diferentes para iniciar um processo

$startExe = New-Object System.Diagnostics.ProcessStartInfo -Args PowerShell.exe
$startExe.verbs

open
runas

Exemplo 7: Especificando argumentos para o processo

Start-Process -FilePath "$env:comspec" -ArgumentList "/c dir `"%systemdrive%\program files`""
Start-Process -FilePath "$env:comspec" -ArgumentList "/c","dir","`"%systemdrive%\program files`""

Parâmetros

-ArgumentList

Especifica parâmetros ou valores de parâmetros a serem usados quando esse cmdlet inicia o processo. Se os parâmetros ou valores de parâmetros contiverem um espaço, eles precisarão ser cercados por aspas duplas com escape.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Credential

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-FilePath

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

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-LoadUserProfile

Indica que esse cmdlet carrega o perfil de usuário do Windows armazenado na chave do Registro HKEY_USERS para o usuário atual.

Esse parâmetro não afeta os perfis do PowerShell. Para obter mais informações, consulte about_Profiles.

Propriedades dos parâmetros

Conjuntos de parâmetros

-NoNewWindow

Inicie o novo processo na janela do console atual. Por padrão, o PowerShell abre uma nova janela.

Não é possível usar os parâmetros NoNewWindow e WindowStyle no mesmo comando.

Propriedades dos parâmetros

Conjuntos de parâmetros

-PassThru

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-RedirectStandardError

Especifica um arquivo. Este cmdlet envia todos os erros gerados pelo processo para um arquivo que você especificar. Insira o caminho e o nome do arquivo. Por padrão, os erros são exibidos no console.

Propriedades dos parâmetros

Conjuntos de parâmetros

-RedirectStandardInput

Especifica um arquivo. Este cmdlet lê a entrada do arquivo especificado. Insira o caminho e o nome do arquivo de entrada. Por padrão, o processo recebe sua entrada do teclado.

Propriedades dos parâmetros

Conjuntos de parâmetros

-RedirectStandardOutput

Especifica um arquivo. Este cmdlet envia a saída gerada pelo processo para um arquivo que você especificar. Insira o caminho e o nome do arquivo. Por padrão, a saída é exibida no console.

Propriedades dos parâmetros

Conjuntos de parâmetros

-UseNewEnvironment

Indica que esse cmdlet 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.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Verb

Especifica um verbo a ser usado quando esse cmdlet iniciar o processo. Os verbos disponíveis são determinados pela extensão do nome do arquivo que é executado no processo.

A tabela a seguir mostra os verbos para alguns tipos de arquivo de processo comuns.

Para localizar os verbos que podem ser usados com o arquivo que é executado em um processo, use o cmdlet para criar um objeto System.Diagnostics.ProcessStartInfo para o arquivo. Os verbos disponíveis estão na propriedade Verbs do objeto ProcessStartInfo. Para mais detalhes, consulte os exemplos.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Wait

Indica que esse cmdlet aguarda a conclusão do processo especificado e de seus descendentes antes de aceitar mais entradas. Este parâmetro suprime o prompt de comando ou retém a janela até que os processos sejam concluídos.

Propriedades dos parâmetros

Conjuntos de parâmetros

-WindowStyle

Especifica o estado da janela que é usada para o novo processo. Os valores aceitáveis para este parâmetro são: Normal, oculto, minimizado e maximizado. O valor padrão é Normal.

Não é possível usar o WindowStyle e parâmetros NoNewWindow no mesmo comando.

Propriedades dos parâmetros

Conjuntos de parâmetros

-WorkingDirectory

Especifica o local do arquivo executável ou documento que é executado no processo. O padrão é a pasta para o novo processo.

Propriedades dos parâmetros

Conjuntos de parâmetros

CommonParameters

Entradas

None

Saídas

None, System.Diagnostics.Process

Notas

Ligações Relacionadas

• Debug-Process
• Get-Process
• Start-Service
• Parar Processo
• Wait-Process