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

Remove-AzBatchTask

删除 Batch 任务。

语法

Remove-AzBatchTask
      [-JobId] <String>
      [-Id] <String>
      [-Force]
      -BatchContext <BatchAccountContext>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzBatchTask
      [-InputObject] <PSCloudTask>
      [-Force]
      -BatchContext <BatchAccountContext>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

Remove-AzBatchTask cmdlet 删除 Azure Batch 任务。 除非指定 Force 参数,否则此 cmdlet 会提示你进行确认。

示例

示例 1:按 ID 删除批处理任务

Remove-AzBatchTask -JobId "Job-000001" -Id "Task23" -BatchContext $Context

此命令删除 ID 任务 23 下具有 ID 作业-000001 的任务。 该命令会提示你进行确认。 使用 Get-AzBatchAccountKey cmdlet 将上下文分配给$Context变量。

示例 2:使用管道删除批处理任务,而无需确认

Get-AzBatchTask -JobId "Job-000001" -Id "Task26" -BatchContext $Context | Remove-AzBatchTask -Force -BatchContext $Context

此命令使用 Get-AzBatchTask cmdlet 获取具有 ID 作业-000001 的作业中 ID 任务 26 的 Batch 任务。 该命令使用管道运算符将该任务传递到当前 cmdlet。 该命令将删除该任务。 此命令指定 Force 参数。 因此,该命令不会提示你进行确认。

参数

-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

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
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

-Force

强制运行命令而不要求用户确认。

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

-Id

指定此 cmdlet 删除的任务的 ID。 不能指定 wild卡 字符。

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InputObject

指定此 cmdlet 删除的任务。 若要获取 PSCloudTask 对象,请使用 Get-AzBatchTask cmdlet。

Type:PSCloudTask
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-JobId

指定包含任务的作业的 ID。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

String

PSCloudTask

BatchAccountContext

输出

Void