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]
     [-Environment <hashtable>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-Process
     [-FilePath] <string>
     [[-ArgumentList] <string[]>]
     [-WorkingDirectory <string>]
     [-PassThru]
     [-Verb <string>]
     [-WindowStyle <ProcessWindowStyle>]
     [-Wait]
     [-Environment <hashtable>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

O Start-Process cmdlet inicia um ou mais processos no computador local. Por padrão, Start-Process cria um novo processo que herda todas as variáveis de ambiente definidas no processo atual.

Para especificar o programa que é executado no processo, insira um arquivo executável ou 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, semelhante ao Invoke-Item cmdlet.

Você pode usar os parâmetros de para especificar opções, como carregar um perfil de Start-Process 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 Sort.exe arquivo 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 arquivo de texto

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

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 itens no TestSort.txt arquivo e retorna os itens classificados nos Sorted.txt arquivos. Todos os erros são gravados no SortError.txt arquivo. O parâmetro UseNewEnvironment especifica que o processo é executado com suas próprias variáveis de ambiente.

$processOptions = @{
    FilePath = "sort.exe"
    RedirectStandardInput = "TestSort.txt"
    RedirectStandardOutput = "Sorted.txt"
    RedirectStandardError = "SortError.txt"
    UseNewEnvironment = $true
}
Start-Process @processOptions

Este exemplo usa splatting para passar parâmetros para o cmdlet. Para obter mais informações, consulte about_Splatting.

Exemplo 4: Iniciar um processo em uma janela maximizada

Este exemplo inicia o Notepad.exe processo. Ele maximiza a janela e manté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
runasuser

O exemplo usa New-Object 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.exe, ou com qualquer processo que execute um .exe arquivo.

Exemplo 7: Especificando argumentos para o processo

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

Start-Process -FilePath "$env:comspec" -ArgumentList "/c dir `"%SystemDrive%\Program Files`""
Start-Process -FilePath "$env:comspec" -ArgumentList "/c","dir","`"%SystemDrive%\Program Files`""

Exemplo 8: Criar um processo desanexado no Linux

No Windows, Start-Process cria um processo independente que permanece em execução independentemente do shell de inicialização. Em plataformas não Windows, o processo recém-iniciado é anexado ao shell iniciado. Se o shell de inicialização for fechado, o processo filho será encerrado.

Para evitar o encerramento do processo filho em plataformas do tipo Unix, você pode combinar Start-Process com nohupo . O exemplo a seguir inicia uma instância em segundo plano do PowerShell no Linux que permanece ativa mesmo depois que você fecha a sessão de inicialização. O nohup comando coleta a saída no arquivo nohup.out no diretório atual.

# Runs for 2 minutes and appends output to ./nohup.out
Start-Process nohup 'pwsh -noprofile -c "1..120 | % { Write-Host . -NoNewline; sleep 1 }"'

Neste exemplo, Start-Process está executando o comando Linux nohup , que é iniciado pwsh como um processo desanexado. Para mais informações, consulte o artigo nohup na Wikipedia.

Exemplo 9: Substituindo uma variável de ambiente para um processo

Por padrão, quando você usa Start-Processo , o novo processo é criado com as mesmas variáveis de ambiente da sessão atual. Você pode usar o parâmetro Environment para substituir os valores dessas variáveis.

Neste exemplo, a variável FOO de ambiente é adicionada à sessão com foo como o valor.

O exemplo é executado Start-Process três vezes, retornando o valor de FOO cada vez. O primeiro comando não substitui a variável de ambiente. No segundo comando, FOO é definido como bar. No terceiro comando, FOO é definido como $null, o que o remove.

$env:FOO = 'foo'
Start-Process pwsh -NoNewWindow -ArgumentList '-c', '$env:FOO'
Start-Process pwsh -NoNewWindow -ArgumentList '-c', '$env:FOO' -Environment @{
    FOO  = 'bar'
}
Start-Process pwsh -NoNewWindow -ArgumentList '-c', '$env:FOO' -Environment @{
    FOO  = $null
}

foo
bar

Parâmetros

-ArgumentList

-Confirm

-Credential

-Environment

-FilePath

-LoadUserProfile

-NoNewWindow

-PassThru

-RedirectStandardError

-RedirectStandardInput

-RedirectStandardOutput

-UseNewEnvironment

-Verb

-Wait

-WhatIf

-WindowStyle

-WorkingDirectory

Entradas

None

Você não pode canalizar objetos para esse cmdlet.

Saídas

None

Por padrão, esse cmdlet não retorna nenhuma saída.

Process

Quando você usa o parâmetro PassThru , esse cmdlet retorna um objeto Process .

Observações

O PowerShell inclui os seguintes aliases para Start-Process:

• Todas as plataformas
  • saps
• Windows
  • start

Comandos nativos são arquivos executáveis instalados no sistema operacional. Esses executáveis podem ser executados em qualquer shell de linha de comando, como o PowerShell. Normalmente, você executa o comando exatamente como faria em bash ou cmd.exe. O Start-Process cmdlet pode ser usado para executar qualquer comando nativo, mas só deve ser usado quando você precisar controlar como o comando é executado.

Start-Process é útil para executar programas GUI em plataformas não Windows. Por exemplo, execute Start-Process gedit para iniciar o editor de texto gráfico comum aos ambientes de área de trabalho do GNOME.

Por padrão, Start-Process inicia um processo de forma assíncrona. O controle é retornado instantaneamente ao PowerShell, mesmo que o novo processo ainda esteja em execução.

• No sistema local, o processo iniciado permanece independente do processo de chamada.
• Em um sistema remoto, o novo processo é encerrado quando a sessão remota termina, imediatamente após o Start-Process comando. Portanto, você não pode usar Start-Process em uma sessão remota esperando que o processo iniciado sobreviva à sessão.

Se você precisar usar Start-Process em uma sessão remota, invoque-o com o parâmetro Wait . Ou você pode usar outros métodos para criar um novo processo no sistema remoto.

Ao usar o parâmetro Wait , Start-Process aguarda a saída da árvore de processos (o processo e todos os seus descendentes) antes de retornar o controle. Isso é diferente do comportamento do Wait-Process cmdlet, que aguarda apenas a saída dos processos especificados.

No Windows, o caso Start-Process de uso mais comum é usar o parâmetro Wait para bloquear o progresso até que o novo processo seja encerrado. Em sistemas não Windows, isso raramente é necessário, pois o comportamento padrão para aplicativos de linha de comando é equivalente a Start-Process -Wait.

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

Links Relacionados

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