你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

New-AzBatchJob

  • 参考
模块:
Az.Batch

在 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，则在与 Batch 服务交互时将使用 Microsoft Entra 身份验证。 若要改用共享密钥身份验证，请使用 Get-AzBatchAccountKey cmdlet 获取填充其访问密钥的 BatchAccountContext 对象。 使用共享密钥身份验证时，默认使用主访问密钥。 若要更改要使用的密钥，请设置 BatchAccountContext.KeyInUse 属性。

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

-CommonEnvironmentSettings

指定作为键/值对的常见环境变量，此 cmdlet 为作业中的所有任务设置。 密钥是环境变量名称。 该值是环境变量值。

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

输入

String

BatchAccountContext

输出

Void