New-AzBatchTask
Bir işin altında bir Batch görevi oluşturur.
Syntax
JobId_Single (Varsayılan)
New-AzBatchTask
-JobId <String>
-Id <String>
-CommandLine <String>
-BatchContext <BatchAccountContext>
[-DisplayName <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>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
JobId_Bulk
New-AzBatchTask
-JobId <String>
-BatchContext <BatchAccountContext>
[-Tasks <PSCloudTask[]>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
JobObject_Bulk
New-AzBatchTask
-BatchContext <BatchAccountContext>
[-Job <PSCloudJob>]
[-Tasks <PSCloudTask[]>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
JobObject_Single
New-AzBatchTask
-Id <String>
-CommandLine <String>
-BatchContext <BatchAccountContext>
[-Job <PSCloudJob>]
[-DisplayName <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>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
New-AzBatchTask cmdlet'i, JobId parametresi veya Job 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
Batch hizmetinin görevin çalıştırıldığı düğümü seçmek için kullandığı yerellik ipucunu belirtir.
JobId_Single
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
JobObject_Single
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
-ApplicationPackageReferences
New-AzBatchTask cmdlet'i, JobId parametresi veya Job parametresi tarafından belirtilen işin altında bir Azure Batch görevi oluşturur.
Parametre özellikleri
Parametre kümeleri
JobId_Single
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
JobObject_Single
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: 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.
Parametre özellikleri
Parametre kümeleri
JobId_Single
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
JobObject_Single
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: 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, erişim anahtarları doldurulmuş bir BatchAccountContext nesnesi almak için Get-AzBatchAccountKey cmdlet'ini kullanı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.
Parametre özellikleri
Parametre kümeleri
(All)
Position: Named Zorunlu: True İşlem hattından gelen değer: True Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
-CommandLine
Görevin komut satırını belirtir.
Parametre özellikleri
Tür: String
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
JobId_Single
Position: Named Zorunlu: True İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
JobObject_Single
Position: Named Zorunlu: True İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
-Constraints
Bu göreve uygulanan yürütme kısıtlamalarını belirtir.
Parametre özellikleri
Tür: PSTaskConstraints
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
JobId_Single
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
JobObject_Single
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: 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.
Parametre özellikleri
Parametre kümeleri
JobId_Single
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
JobObject_Single
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
-DefaultProfile
Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.
Parametre özellikleri
Tür: IAzureContextContainer
Default value: None Joker karakterleri destekler: False DontShow: False Diğer adlar: AzContext, AzureRmContext, AzureCredential
Parametre kümeleri
(All)
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: 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.
Parametre özellikleri
Tür: TaskDependencies
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
JobId_Single
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
JobObject_Single
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
-DisplayName
Görevin görünen adını belirtir.
Parametre özellikleri
Tür: String
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
JobId_Single
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
JobObject_Single
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: 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.
Parametre özellikleri
Tür: IDictionary
Default value: None Joker karakterleri destekler: False DontShow: False Diğer adlar: OrtamAyar
Parametre kümeleri
JobId_Single
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
JobObject_Single
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
-ExitConditions
New-AzBatchTask cmdlet'i, JobId parametresi veya Job parametresi tarafından belirtilen işin altında bir Azure Batch görevi oluşturur.
Parametre özellikleri
Tür: PSExitConditions
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
JobId_Single
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
JobObject_Single
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
-Id
Görevin kimliğini belirtir.
Parametre özellikleri
Tür: String
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
JobId_Single
Position: Named Zorunlu: True İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
JobObject_Single
Position: Named Zorunlu: True İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
-Job
Bu cmdlet'in görevi oluşturduğu işi belirtir.
PSCloudJob nesnesi edinmek için Get-AzBatchJob cmdlet'ini kullanın.
Parametre özellikleri
Tür: PSCloudJob
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
JobObject_Bulk
Position: Named Zorunlu: False İşlem hattından gelen değer: True Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
JobObject_Single
Position: Named Zorunlu: False İşlem hattından gelen değer: True Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
-JobId
Bu cmdlet'in görevi oluşturduğu işin kimliğini belirtir.
Parametre özellikleri
Tür: String
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
JobId_Single
Position: Named Zorunlu: True İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
JobId_Bulk
Position: Named Zorunlu: True İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
-MultiInstanceSettings
Çok örnekli bir görevin nasıl çalıştırılacaklarıyla ilgili bilgileri belirtir.
Parametre özellikleri
Parametre kümeleri
JobId_Single
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
JobObject_Single
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: 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.
Parametre özellikleri
Tür: PSOutputFile [ ]
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
JobId_Single
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
JobObject_Single
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: 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.
Parametre özellikleri
Tür: PSResourceFile [ ]
Default value: None Joker karakterleri destekler: False DontShow: False Diğer adlar: Kaynak Dosyası
Parametre kümeleri
JobId_Single
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
JobObject_Single
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
-Tasks
Eklenecek görev koleksiyonunu belirtir.
Her görevin benzersiz bir kimliği olmalıdır.
Parametre özellikleri
Tür: PSCloudTask [ ]
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
JobId_Bulk
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
JobObject_Bulk
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
-UserIdentity
Görevin altında çalıştığı kullanıcı kimliği.
Parametre özellikleri
Tür: PSUserIdentity
Default value: None Joker karakterleri destekler: False DontShow: False
Parametre kümeleri
JobId_Single
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
JobObject_Single
Position: Named Zorunlu: False İşlem hattından gelen değer: False Özellik adına göre işlem hattından gelen değer: False Kalan bağımsız değişkenlerden elde edilen değer: False
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
Çıkışlar