Ler em inglês

Compartilhar via


Get-AzBatchSubtask

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 a ID myTask. Para fazer isso, o primeiro comando no exemplo cria uma referência de objeto às chaves de conta para a conta de lote contosobatchaccount. Essa referência de objeto é armazenada em uma variável chamada $context. Em seguida, 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 de Lote. 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 de Lote. 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
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobId

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

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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 padrão é 1000.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-TaskId

Especifica a ID da tarefa cujas subtarefas esse cmdlet retorna.

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

String

PSCloudTask

BatchAccountContext

Saídas

PSSubtaskInformation