Disable-AzBatchComputeNodeScheduling

  • Referencia
Módulo:
Az.Batch

Deshabilita la programación de tareas en el nodo de proceso 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

El cmdlet Disable-AzBatchComputeNodeScheduling deshabilita la programación de tareas en el nodo de proceso especificado. Un nodo de proceso es una máquina virtual de Azure dedicada a una carga de trabajo de aplicación específica. Al deshabilitar la programación de tareas en un nodo de proceso, también tendrá la opción de determinar qué hacer sobre los trabajos actualmente en la cola de tareas del nodo. Disable-AzBatchComputeNodeScheduling le permite hacer lo siguiente:

  • Finalice las tareas y colóquelas en la cola de trabajos. Esto permite que esas tareas se vuelvan a programar en otro nodo de proceso.
  • Finalice las tareas y quítelas de la cola de trabajos. Las tareas detenidas de esta manera no se volverán a programar.
  • Espere a que se completen todas las tareas que se están ejecutando y, a continuación, deshabilite la programación de tareas en el nodo de proceso.
  • Espere a que todas las tareas en ejecución se completen y todos los períodos de retención de datos expiren y, a continuación, deshabilite la programación de tareas en el nodo de proceso.

Ejemplos

Ejemplo 1: Deshabilitar la programación de tareas en un nodo de proceso

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

Estos comandos deshabilitan la programación de tareas en el nodo de proceso tvm-1783593343_34-20151117t22514z. Para ello, el primer comando del ejemplo crea una referencia de objeto a las claves de cuenta para la cuenta de batch contosobatchaccount. Esta referencia de objeto se almacena en una variable denominada $context. A continuación, el segundo comando usa esta referencia de objeto y el cmdlet Disable-AzBatchComputeNodeScheduling para conectarse al grupo myPool y deshabilitar la programación de tareas en el nodo tvm-1783593343_34-20151117t22514z. Dado que el parámetro DisableComputeNodeSchedulingOptions no se incluyó ninguna tarea que se ejecute actualmente en el nodo de proceso se volverá a poner en cola.

Ejemplo 2: Deshabilitar la programación de tareas en todos los nodos de proceso de un grupo

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

Estos comandos deshabilitan la programación de tareas en todos los nodos de equipo del grupo de lotes Pool06. Para realizar esta tarea, el primer comando del ejemplo crea una referencia de objeto a las claves de cuenta de la cuenta por lotes contosobatchaccount. Esta referencia de objeto se almacena en una variable denominada $context. A continuación, el segundo comando del ejemplo usa esta referencia de objeto y Get-AzBatchComputeNode para devolver una colección de todos los nodos de proceso que se encuentran en Pool06. A continuación, esa colección se canaliza para, a continuación , el cmdlet Disable-AzBatchComputeNodeScheduling para deshabilitar la programación de tareas en cada nodo de proceso de la colección. Dado que el parámetro DisableComputeNodeSchedulingOptions no se incluyó ninguna tarea que se ejecute actualmente en los nodos de proceso se volverá a poner en cola.

Parámetros

-BatchContext

Especifica la instancia de BatchAccountContext que usa este cmdlet para interactuar con el servicio Batch. Si usa el cmdlet Get-AzBatchAccount para obtener batchAccountContext, se usará la autenticación de Microsoft Entra al interactuar con el servicio Batch. Para usar la autenticación de clave compartida en su lugar, use el cmdlet Get-AzBatchAccountKey para obtener un objeto BatchAccountContext con sus claves de acceso rellenadas. Al usar la autenticación de clave compartida, la clave de acceso principal se usa de forma predeterminada. Para cambiar la clave que se va a usar, establezca la propiedad BatchAccountContext.KeyInUse.

Type:BatchAccountContext
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputeNode

Especifica una referencia de objeto al nodo de proceso donde está deshabilitada la programación de tareas. Esta referencia de objeto se crea mediante el cmdlet Get-AzBatchComputeNode y almacena el objeto de nodo de proceso devuelto en una variable.

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

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableSchedulingOption

Especifica cómo se ocupa este cmdlet de las tareas que se ejecutan actualmente en el nodo de equipo donde se deshabilita la programación. Los valores permitidos para este parámetro son los siguientes:

  • Requeue. Las tareas se detienen inmediatamente y se devuelven a la cola de trabajos. Esto permite que las tareas se vuelvan a programar en otro nodo de proceso. Este es el valor predeterminado.
  • Terminate. Las tareas se detienen inmediatamente y se quitan de la cola de trabajos. Estas tareas no se volverán a programar.
  • TaskCompletion. Las tareas que se ejecutan actualmente podrán completarse antes de que la programación de tareas esté deshabilitada en el nodo de proceso. No se programarán nuevas tareas en este nodo.
  • RetainedData. Actualmente, las tareas en ejecución podrán completarse y los períodos de retención de datos podrán expirar antes de que la programación de tareas esté deshabilitada en el nodo de proceso. No se programarán nuevas tareas en este nodo.
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 el identificador del nodo de proceso donde está deshabilitada la programación de tareas.

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

-PoolId

Especifica el identificador del grupo de lotes que contiene el nodo de proceso donde está deshabilitada la programación de tareas. Si usa el parámetro PoolId , no use el parámetro ComputeNode en ese mismo comando.

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

Entradas

PSComputeNode

BatchAccountContext

Salidas

Void