New-AzBatchJob
Cria um trabalho no serviço Batch.
Syntax
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 $ContextO 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.
| Type: | BatchAccountContext |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | IDictionary |
| Aliases: | CommonEnvironmentSetting |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Constraints
Especifica as restrições de execução para o trabalho.
| Type: | PSJobConstraints |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| 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 |
-DisplayName
Especifica o nome para exibição do trabalho.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Id
Especifica uma ID para o trabalho.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-JobManagerTask
Especifica a tarefa do Gerenciador de Tarefas. O serviço Batch executa a tarefa Job Manager quando o trabalho é iniciado.
| Type: | PSJobManagerTask |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | PSJobPreparationTask |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | PSJobReleaseTask |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | IDictionary |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnAllTasksComplete
Especifica uma ação que o serviço em lote executa se todas as tarefas no trabalho estiverem no estado concluído.
| Type: | Nullable<T>[OnAllTasksComplete] |
| Accepted values: | NoAction, TerminateJob |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnTaskFailure
Especifica uma ação que o serviço em lote executa se alguma tarefa no trabalho falhar.
| Type: | Nullable<T>[OnTaskFailure] |
| Accepted values: | NoAction, PerformExitOptionsJobAction |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PoolInformation
Especifica os detalhes do pool no qual o serviço de lote executa as tarefas do trabalho.
| Type: | PSPoolInformation |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UsesTaskDependencies
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |