Share via

Get-AzBatchSubtask

  • Referência
Módulo:
Az.Batch

Obtém as informações da subtarefa da tarefa especificada.

Syntax

Get-AzBatchSubtask
   [-JobId] <String>
   [-TaskId] <String>
   [-MaxCount <Int32>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzBatchSubtask
   [[-Task] <PSCloudTask>]
   [-MaxCount <Int32>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet Get-AzBatchSubtask recupera as informações da subtarefa sobre a tarefa especificada. As subtarefas fornecem processamento paralelo para tarefas individuais e permitem o monitoramento preciso da execução e do progresso da tarefa.

Exemplos

Exemplo 1: Retornar todas as subtarefas de uma tarefa especificada

$Context = Get-AzBatchAccountKey -AccountName "contosobatchaccount"
Get-AzBatchSubtask -JobId "Job-01" -TaskID "myTask" -BatchContext $Context

Esses comandos retornam todas as subtarefas da tarefa com o ID myTask. Para fazer isso, o primeiro comando no exemplo cria uma referência de objeto para as chaves de conta para a conta em lote contosobatchaccount. Essa referência de objeto é armazenada em uma variável chamada $context. O segundo comando usa essa referência de objeto e o cmdlet Get-AzBatchSubtask para retornar todas as subtarefas de myTask, uma tarefa que é executada como parte do trabalho Job-01.

Parâmetros

-BatchContext

Especifica a instância BatchAccountContext que esse cmdlet usa para interagir com o serviço Batch. Se você usar o cmdlet Get-AzBatchAccount para obter seu BatchAccountContext, a autenticação do Microsoft Entra será usada ao interagir com o serviço Batch. Para usar a autenticação de chave compartilhada, use o cmdlet Get-AzBatchAccountKey para obter um objeto BatchAccountContext com suas chaves de acesso preenchidas. Ao usar a autenticação de chave compartilhada, a chave de acesso primária é usada por padrão. Para alterar a chave a ser usada, defina a propriedade BatchAccountContext.KeyInUse.

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

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobId

Especifica a ID do trabalho que contém a tarefa cujas subtarefas este cmdlet obtém.

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

-MaxCount

Especifica o número máximo de subtarefas a serem retornadas. Se você especificar um valor de zero (0) ou menos, o cmdlet não usará um limite superior. O valor predefinido é 1000.

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

-Task

Especifica uma referência de objeto para a tarefa que contém as subtarefas retornadas por esse cmdlet. Essa referência de objeto é criada usando o cmdlet Get-AzBatchTask e armazenando o objeto retornado em uma variável.

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

-TaskId

Especifica a ID da tarefa cujas subtarefas esse cmdlet retorna.

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

Entradas

String

PSCloudTask

BatchAccountContext

Saídas

PSSubtaskInformation