New-AzBatchJob

  • Referência
Módulo:
Az.Batch

Cria um trabalho no serviço de Lote.

Sintaxe

New-AzBatchJob
   [-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>]

Description

O cmdlet New-AzBatchJob cria um trabalho no serviço Lote do Azure na conta especificada pelo parâmetro BatchAccountContext .

Exemplos

Exemplo 1: Criar um trabalho

$PoolInformation = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSPoolInformation"
$PoolInformation.PoolId = "Pool22"
New-AzBatchJob -Id "ContosoJob35" -PoolInformation $PoolInformation -BatchContext $Context

O primeiro comando cria um objeto PSPoolInformation usando o cmdlet New-Object. O comando armazena esse objeto na variável $PoolInformation. O segundo comando atribui a ID Pool22 à propriedade PoolId do objeto em $PoolInformation. O comando final cria um trabalho que tem a ID ContosoJob35. As tarefas adicionadas ao trabalho são executadas no pool que tem o ID Pool22. Use o cmdlet Get-AzBatchAccountKey para atribuir um contexto à variável $Context.

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

-CommonEnvironmentSettings

Especifica as variáveis de ambiente comuns, como pares chave/valor, que esse cmdlet define para todas as tarefas no trabalho. A chave é o nome da variável de ambiente. O valor é o valor da variável de ambiente.

Tipo:IDictionary
Aliases:CommonEnvironmentSetting
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Constraints

Especifica as restrições de execução para o trabalho.

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

-DisplayName

Especifica o nome de exibição do trabalho.

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

-Id

Especifica uma ID para o trabalho.

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

-JobManagerTask

Especifica a tarefa do Gerenciador de Trabalhos. O serviço de Lote executa a tarefa Gerenciador de Trabalhos quando o trabalho é iniciado.

Tipo:PSJobManagerTask
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobPreparationTask

Especifica a tarefa Preparação do Trabalho. O serviço de Lote executa a tarefa de Preparação de Trabalho em um nó de computação antes de iniciar qualquer tarefa desse trabalho nesse nó de computação.

Tipo:PSJobPreparationTask
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobReleaseTask

Especifica a tarefa Liberação de trabalho. O serviço de Lote executa a tarefa Liberação de Trabalho quando o trabalho termina. O serviço Lote executa a tarefa Liberação de Trabalho em cada nó de computação em que executou qualquer tarefa do trabalho.

Tipo:PSJobReleaseTask
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Metadata

Especifica metadados, como pares chave/valor, a serem adicionados ao trabalho. A chave é o nome dos metadados. O valor é o valor dos metadados.

Tipo:IDictionary
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OnAllTasksComplete

Especifica uma ação que o serviço de Lote executará se todas as tarefas no trabalho estiverem no estado concluído.

Tipo:Nullable<T>[OnAllTasksComplete]
Valores aceitos:NoAction, TerminateJob
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OnTaskFailure

Especifica uma ação que o serviço de Lote executará se alguma tarefa no trabalho falhar.

Tipo:Nullable<T>[OnTaskFailure]
Valores aceitos:NoAction, PerformExitOptionsJobAction
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PoolInformation

Especifica os detalhes do pool no qual o serviço de Lote executa as tarefas do trabalho.

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

-Priority

Especifica a prioridade do trabalho. Os valores válidos são: inteiros de -1000 a 1000. Um valor de -1000 é a prioridade mais baixa. Um valor de 1000 é a prioridade mais alta. O valor padrão é 0.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UsesTaskDependencies

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

String

BatchAccountContext

Saídas

Void