New-AzBatchTask

Başvuru

Modül:: Az.Batch

Bir işin altında bir Batch görevi oluşturur.

Syntax

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.

Type:	PSAffinityInformation
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationPackageReferences

Type:	PSApplicationPackageReference[]
Aliases:	ApplicationPackageReference
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	PSAuthenticationTokenSettings
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	BatchAccountContext
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-CommandLine

Görevin komut satırını belirtir.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Constraints

Bu göreve uygulanan yürütme kısıtlamalarını belirtir.

Type:	PSTaskConstraints
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	PSTaskContainerSettings
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	TaskDependencies
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisplayName

Görevin görünen adını belirtir.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	IDictionary
Aliases:	EnvironmentSetting
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ExitConditions

Type:	PSExitConditions
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

Görevin kimliğini belirtir.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Job

Bu cmdlet'in görevi oluşturduğu işi belirtir. PSCloudJob nesnesi almak için Get-AzBatchJob cmdlet'ini kullanın.

Type:	PSCloudJob
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-JobId

Bu cmdlet'in görevi oluşturduğu işin kimliğini belirtir.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-MultiInstanceSettings

Çok örnekli bir görevin nasıl çalıştırılacaklarıyla ilgili bilgileri belirtir.

Type:	PSMultiInstanceSettings
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	PSOutputFile[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	PSResourceFile[]
Aliases:	ResourceFile
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tasks

Eklenecek görev koleksiyonunu belirtir. Her görevin benzersiz bir kimliği olmalıdır.

Type:	PSCloudTask[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UserIdentity

Görevin altında çalıştığı kullanıcı kimliği.

Type:	PSUserIdentity
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Girişler

PSCloudJob

BatchAccountContext

Çıkışlar

Void

New-AzBatchTask

Syntax

Description

Örnekler

Örnek 1: Batch görevi oluşturma

Örnek 2: Batch görevi oluşturma

Örnek 3: İşlem hattını kullanarak belirtilen işe bir görev koleksiyonu ekleme

Örnek 4: Belirtilen işe görev koleksiyonu ekleme

Örnek 5: Çıkış dosyalarıyla görev ekleme

Örnek 6: Kimlik doğrulama belirteci ayarlarıyla görev ekleme

Örnek 7: Kapsayıcıda çalışan bir görev ekleme

Parametreler

-AffinityInformation

-ApplicationPackageReferences

-AuthenticationTokenSettings

-BatchContext

-CommandLine

-Constraints

-ContainerSettings

-DefaultProfile

-DependsOn

-DisplayName

-EnvironmentSettings

-ExitConditions

-Id

-Job

-JobId

-MultiInstanceSettings

-OutputFile

-ResourceFiles

-Tasks

-UserIdentity

Girişler

Çıkışlar

Geri Bildirim

Ek kaynaklar

New-AzBatchTask

Syntax

Description

Örnekler

Örnek 1: Batch görevi oluşturma

Örnek 2: Batch görevi oluşturma

Örnek 3: İşlem hattını kullanarak belirtilen işe bir görev koleksiyonu ekleme

Örnek 4: Belirtilen işe görev koleksiyonu ekleme

Örnek 5: Çıkış dosyalarıyla görev ekleme

Örnek 6: Kimlik doğrulama belirteci ayarlarıyla görev ekleme

Örnek 7: Kapsayıcıda çalışan bir görev ekleme

Parametreler

-AffinityInformation

-ApplicationPackageReferences

-AuthenticationTokenSettings

-BatchContext

-CommandLine

-Constraints

-ContainerSettings

-DefaultProfile

-DependsOn

-DisplayName

-EnvironmentSettings

-ExitConditions

-Id

-Job

-JobId

-MultiInstanceSettings

-OutputFile

-ResourceFiles

-Tasks

-UserIdentity

Girişler

Çıkışlar

İlişkili Bağlantılar

Geri Bildirim

Ek kaynaklar