你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
New-AzureBatchJob
在 Batch 服务中创建作业。
警告
截至 2024 年 2 月 29 日,AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新,建议用户从 AzureRM 迁移到 Az PowerShell 模块。
尽管 AzureRM 模块仍可能正常运行,但它不再维护或受支持,但会根据用户的自由裁量权和风险继续使用任何继续使用模块。 有关过渡到 Az 模块的指导,请参阅我们的迁移资源。
语法
New-AzureBatchJob
[-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-AzureBatchJob cmdlet 在 BatchAccountContext 参数指定的帐户中创建 Azure Batch 服务中的作业。
示例
示例 1:创建作业
PS C:\>$PoolInformation = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSPoolInformation"
PS C:\> $PoolInformation.PoolId = "Pool22"
PS C:\> New-AzureBatchJob -Id "ContosoJob35" -PoolInformation $PoolInformation -BatchContext $Context
第一个 命令使用 New-Object cmdlet 创建 PSPoolInformation 对象。 该命令将该对象存储在$PoolInformation变量中。 第二个命令将 ID Pool22 分配给 $PoolInformation中对象的 PoolId 属性。 最终命令创建 ID 为 ContosoJob35 的作业。 添加到作业的任务在 ID Pool22 的池上运行。 使用 Get-AzureRmBatchAccountKeys cmdlet 将上下文分配给$Context变量。
参数
-BatchContext
指定 此 cmdlet 用于与 Batch 服务交互的 BatchAccountContext 实例。 如果使用 Get-AzureRmBatchAccount cmdlet 获取 BatchAccountContext,则在与 Batch 服务交互时将使用 Microsoft Entra 身份验证。 若要改用共享密钥身份验证,请使用 Get-AzureRmBatchAccountKeys 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: | 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 |
输入
参数:BatchContext (ByValue)