Partilhar via


New-AzBatchJob

Cria um trabalho no serviço Batch.

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 Batch 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 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

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

-Constraints

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

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

-DisplayName

Especifica o nome para exibição do trabalho.

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

-Id

Especifica uma ID para o trabalho.

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

-JobManagerTask

Especifica a tarefa do Gerenciador de Tarefas. O serviço Batch executa a tarefa Job Manager quando o trabalho é iniciado.

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

-JobPreparationTask

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

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

-JobReleaseTask

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

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

-OnAllTasksComplete

Especifica uma ação que o serviço em lote executa se todas as tarefas no trabalho estiverem no estado concluído.

Tipo:Nullable<T>[OnAllTasksComplete]
Valores aceites:NoAction, TerminateJob
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OnTaskFailure

Especifica uma ação que o serviço em lote executa se alguma tarefa no trabalho falhar.

Tipo:Nullable<T>[OnTaskFailure]
Valores aceites:NoAction, PerformExitOptionsJobAction
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PoolInformation

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

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

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

-UsesTaskDependencies

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

Entradas

String

BatchAccountContext

Saídas

Void