Start-Process

Sözdizimi

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

Start-Process Cmdlet, yerel bilgisayarda bir veya daha fazla işlem başlatır. Varsayılan olarak, Start-Process geçerli işlemde tanımlanan tüm ortam değişkenlerini devralan yeni bir işlem oluşturur.

İşlemde çalıştırılacak programı belirtmek için yürütülebilir bir dosya veya betik dosyası ya da bilgisayardaki bir program kullanılarak açılabilir bir dosya girin. Yürütülemeyen bir dosya belirtirseniz, Start-Process cmdlet'ine benzer şekilde Invoke-Item dosyayla ilişkili programı başlatır.

kullanıcı profili yükleme, işlemi yeni bir pencerede başlatma veya alternatif kimlik bilgileri kullanma gibi seçenekleri belirtmek için parametresini Start-Process kullanabilirsiniz.

Örnekler

Örnek 1: Varsayılan değerleri kullanan bir işlem başlatma

Bu örnek, geçerli klasördeki Sort.exe dosyayı kullanan bir işlem başlatır. Komut, varsayılan pencere stili, çalışma klasörü ve kimlik bilgileri de dahil olmak üzere tüm varsayılan değerleri kullanır.

Start-Process -FilePath "sort.exe"

Örnek 2: Metin dosyasını yazdırma

Bu örnek, dosyayı yazdıran C:\PS-Test\MyFile.txt bir işlem başlatır.

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

Örnek 3: Öğeleri yeni bir dosyaya sıralama işlemi başlatma

Bu örnek, dosyadaki öğeleri sıralayan ve dosyalardaki TestSort.txt sıralanmış öğeleri Sorted.txt döndüren bir işlem başlatır. Tüm hatalar dosyaya SortError.txt yazılır. UseNewEnvironment parametresi, işlemin kendi ortam değişkenleriyle çalıştığını belirtir.

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

Bu örnek, cmdlet'ine parametre geçirmek için splatting kullanır. Daha fazla bilgi için bkz . about_Splatting.

Örnek 4: Ekranı kaplamış bir pencerede işlem başlatma

Bu örnek işlemi başlatır Notepad.exe . Pencere ekranı kaplar ve işlem tamamlanana kadar pencereyi korur.

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

Örnek 5: PowerShell'i yönetici olarak başlatma

Bu örnek, PowerShell'i Yönetici olarak çalıştır seçeneğini kullanarak başlatır.

Start-Process -FilePath "powershell" -Verb RunAs

Örnek 6: İşlem başlatmak için farklı fiiller kullanma

Bu örnekte, bir işlem başlatılırken kullanılabilecek fiillerin nasıl bulunacağı gösterilmektedir. Kullanılabilir fiiller, işlemde çalışan dosyanın dosya adı uzantısı tarafından belirlenir.

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

open
runas
runasuser

Örnek, PowerShell işleminde çalışan dosyası için bir System.Diagnostics.ProcessStartInfo nesnesi oluşturmak için powershell.exekullanırNew-Object. ProcessStartInfo nesnesinin Fiiller özelliği, ile veya bir dosya çalıştıran herhangi bir .exe işlemle powershell.exeAç ve RunAs fiilleri kullanabileceğinizi gösterir.

Örnek 7: İşlemin bağımsız değişkenlerini belirtme

Her iki komut da Windows komut yorumlayıcısını Program Files başlatır ve klasörde bir dir komut yayınlar. Bu klasör adı bir boşluk içerdiğinden, değerin kaçış tırnaklarıyla çevrelenmesi gerekir. İlk komutun ArgumentList olarak bir dize belirttiğini unutmayın. İkinci komut bir dize dizisidir.

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

Örnek 8: Linux'ta ayrılmış işlem oluşturma

Windows'ta, Start-Process başlatma kabuğundan bağımsız olarak çalışmaya devam eden bağımsız bir işlem oluşturur. Windows olmayan platformlarda, yeni başlatılan işlem başlatılan kabuğa eklenir. Başlatan kabuk kapatılırsa alt işlem sonlandırılır.

Unix benzeri platformlarda alt işlemin sonlandırılmasını önlemek için ile nohupbirleştirebilirsinizStart-Process. Aşağıdaki örnek, başlatma oturumunu kapattıktan sonra bile canlı kalan Linux üzerinde PowerShell'in arka plan örneğini başlatır. komutu, nohup geçerli dizindeki dosyada nohup.out çıktı toplar.

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

