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>] 説明
New-AzBatchJob コマンドレットは、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 コマンドレットを 使用して PSPoolInformation オブジェクトを作成します。 このコマンドは、そのオブジェクトを $PoolInformation 変数に格納します。 2 番目のコマンドは、ID Pool22 を $PoolInformation 内のオブジェクトの PoolId プロパティに割り当てます。 最後のコマンドは、ID ContosoJob35 を持つジョブを作成します。 ジョブに追加されたタスクは、ID Pool22 を持つプールで実行されます。 Get-AzBatchAccountKey コマンドレットを使用して、$Context変数にコンテキストを割り当てます。
パラメーター
-BatchContext
このコマンドレットが Batch サービスとの対話に使用する BatchAccountContext インスタンスを指定します。 Get-AzBatchAccount コマンドレットを使用して BatchAccountContext を取得する場合、Batch サービスと対話するときに Microsoft Entra 認証が使用されます。 代わりに共有キー認証を使用するには、Get-AzBatchAccountKey コマンドレットを使用して、アクセス キーが設定された BatchAccountContext オブジェクトを取得します。 共有キー認証を使用する場合、プライマリ アクセス キーは既定で使用されます。 使用するキーを変更するには、BatchAccountContext.KeyInUse プロパティを設定します。
| Type: | BatchAccountContext |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-CommonEnvironmentSettings
このコマンドレットがジョブ内のすべてのタスクに対して設定する共通環境変数をキーと値のペアとして指定します。 キーは環境変数の名前です。 値は環境変数の値です。
| Type: | IDictionary |
| Aliases: | CommonEnvironmentSetting |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Constraints
ジョブの実行制約を指定します。
| Type: | PSJobConstraints |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisplayName
ジョブの表示名を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Id
ジョブの ID を指定します。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-JobManagerTask
ジョブ マネージャー タスクを指定します。 Batch サービスは、ジョブの開始時にジョブ マネージャー タスクを実行します。
| Type: | PSJobManagerTask |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobPreparationTask
ジョブ準備タスクを指定します。 Batch サービスは、そのコンピューティング ノードでジョブのタスクを開始する前に、コンピューティング ノードでジョブ準備タスクを実行します。
| Type: | PSJobPreparationTask |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobReleaseTask
ジョブ解放タスクを指定します。 Batch サービスは、ジョブの終了時にジョブ解放タスクを実行します。 Batch サービスは、ジョブのタスクを実行した各コンピューティング ノードでジョブ リリース タスクを実行します。
| Type: | PSJobReleaseTask |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Metadata
ジョブに追加するメタデータをキーと値のペアとして指定します。 キーはメタデータ名です。 値はメタデータ値です。
| Type: | IDictionary |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnAllTasksComplete
ジョブ内のすべてのタスクが完了状態の場合に Batch サービスが実行するアクションを指定します。
| Type: | Nullable<T>[OnAllTasksComplete] |
| Accepted values: | NoAction, TerminateJob |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnTaskFailure
ジョブ内のタスクが失敗した場合に Batch サービスが実行するアクションを指定します。
| Type: | Nullable<T>[OnTaskFailure] |
| Accepted values: | NoAction, PerformExitOptionsJobAction |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PoolInformation
Batch サービスがジョブのタスクを実行するプールの詳細を指定します。
| Type: | PSPoolInformation |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Priority
ジョブの優先順位を指定します。 有効な値は、-1000 ~ 1000 の整数です。 値 -1000 が最も低い優先順位です。 値 1000 が最も高い優先順位です。 既定値は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 |