Aracılığıyla paylaş

PowerShell@1 - PowerShell v1 görevi

  • Makale

Bir PowerShell betiği çalıştırın.

Söz dizimi

# PowerShell v1
# Run a PowerShell script.
- task: PowerShell@1
  inputs:
    scriptType: 'filePath' # 'inlineScript' | 'filePath'. Required. Type. Default: filePath.
    scriptName: # string. Required when scriptType = filePath. Script Path. 
    #arguments: # string. Arguments. 
    #inlineScript: # string. Required when scriptType = inlineScript. Inline Script. 
  # Advanced
    #workingFolder: # string. Working folder. 
    #failOnStandardError: true # boolean. Fail on Standard Error. Default: true.

Girişler

scriptType - Türü
string. Gereklidir. İzin verilen değerler: inlineScript (Satır içi Betik), filePath (Dosya Yolu). Varsayılan değer: filePath.

Çalıştırılacak görevin betiğinin türünü belirtir: satır içi betik veya dosyanın .ps1 yolu.


scriptName - Betik Yolu
string. olduğunda scriptType = filePathgereklidir.

Çalıştırılacak görevin betiğinin türünü belirtir: satır içi betik veya dosyanın .ps1 yolu.


arguments - Bağımsız değişken
string.

PowerShell betiğine geçirilen bağımsız değişkenleri belirtir. Bağımsız değişkenler sıralı parametreler veya adlandırılmış parametreler olabilir. Örneğin, -Name someName -Path -Value "Some long string value".

argumentsolarak ayarlandığında inlinekullanılmaztargetType.


workingFolder - Çalışma klasörü
string.

Betiğin çalıştırıldığı çalışma dizinini belirtir. Bir değer belirtilmezse, çalışma dizini olur $(Build.SourcesDirectory).


inlineScript - Satır içi Betik
string. olduğunda scriptType = inlineScriptgereklidir. Varsayılan değer: # You can write your powershell scripts inline here. \n# You can also pass predefined and custom variables to this scripts using arguments\n\n Write-Host "Hello World".

Betiğin içeriğini belirtir. Desteklenen satır içi betik uzunluğu üst sınırı 500 karakterdir. Daha uzun bir betik kullanmak istiyorsanız bir dosyadan betik kullanın.


failOnStandardError - Standart Hatada Başarısız Oldu
boolean. Varsayılan değer: true.

Bu boole değerinin değeri ise true, hata işlem hattına herhangi bir hata yazılırsa veya herhangi bir veri Standart Hata akışına yazılırsa görev başarısız olur. Aksi takdirde, görev hata belirlemek için çıkış koduna dayanır.


Görev denetim seçenekleri

Tüm görevlerde görev girişlerine ek olarak denetim seçenekleri vardır. Daha fazla bilgi için bkz . Denetim seçenekleri ve ortak görev özellikleri.

Çıkış değişkenleri

Yok.

Açıklamalar

PowerShell@1 yalnızca Windows aracılarında çalışır. PowerShell'i diğer aracı türlerinde çalıştırmak için PowerShell@2 kullanın.

Her PowerShell oturumu yalnızca çalıştığı işin süresi boyunca sürer. Önyüklemenin ne olduğuna bağlı görevlerin bootstrap ile aynı işte olması gerekir.

Sonraki betikler ve görevler tarafından okunabilmesi için bir değişken ayarlayın

Betikte derleme değişkenlerini tanımlama hakkında daha fazla bilgi edinmek için bkz. Betikte derleme değişkenlerinizi tanımlama ve değiştirme.

Betikte yayın değişkenlerini tanımlama hakkında daha fazla bilgi edinmek için bkz. Betikte yayın değişkenlerinizi tanımlama ve değiştirme.

İşlem hattı gizli dizilerini betikte geçirme, ancak gizli dizi işlem hattı günlüklerinde maskelenmez

PowerShell'in hata iletilerini kestiğini unutmayın, bu nedenle bir betikte işlem hattı gizli dizileri kullanırsanız gizli diziler kırpılabilir ve kullanıma sunulur. Örneğin, aşağıdaki satır içi betikte:

./script.ps1 --arg1 value1 --arg2 <some_secret_which_will_be_masked_here>

şöyle bir özel durum olabilir: At <path_to_temp_script_file>:4 char:3

+   ./script.ps1 --arg1 value1 --arg2 <unmasked_part_of_original_secret> ...
+   ~~~~~~~~~~
    + <Additional exception details>

Bu sorunu önlemek için bu özel durumları bir betik düzeyinde işleyebilir veya işlem hattı gizli dizilerinin hata iletileri içindeki kaynak kod satırlarında görünebileceği durumlardan kaçınabilirsiniz.

Gereksinimler

Gereksinim Açıklama
İşlem hattı türleri YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır Agent, DeploymentGroup
Talep Şirket içi barındırılan aracılar, bu görevi kullanan işleri çalıştırmak için aşağıdaki taleplerle eşleşen özelliklere sahip olmalıdır: DotNetFramework
Özellikler Bu görev, işteki sonraki görevler için hiçbir talebi karşılamaz.
Komut kısıtlamaları Herhangi biri
Ayarlanabilir değişkenler Herhangi biri
Aracı sürümü 1.102 veya üzeri
Görev kategorisi Yardımcı Program

Ayrıca bkz.