你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
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 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 属性。 最终命令创建 ID 为 ContosoJob35 的作业。 添加到作业的任务在 ID Pool22 的池上运行。 使用 Get-AzBatchAccountKey cmdlet 将上下文分配给$Context变量。
参数
-BatchContext
指定 此 cmdlet 用于与 Batch 服务交互的 BatchAccountContext 实例。 如果使用 Get-AzBatchAccount cmdlet 获取 BatchAccountContext，Microsoft 则在与 Batch 服务交互时将使用 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
指定作业的 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 |