Share via

Disable-AzBatchComputeNodeScheduling

  • Referência
Módulo:
Az.Batch

Desabilita o agendamento de tarefas no nó de computação especificado.

Syntax

Disable-AzBatchComputeNodeScheduling
       [-PoolId] <String>
       [-Id] <String>
       [-DisableSchedulingOption <DisableComputeNodeSchedulingOption>]
       -BatchContext <BatchAccountContext>
       [-DefaultProfile <IAzureContextContainer>]
       [<CommonParameters>]
Disable-AzBatchComputeNodeScheduling
       [[-ComputeNode] <PSComputeNode>]
       [-DisableSchedulingOption <DisableComputeNodeSchedulingOption>]
       -BatchContext <BatchAccountContext>
       [-DefaultProfile <IAzureContextContainer>]
       [<CommonParameters>]

Description

O cmdlet Disable-AzBatchComputeNodeScheduling desabilita o agendamento de tarefas no nó de computação especificado. Um nó de computação é uma máquina virtual do Azure dedicada a uma carga de trabalho de aplicativo específica. Ao desabilitar o agendamento de tarefas em um nó de computação, você também terá a opção de determinar o que fazer com os trabalhos atualmente na fila de tarefas do nó. Disable-AzBatchComputeNodeScheduling permite que você faça o seguinte:

  • Encerre as tarefas e coloque-as novamente na fila de trabalhos. Isso permite que essas tarefas sejam reagendadas em outro nó de computação.
  • Encerre as tarefas e remova-as da fila de trabalhos. As tarefas interrompidas desta forma não serão reagendadas.
  • Aguarde a conclusão de todas as tarefas atualmente em execução e, em seguida, desative o agendamento de tarefas no nó de computação.
  • Aguarde a conclusão de todas as tarefas em execução e a expiração de todos os períodos de retenção de dados e, em seguida, desative o agendamento de tarefas no nó de computação.

Exemplos

Exemplo 1: Desativar o agendamento de tarefas em um nó de computação

$Context = Get-AzBatchAccountKey -AccountName "contosobatchaccount"
Disable-AzBatchComputeNodeScheduling -PoolId "myPool" -Id "tvm-1783593343_34-20151117t222514z" -BatchContext $Context

Esses comandos desabilitam o agendamento de tarefas no nó de computação tvm-1783593343_34-20151117t222514z. 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 Disable-AzBatchComputeNodeScheduling para se conectar ao pool myPool e desabilitar o agendamento de tarefas no nó tvm-1783593343_34-20151117t222514z. Como o parâmetro DisableComputeNodeSchedulingOptions não foi incluído, todas as tarefas atualmente em execução no nó de computação serão novamente enfileiradas.

Exemplo 2: Desabilitar o agendamento de tarefas em todos os nós de computação em um pool

$Context = Get-AzBatchAccountKey -AccountName "contosobatchaccount"
Get-AzBatchComputeNode -PoolId "Pool06"  -BatchContext $Context | Disable-AzBatchComputeNodeScheduling -BatchContext $Context

Esses comandos desabilitam o agendamento de tarefas em todos os nós do computador no pool de lotes Pool06. Para executar essa tarefa, o primeiro comando no exemplo cria uma referência de objeto às chaves de conta para a conta em lote contosobatchaccount. Essa referência de objeto é armazenada em uma variável chamada $context. O segundo comando no exemplo usa essa referência de objeto e Get-AzBatchComputeNode para retornar uma coleção de todos os nós de computação encontrados em Pool06. Essa coleção é então canalizada para o cmdlet Disable-AzBatchComputeNodeScheduling para desabilitar o agendamento de tarefas em cada nó de computação da coleção. Como o parâmetro DisableComputeNodeSchedulingOptions não foi incluído, nenhuma tarefa atualmente em execução nos nós de computação será colocada novamente na fila.

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

-ComputeNode

Especifica uma referência de objeto para o nó de computação onde o agendamento de tarefas está desabilitado. Essa referência de objeto é criada usando o cmdlet Get-AzBatchComputeNode e armazenando o objeto de nó de computação retornado em uma variável.

Type:PSComputeNode
Position:0
Default value:None
Required:False
Accept pipeline input:True
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

-DisableSchedulingOption

Especifica como esse cmdlet lida com quaisquer tarefas atualmente em execução no nó do computador em que o agendamento está sendo desabilitado. Os valores aceitáveis para este parâmetro são:

  • Voltar a enfileirar. As tarefas são interrompidas imediatamente e retornadas à fila de trabalhos. Isso permite que as tarefas sejam reagendadas em outro nó de computação. Este é o valor predefinido.
  • Terminate. As tarefas são interrompidas imediatamente e removidas da fila de trabalhos. Estas tarefas não serão reagendadas.
  • Conclusão de tarefas. As tarefas atualmente em execução poderão ser concluídas antes que o agendamento de tarefas seja desativado no nó de computação. Nenhuma nova tarefa será agendada neste nó.
  • RetainedData. As tarefas atualmente em execução poderão ser concluídas e os períodos de retenção de dados poderão expirar antes que o agendamento de tarefas seja desativado no nó de computação. Nenhuma nova tarefa será agendada neste nó.
Type:Nullable<T>[DisableComputeNodeSchedulingOption]
Accepted values:Requeue, Terminate, TaskCompletion
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Especifica a ID do nó de computação onde o agendamento de tarefas está desativado.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PoolId

Especifica a ID do pool de lotes que contém o nó de computação onde o agendamento de tarefas está desabilitado. Se você usar o parâmetro PoolId , não use o parâmetro ComputeNode nesse mesmo comando.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Entradas

PSComputeNode

BatchAccountContext

Saídas

Void