New-AzBatchTask
Bir işin altında bir Batch görevi oluşturur.
Sözdizimi
New-AzBatchTask
-JobId <String>
-Id <String>
[-DisplayName <String>]
-CommandLine <String>
[-ResourceFiles <PSResourceFile[]>]
[-EnvironmentSettings <IDictionary>]
[-AuthenticationTokenSettings <PSAuthenticationTokenSettings>]
[-UserIdentity <PSUserIdentity>]
[-AffinityInformation <PSAffinityInformation>]
[-Constraints <PSTaskConstraints>]
[-MultiInstanceSettings <PSMultiInstanceSettings>]
[-DependsOn <TaskDependencies>]
[-ApplicationPackageReferences <PSApplicationPackageReference[]>]
[-OutputFile <PSOutputFile[]>]
[-ExitConditions <PSExitConditions>]
[-ContainerSettings <PSTaskContainerSettings>]
-BatchContext <BatchAccountContext>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzBatchTask
-JobId <String>
[-Tasks <PSCloudTask[]>]
-BatchContext <BatchAccountContext>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzBatchTask
[-Job <PSCloudJob>]
[-Tasks <PSCloudTask[]>]
-BatchContext <BatchAccountContext>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzBatchTask
[-Job <PSCloudJob>]
-Id <String>
[-DisplayName <String>]
-CommandLine <String>
[-ResourceFiles <PSResourceFile[]>]
[-EnvironmentSettings <IDictionary>]
[-AuthenticationTokenSettings <PSAuthenticationTokenSettings>]
[-UserIdentity <PSUserIdentity>]
[-AffinityInformation <PSAffinityInformation>]
[-Constraints <PSTaskConstraints>]
[-MultiInstanceSettings <PSMultiInstanceSettings>]
[-DependsOn <TaskDependencies>]
[-ApplicationPackageReferences <PSApplicationPackageReference[]>]
[-OutputFile <PSOutputFile[]>]
[-ExitConditions <PSExitConditions>]
[-ContainerSettings <PSTaskContainerSettings>]
-BatchContext <BatchAccountContext>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
New-AzBatchTask cmdlet'i JobId parametresi veya İş parametresi tarafından belirtilen işin altında bir Azure Batch görevi oluşturur.
Örnekler
Örnek 1: Batch görevi oluşturma
New-AzBatchTask -JobId "Job-000001" -Id "Task23" -CommandLine "cmd /c dir /s" -BatchContext $Context
Bu komut, kimliği job-000001 olan işin altında Görev23 Kimliğine sahip bir görev oluşturur. Görev belirtilen komutu çalıştırır. $Context değişkenine bağlam atamak için Get-AzBatchAccountKey cmdlet'ini kullanın.
Örnek 2: Batch görevi oluşturma
$autoUser = New-Object Microsoft.Azure.Commands.Batch.Models.PSAutoUserSpecification -ArgumentList @("Task", "Admin")
$userIdentity = New-Object Microsoft.Azure.Commands.Batch.Models.PSUserIdentity $autoUser
Get-AzBatchJob -Id "Job-000001" -BatchContext $Context | New-AzBatchTask -Id "Task26" -CommandLine "cmd /c echo hello > newFile.txt" -UserIdentity $userIdentity -BatchContext $Context
Bu komut Get-AzBatchJob cmdlet'ini kullanarak Job-000001 kimliğine sahip Batch işini alır. komut, işlem hattı işlecini kullanarak bu işi geçerli cmdlet'e geçirir. komut, bu işin altında Görev26 Kimliğine sahip bir görev oluşturur. Görev, yükseltilmiş izinleri kullanarak belirtilen komutu çalıştırır.
Örnek 3: İşlem hattını kullanarak belirtilen işe bir görev koleksiyonu ekleme
$Context = Get-AzBatchAccountKey -AccountName "ContosoBatchAccount"
$Task01 = New-Object Microsoft.Azure.Commands.Batch.Models.PSCloudTask("Task23", "cmd /c dir /s")
$Task02 = New-Object Microsoft.Azure.Commands.Batch.Models.PSCloudTask("Task24", "cmd /c dir /s")
Get-AzBatchJob -Id "Job-000001" -BatchContext $Context | New-AzBatchTask -Tasks @($Task01, $Task02) -BatchContext $Context
İlk komut, Get-AzBatchAccountKey komutunu kullanarak ContosoBatchAccount adlı toplu iş hesabının hesap anahtarları için bir nesne başvurusu oluşturur. komutu bu nesne başvurusunu $Context değişkeninde depolar. Sonraki iki komut, New-Object cmdlet'ini kullanarak PSCloudTask nesneleri oluşturur. Komutlar görevleri $Task 01 ve $Task 02 değişkenlerinde depolar. Son komut Get-AzBatchJob kullanarak Job-000001 kimliğine sahip Batch işini alır. Ardından komut, işlem hattı işlecini kullanarak bu işi geçerli cmdlet'e geçirir. komutu, bu işin altına bir görev koleksiyonu ekler. komutu, $Context'de depolanan bağlamı kullanır.
Örnek 4: Belirtilen işe görev koleksiyonu ekleme
$Context = Get-AzBatchAccountKey -AccountName "ContosoBatchAccount"
$Task01 = New-Object Microsoft.Azure.Commands.Batch.Models.PSCloudTask("Task23", "cmd /c dir /s")
$Task02 = New-Object Microsoft.Azure.Commands.Batch.Models.PSCloudTask("Task24", "cmd /c dir /s")
New-AzBatchTask -JobId "Job-000001" -Tasks @($Task01, $Task02) -BatchContext $Context
İlk komut, Get-AzBatchAccountKey komutunu kullanarak ContosoBatchAccount adlı toplu iş hesabının hesap anahtarları için bir nesne başvurusu oluşturur. komutu bu nesne başvurusunu $Context değişkeninde depolar. Sonraki iki komut, New-Object cmdlet'ini kullanarak PSCloudTask nesneleri oluşturur. Komutlar görevleri $Task 01 ve $Task 02 değişkenlerinde depolar. Son komut, job-000001 kimliğine sahip işin altına $Task 01 ve $Task 02'de depolanan görevleri ekler.
Örnek 5: Çıkış dosyalarıyla görev ekleme
New-AzBatchTask -JobId "Job-000001" -Id "Task23" -CommandLine "cmd /c dir /s" -BatchContext $Context
$blobContainerDestination = New-Object Microsoft.Azure.Commands.Batch.Models.PSOutputFileBlobContainerDestination "https://myaccount.blob.core.windows.net/sascontainer?sv=2015-04-05&st=2015-04-29T22%3A18%3A26Z&se=2015-04-30T02%3A23%3A26Z&sr=b&sp=rw&spr=https&sig=Z%2FRHIX5Xcg0Mq2rqI3OlWTjEg2tYkboXr1P9ZUXDtkk%3D"
$destination = New-Object Microsoft.Azure.Commands.Batch.Models.PSOutputFileDestination $blobContainerDestination
$uploadOptions = New-Object Microsoft.Azure.Commands.Batch.Models.PSOutputFileUploadOptions "TaskSuccess"
$outputFile = New-Object Microsoft.Azure.Commands.Batch.Models.PSOutputFile "*.txt", $blobContainerDestination, $uploadOptions
New-AzBatchTask -JobId "Job-000001" -Id "Task23" -CommandLine "cmd /c dir /s" -OutputFile $outputFile -BatchContext $Context
Örnek 6: Kimlik doğrulama belirteci ayarlarıyla görev ekleme
$authSettings = New-Object Microsoft.Azure.Commands.Batch.Models.PSAuthenticationTokenSettings
$authSettings.Access = "Job"
New-AzBatchTask -JobId "Job-000001" -Id "Task23" -CommandLine "cmd /c dir /s" -AuthenticationTokenSettings $authSettings -BatchContext $Context
Örnek 7: Kapsayıcıda çalışan bir görev ekleme
$Context = Get-AzBatchAccountKey -AccountName "ContosoBatchAccount"
New-AzBatchTask -JobId "Job-000001" -Id "Task23" -CommandLine "cmd /c dir /s" -ContainerSettings (New-Object Microsoft.Azure.Commands.Batch.Models.PSTaskContainerSettings "containerImageName") -BatchContext $Context
Parametreler
-AffinityInformation
Batch hizmetinin görevin çalıştırıldığı düğümü seçmek için kullandığı yerellik ipucunu belirtir.
Tür: | PSAffinityInformation |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ApplicationPackageReferences
Tür: | PSApplicationPackageReference[] |
Diğer adlar: | ApplicationPackageReference |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-AuthenticationTokenSettings
Görevin Batch hizmeti işlemlerini gerçekleştirmek için kullanabileceği kimlik doğrulama belirtecinin ayarları. Bu ayarlıysa, Batch hizmeti göreve hesap erişim anahtarı gerektirmeden Batch hizmeti işlemlerinin kimliğini doğrulamak için kullanılabilecek bir kimlik doğrulama belirteci sağlar. Belirteç, AZ_BATCH_AUTHENTICATION_TOKEN ortam değişkeni aracılığıyla sağlanır. Görevin belirteci kullanarak gerçekleştirebileceği işlemler ayarlara bağlıdır. Örneğin, bir görev işe başka görevler eklemek için iş izinleri isteyebilir veya işin veya diğer görevlerin durumunu denetleyebilir.
Tür: | PSAuthenticationTokenSettings |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-BatchContext
Bu cmdlet'in Batch hizmetiyle etkileşimde bulunurken kullandığı BatchAccountContext örneğini belirtir. BatchAccountContext'inizi almak için Get-AzBatchAccount cmdlet'ini kullanırsanız, Batch hizmetiyle etkileşim kurarken Microsoft Entra kimlik doğrulaması kullanılır. Bunun yerine paylaşılan anahtar kimlik doğrulamasını kullanmak için Get-AzBatchAccountKey cmdlet'ini kullanarak erişim anahtarları doldurulmuş bir BatchAccountContext nesnesi alın. Paylaşılan anahtar kimlik doğrulaması kullanılırken, birincil erişim anahtarı varsayılan olarak kullanılır. Kullanılacak anahtarı değiştirmek için BatchAccountContext.KeyInUse özelliğini ayarlayın.
Tür: | BatchAccountContext |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-CommandLine
Görevin komut satırını belirtir.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Constraints
Bu göreve uygulanan yürütme kısıtlamalarını belirtir.
Tür: | PSTaskConstraints |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ContainerSettings
Görevin altında çalıştığı kapsayıcının ayarları. Bu görevi çalıştıracak havuzda containerConfiguration kümesi varsa, bu da ayarlanmalıdır. Bu görevi çalıştıracak havuzda containerConfiguration ayarlanmamışsa, bunun ayarlanmaması gerekir. Bu belirtildiğinde, AZ_BATCH_NODE_ROOT_DIR altındaki tüm dizinler (düğümdeki Azure Batch dizinlerinin kökü) kapsayıcıya eşlenir, tüm görev ortamı değişkenleri kapsayıcıya eşlenir ve görev komut satırı kapsayıcıda yürütülür.
Tür: | PSTaskContainerSettings |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-DefaultProfile
Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.
Tür: | IAzureContextContainer |
Diğer adlar: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-DependsOn
Görevin diğer görevlere bağlı olduğunu belirtir. Tüm bağımlı görevler başarıyla tamamlanana kadar görev zamanlanmaz.
Tür: | TaskDependencies |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-DisplayName
Görevin görünen adını belirtir.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-EnvironmentSettings
Bu cmdlet'in göreve eklediği ortam ayarlarını anahtar/değer çiftleri olarak belirtir. Anahtar, ortam ayarı adıdır. Değer, ortam ayarıdır.
Tür: | IDictionary |
Diğer adlar: | EnvironmentSetting |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ExitConditions
Tür: | PSExitConditions |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Id
Görevin kimliğini belirtir.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Job
Bu cmdlet'in görevi oluşturduğu işi belirtir. PSCloudJob nesnesi almak için Get-AzBatchJob cmdlet'ini kullanın.
Tür: | PSCloudJob |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-JobId
Bu cmdlet'in görevi oluşturduğu işin kimliğini belirtir.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-MultiInstanceSettings
Çok örnekli bir görevin nasıl çalıştırılacaklarıyla ilgili bilgileri belirtir.
Tür: | PSMultiInstanceSettings |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-OutputFile
Komut satırını çalıştırdıktan sonra Batch hizmetinin işlem düğümünden karşıya yükleyeceği dosyaların listesini alır veya ayarlar. Çok örnekli görevler için dosyalar yalnızca birincil görevin yürütüleceği işlem düğümünden karşıya yüklenir.
Tür: | PSOutputFile[] |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ResourceFiles
Görevin gerektirdiği kaynak dosyalarını anahtar/değer çiftleri olarak belirtir. Anahtar, kaynak dosya yoludur. Değer, kaynak dosyası blob kaynağıdır.
Tür: | PSResourceFile[] |
Diğer adlar: | ResourceFile |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Tasks
Eklenecek görev koleksiyonunu belirtir. Her görevin benzersiz bir kimliği olmalıdır.
Tür: | PSCloudTask[] |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-UserIdentity
Görevin altında çalıştığı kullanıcı kimliği.
Tür: | PSUserIdentity |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |