Share via

New-AzBatchJob

  • Referensi
Modul:
Az.Batch

Membuat pekerjaan di layanan Batch.

Sintaks

New-AzBatchJob
   [-Id] <String>
   [-CommonEnvironmentSettings <IDictionary>]
   [-DisplayName <String>]
   [-Constraints <PSJobConstraints>]
   [-JobManagerTask <PSJobManagerTask>]
   [-JobPreparationTask <PSJobPreparationTask>]
   [-JobReleaseTask <PSJobReleaseTask>]
   [-Metadata <IDictionary>]
   -PoolInformation <PSPoolInformation>
   [-Priority <Int32>]
   [-UsesTaskDependencies]
   [-OnTaskFailure <OnTaskFailure>]
   [-OnAllTasksComplete <OnAllTasksComplete>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Deskripsi

Cmdlet New-AzBatchJob membuat pekerjaan di layanan Azure Batch di akun yang ditentukan oleh parameter BatchAccountContext.

Contoh

Contoh 1: Membuat pekerjaan

$PoolInformation = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSPoolInformation"
$PoolInformation.PoolId = "Pool22"
New-AzBatchJob -Id "ContosoJob35" -PoolInformation $PoolInformation -BatchContext $Context

Perintah pertama membuat objek PSPoolInformation dengan menggunakan cmdlet New-Object. Perintah menyimpan objek tersebut dalam variabel $PoolInformation. Perintah kedua menetapkan ID Pool22 ke properti PoolId objek di $PoolInformation. Perintah akhir membuat pekerjaan yang memiliki ID ContosoJob35. Tugas ditambahkan ke pekerjaan yang dijalankan pada kumpulan yang memiliki ID Pool22. Gunakan cmdlet Get-AzBatchAccountKey untuk menetapkan konteks ke variabel $Context.

Parameter

-BatchContext

Menentukan instans BatchAccountContext yang digunakan cmdlet ini untuk berinteraksi dengan layanan Batch. Jika Anda menggunakan cmdlet Get-AzBatchAccount untuk mendapatkan BatchAccountContext Anda, autentikasi Microsoft Entra akan digunakan saat berinteraksi dengan layanan Batch. Untuk menggunakan autentikasi kunci bersama sebagai gantinya, gunakan cmdlet Get-AzBatchAccountKey untuk mendapatkan objek BatchAccountContext dengan kunci aksesnya diisi. Saat menggunakan autentikasi kunci bersama, kunci akses utama digunakan secara default. Untuk mengubah kunci yang akan digunakan, atur properti BatchAccountContext.KeyInUse.

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

-CommonEnvironmentSettings

Menentukan variabel lingkungan umum, sebagai pasangan kunci/nilai, yang ditetapkan cmdlet ini untuk semua tugas dalam pekerjaan. Kuncinya adalah nama variabel lingkungan. Nilainya adalah nilai variabel lingkungan.

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

-Constraints

Menentukan batasan eksekusi untuk pekerjaan tersebut.

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

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Menentukan nama tampilan untuk pekerjaan tersebut.

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

-Id

Menentukan ID untuk pekerjaan tersebut.

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

-JobManagerTask

Menentukan tugas Manajer Pekerjaan. Layanan Batch menjalankan tugas Manajer Pekerjaan saat pekerjaan dimulai.

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

-JobPreparationTask

Menentukan tugas Persiapan Pekerjaan. Layanan Batch menjalankan tugas Persiapan Pekerjaan pada simpul komputasi sebelum memulai tugas pekerjaan tersebut pada simpul komputasi tersebut.

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

-JobReleaseTask

Menentukan tugas Rilis Pekerjaan. Layanan Batch menjalankan tugas Rilis Pekerjaan saat pekerjaan berakhir. Layanan Batch menjalankan tugas Rilis Pekerjaan pada setiap simpul komputasi tempat layanan menjalankan tugas pekerjaan apa pun.

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

-Metadata

Menentukan metadata, sebagai pasangan kunci/nilai, untuk ditambahkan ke pekerjaan. Kuncinya adalah nama metadata. Nilainya adalah nilai metadata.

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

-OnAllTasksComplete

Menentukan tindakan yang diambil layanan Batch jika semua tugas dalam pekerjaan dalam status selesai.

Type:Nullable<T>[OnAllTasksComplete]
Accepted values:NoAction, TerminateJob
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnTaskFailure

Menentukan tindakan yang diambil layanan Batch jika ada tugas dalam pekerjaan yang gagal.

Type:Nullable<T>[OnTaskFailure]
Accepted values:NoAction, PerformExitOptionsJobAction
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PoolInformation

Menentukan detail kumpulan tempat layanan Batch menjalankan tugas pekerjaan.

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

-Priority

Menentukan prioritas pekerjaan. Nilai yang valid adalah: bilangan bulat dari -1000 hingga 1000. Nilai -1000 adalah prioritas terendah. Nilai 1000 adalah prioritas tertinggi. Nilai default adalah 0.

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

-UsesTaskDependencies

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

Input

String

BatchAccountContext

Output

Void