Bu örnekte, Start-Process ayrılmış bir işlem olarak başlatılan pwsh Linux nohup komutunu çalıştırmaktır. Daha fazla bilgi için Wikipedia'da nohup makalesine bakın.

Örnek 9: Bir işlem için ortam değişkenlerini geçersiz kılma

Varsayılan olarak, kullandığınızda Start-Processyeni işlem geçerli oturumla aynı ortam değişkenleriyle oluşturulur. Ortam parametresini kullanarak bu değişkenlerin değerlerini geçersiz kılabilirsiniz.

Bu örnekte, ortam değişkeni FOO ile oturuma foo değer olarak eklenir.

Örnek üç kez çalıştırılır Start-Process ve her seferinde değerini FOO döndürür. İlk komut ortam değişkenini geçersiz kılmaz. İkinci komutta olarak FOO ayarlanır bar. Üçüncü komutta, FOO olarak ayarlanır $nullve bu da bunu kaldırır.

$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

Parametreler

-ArgumentList

-Confirm

-Credential

-Environment

-FilePath

-LoadUserProfile

-NoNewWindow

-PassThru

-RedirectStandardError

-RedirectStandardInput

-RedirectStandardOutput

-UseNewEnvironment

-Verb

-Wait

-WhatIf

-WindowStyle

-WorkingDirectory

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

None

Varsayılan olarak, bu cmdlet çıkış döndürmez.

Process

PassThru parametresini kullandığınızda, bu cmdlet bir İşlem nesnesi döndürür.

Notlar

PowerShell için aşağıdaki diğer adları Start-Processiçerir:

• Tüm platformlar
  • saps
• Windows
  • start

Yerel komutlar, işletim sisteminde yüklü yürütülebilir dosyalardır. Bu yürütülebilir dosyalar PowerShell gibi herhangi bir komut satırı kabuğundan çalıştırılabilir. Genellikle komutunu veya içinde bash cmd.exeyaptığınız gibi tam olarak çalıştırırsınız. Start-Process Cmdlet herhangi bir yerel komutu çalıştırmak için kullanılabilir, ancak yalnızca komutun nasıl yürütülebileceğini denetlemeniz gerektiğinde kullanılmalıdır.

Start-Process Windows dışı platformlarda GUI programları çalıştırmak için kullanışlıdır. Örneğin, GNOME Desktop ortamlarında yaygın olarak kullanılan grafik metin düzenleyicisini başlatmak için komutunu çalıştırın Start-Process gedit .

Varsayılan olarak, Start-Process zaman uyumsuz olarak bir işlem başlatır. Yeni işlem çalışmaya devam ediyor olsa bile denetim anında PowerShell'e döndürülür.

• Yerel sistemde, başlatılan işlem çağrı işleminden bağımsız olarak devam ediyor.
• Uzak bir sistemde, uzak oturum sona erdiğinde, komutun hemen ardından Start-Process yeni işlem sonlandırılır. Bu nedenle, başlatılan işlemin oturumdan daha uzun süre beklemesini beklerken uzak bir oturumda kullanamazsınız Start-Process .

Uzak oturumda kullanmanız Start-Process gerekiyorsa Wait parametresiyle çağırın. Veya uzak sistemde yeni bir işlem oluşturmak için başka yöntemler de kullanabilirsiniz.

Wait parametresini kullanırken, Start-Process denetimi döndürmeden önce işlem ağacının (işlem ve tüm alt öğeleri) çıkışını bekler. Bu, yalnızca belirtilen işlemlerin Wait-Process çıkışını bekleyen cmdlet'in davranışından farklıdır.

Windows'da için en yaygın kullanım örneği Start-Process , yeni işlem çıkana kadar ilerlemeyi engellemek için Wait parametresini kullanmaktır. Windows dışı sistemlerde, komut satırı uygulamaları için varsayılan davranış ile eşdeğer Start-Process -Waitolduğundan bu nadiren gereklidir.

Bu cmdlet, System.Diagnostics.Process sınıfının Start yöntemi kullanılarak uygulanır. Bu yöntem hakkında daha fazla bilgi için bkz . Process.Start Yöntemi.

İlişkili Bağlantılar

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