Start-Process

Sintaxe

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

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

Description

O cmdlet Start-Process inicia um ou mais processos no computador local. Para especificar o programa que é executado no processo, insira um arquivo executável ou 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, semelhante ao cmdlet Invoke-Item.

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

Exemplos

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

Este exemplo inicia um processo que usa o arquivo Sort.exe na pasta atual. O comando usa todos os valores padrão, incluindo o estilo de janela padrão, a pasta de trabalho e as credenciais.

Start-Process -FilePath "sort.exe"

Exemplo 2: Imprimir um ficheiro de texto

Este exemplo inicia um processo que imprime o arquivo C:\PS-Test\MyFile.txt.

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

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

Este exemplo inicia um processo que classifica os itens no arquivo Testsort.txt e retorna os itens classificados nos arquivos Sorted.txt. Quaisquer erros são gravados no arquivo SortError.txt.

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

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

Exemplo 4: Iniciar um processo em uma janela maximizada

Este exemplo inicia o processo de Notepad.exe. Ele maximiza a janela e retém a janela até que o processo seja concluído.

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

Exemplo 5: Iniciar o PowerShell como administrador

Este exemplo inicia o PowerShell usando a opção "Executar como administrador".

Start-Process -FilePath "powershell" -Verb RunAs

Exemplo 6: Usando verbos diferentes para iniciar um processo

Este exemplo mostra como encontrar os verbos que podem ser usados ao iniciar um processo. Os verbos disponíveis são determinados pela extensão do nome do arquivo que é executado no processo.

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

open
runas

O exemplo usa para criar um objeto System.Diagnostics.ProcessStartInfo para PowerShell.exe, o arquivo que é executado no processo do PowerShell. A propriedade Verbs do objeto ProcessStartInfo mostra que você pode usar os verbos Open e RunAs com PowerShell.exeou com qualquer processo que execute um arquivo .exe.

Exemplo 7: Especificando argumentos para o processo

Ambos os comandos iniciam o interpretador de comandos do Windows, emitindo um comando dir na pasta 'Arquivos de Programas'. Como esse nome de pasta contém um espaço, o valor precisa ser cercado por aspas com escape. Observe que o primeiro comando especifica uma cadeia de caracteres como ArgumentList. O segundo comando, uma matriz de cadeia de caracteres.

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

-Credential

-FilePath

-LoadUserProfile

-NoNewWindow

-PassThru

-RedirectStandardError

-RedirectStandardInput

-RedirectStandardOutput

-UseNewEnvironment

-Verb

-Wait

-WindowStyle

-WorkingDirectory

Entradas

None

Não é possível canalizar a entrada para este cmdlet.

Saídas

None, System.Diagnostics.Process

Este cmdlet gera um objeto System.Diagnostics.Process , se você especificar o parâmetro PassThru. Caso contrário, esse cmdlet não retornará nenhuma saída.

Notas

• Este cmdlet é implementado usando o método Start da classe System.Diagnostics.Process do . Para obter mais informações sobre esse método, consulte Método Process.Start.

Ligações Relacionadas

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