Compartilhar via

Disable-AzBatchComputeNodeScheduling

  • Referência
Módulo:
Az.Batch

Desabilita 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 do 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 em relação aos 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 trabalho. Isso permite que essas tarefas sejam reagendadas em outro nó de computação.
  • Encerre as tarefas e remova-as da fila de trabalho. As tarefas paradas dessa maneira não serão reagendadas.
  • Aguarde até que todas as tarefas que estão sendo executadas sejam concluídas e desabilite o agendamento de tarefas no nó de computação.
  • Aguarde até que todas as tarefas em execução sejam concluídas e todos os períodos de retenção de dados expirem e desabilite 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 desabilitam a agenda 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 às chaves de conta da conta de 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 nenhuma tarefa em execução no momento no nó de computação será requeuída.

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 da conta de 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 Disable-AzBatchComputeNodeScheduling cmdlet 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 nenhuma tarefa atualmente em execução nos nós de computação será requeuída.

Parâmetros

-BatchContext

Especifica a instância BatchAccountContext que esse cmdlet usa para interagir com o serviço do Lote. Se você usar o cmdlet Get-AzBatchAccount para obter o BatchAccountContext, a autenticação do Microsoft Entra será usada ao interagir com o serviço do 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 ao 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 as 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:

  • Requeue. As tarefas são interrompidas imediatamente e retornadas para a fila de trabalho. Isso permite que as tarefas sejam reagendadas em outro nó de computação. Esse é o valor padrão.
  • Terminar. As tarefas são interrompidas imediatamente e removidas da fila de trabalho. Essas tarefas não serão reagendadas.
  • TaskCompletion. No momento, as tarefas em execução 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ó.
  • RetainedData. No momento, as tarefas 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 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