Disable-AzBatchComputeNodeScheduling

  • Referência
Módulo:
Az.Batch

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

Sintaxe

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 de volta 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 dessa maneira não serão reagendadas.
  • Aguarde a conclusão de todas as tarefas que estão sendo executadas no momento e 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: Desabilitar 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 desativam o agendamento de tarefas no nó de cálculo tvm-1783593343_34-20151117t222514z. 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 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 enfileiradas novamente.

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 do 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 no Pool06. Essa coleção é então canalizada para o cmdlet Disable-AzBatchComputeNodeScheduling para desabilitar o agendamento de tarefas em cada nó de computação na coleção. Como o parâmetro DisableComputeNodeSchedulingOptions não foi incluído, todas as tarefas atualmente em execução nos nós de computação serão enfileiradas novamente.

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

-ComputeNode

Especifica uma referência de objeto para o nó de computação em que 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.

Tipo:PSComputeNode
Cargo:0
Valor padrão:None
Obrigatório:False
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

-DisableSchedulingOption

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

  • Reenfileirar. 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 padrão.
  • Encerrar. As tarefas são interrompidas imediatamente e removidas da fila de trabalhos. Essas tarefas não serão reagendadas.
  • Conclusão da tarefa. As tarefas em execução no momento poderão ser concluídas antes que o agendamento de tarefas seja desabilitado no nó de computação. Nenhuma nova tarefa será agendada neste nó.
  • Dados retidos. As tarefas em execução no momento poderão ser concluídas e os períodos de retenção de dados poderão expirar antes que o agendamento de tarefas seja desabilitado no nó de computação. Nenhuma nova tarefa será agendada neste nó.
Tipo:Nullable<T>[DisableComputeNodeSchedulingOption]
Valores aceitos:Requeue, Terminate, TaskCompletion
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

Especifica a ID do nó de computação em que o agendamento de tarefas está desabilitado.

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

-PoolId

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

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

Entradas

PSComputeNode

BatchAccountContext

Saídas

Void