New-AzBatchJob
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.
Jenis: | BatchAccountContext |
Position: | Named |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | 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.
Jenis: | IDictionary |
Alias: | CommonEnvironmentSetting |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Constraints
Menentukan batasan eksekusi untuk pekerjaan tersebut.
Jenis: | PSJobConstraints |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-DefaultProfile
Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure.
Jenis: | IAzureContextContainer |
Alias: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-DisplayName
Menentukan nama tampilan untuk pekerjaan tersebut.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Id
Menentukan ID untuk pekerjaan tersebut.
Jenis: | String |
Position: | 0 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | False |
-JobManagerTask
Menentukan tugas Manajer Pekerjaan. Layanan Batch menjalankan tugas Manajer Pekerjaan saat pekerjaan dimulai.
Jenis: | PSJobManagerTask |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-JobPreparationTask
Menentukan tugas Persiapan Pekerjaan. Layanan Batch menjalankan tugas Persiapan Pekerjaan pada simpul komputasi sebelum memulai tugas pekerjaan tersebut pada simpul komputasi tersebut.
Jenis: | PSJobPreparationTask |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | 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.
Jenis: | PSJobReleaseTask |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Metadata
Menentukan metadata, sebagai pasangan kunci/nilai, untuk ditambahkan ke pekerjaan. Kuncinya adalah nama metadata. Nilainya adalah nilai metadata.
Jenis: | IDictionary |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-OnAllTasksComplete
Menentukan tindakan yang diambil layanan Batch jika semua tugas dalam pekerjaan dalam status selesai.
Jenis: | Nullable<T>[OnAllTasksComplete] |
Nilai yang diterima: | NoAction, TerminateJob |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-OnTaskFailure
Menentukan tindakan yang diambil layanan Batch jika ada tugas dalam pekerjaan yang gagal.
Jenis: | Nullable<T>[OnTaskFailure] |
Nilai yang diterima: | NoAction, PerformExitOptionsJobAction |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-PoolInformation
Menentukan detail kumpulan tempat layanan Batch menjalankan tugas pekerjaan.
Jenis: | PSPoolInformation |
Position: | Named |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | False |
Terima karakter wildcard: | 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.
Jenis: | Int32 |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-UsesTaskDependencies
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |