New-AzBatchJob
在 Batch 服務中建立作業。
語法
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>] Description
New-AzBatchJob Cmdlet 會在 BatchAccountContext 參數所指定帳戶的 Azure Batch 服務中建立作業。
範例
範例 1：建立作業
$PoolInformation = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSPoolInformation"
$PoolInformation.PoolId = "Pool22"
New-AzBatchJob -Id "ContosoJob35" -PoolInformation $PoolInformation -BatchContext $Context第一個命令會使用 New-Object Cmdlet 建立 PSPoolInformation 物件。 命令會將該物件儲存在$PoolInformation變數中。 第二個命令會將ID Pool22指派給 $PoolInformation 中物件的 PoolId 屬性。 最後一個命令會建立標識碼為 ContosoJob35 的作業。 新增至作業的工作會在具有ID Pool22 的集區上執行。 使用 Get-AzBatchAccountKey Cmdlet 將內容指派給$Context變數。
參數
-BatchContext
指定此 Cmdlet 用來與 Batch 服務互動的 BatchAccountContext 實例。 如果您使用 Get-AzBatchAccount Cmdlet 來取得 BatchAccountContext，則與 Batch 服務互動時，將會使用Microsoft Entra 驗證。 若要改用共用密鑰驗證，請使用 Get-AzBatchAccountKey Cmdlet 來取得已填入其存取金鑰的 BatchAccountContext 物件。 使用共用金鑰驗證時，預設會使用主要存取金鑰。 若要變更要使用的密鑰，請設定 BatchAccountContext.KeyInUse 屬性。
| 類型: | BatchAccountContext |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-CommonEnvironmentSettings
指定一般環境變數做為索引鍵/值組，此 Cmdlet 會針對作業中的所有工作設定。 索引鍵是環境變數名稱。 值是環境變數值。
| 類型: | IDictionary |
| 別名: | CommonEnvironmentSetting |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Constraints
指定作業的執行條件約束。
| 類型: | PSJobConstraints |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
| 類型: | IAzureContextContainer |
| 別名: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisplayName
指定作業的顯示名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Id
指定作業的識別碼。
| 類型: | String |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-JobManagerTask
指定作業管理員工作。 Batch 服務會在作業啟動時執行作業管理員工作。
| 類型: | PSJobManagerTask |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-JobPreparationTask
指定作業準備工作。 Batch 服務會在計算節點上執行作業準備工作，然後才在該計算節點上啟動該作業的任何工作。
| 類型: | PSJobPreparationTask |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-JobReleaseTask
指定作業發行工作。 Batch 服務會在作業結束時執行作業發行工作。 Batch 服務會在執行作業任何工作的每個計算節點上執行作業發行工作。
| 類型: | PSJobReleaseTask |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Metadata
將元數據指定為索引鍵/值組，以新增至作業。 索引鍵是元數據名稱。 值是元數據值。
| 類型: | IDictionary |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-OnAllTasksComplete
指定 Batch 服務在作業中的所有工作都處於已完成狀態時所接受的動作。
| 類型: | Nullable<T>[OnAllTasksComplete] |
| 接受的值: | NoAction, TerminateJob |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-OnTaskFailure
指定 Batch 服務在作業中的任何工作失敗時所接受的動作。
| 類型: | Nullable<T>[OnTaskFailure] |
| 接受的值: | NoAction, PerformExitOptionsJobAction |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-PoolInformation
指定 Batch 服務執行作業工作的集區詳細數據。
| 類型: | PSPoolInformation |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Priority
指定作業的優先順序。 有效值為：從 -1000 到 1000 的整數。 -1000 的值是最低優先順序。 值為 1000 是最高優先順序。 預設值為 0。
| 類型: | Int32 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-UsesTaskDependencies
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
