Partilhar via

Get-AzBatchSubtask

  • Referência
Módulo:
Az.Batch

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

Sintaxe

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.

Tipo:BatchAccountContext
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-JobId

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

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais: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.

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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.

Tipo:PSCloudTask
Position:0
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-TaskId

Especifica a ID da tarefa cujas subtarefas esse cmdlet retorna.

Tipo:String
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Entradas

String

PSCloudTask

BatchAccountContext

Saídas

PSSubtaskInformation