Partager via

Disable-AzBatchComputeNodeScheduling

  • Référence
Module:
Az.Batch

Désactive la planification des tâches sur le nœud de calcul spécifié.

Syntaxe

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

L’applet de commande Disable-AzBatchComputeNodeScheduling désactive la planification des tâches sur le nœud de calcul spécifié. Un nœud de calcul est une machine virtuelle Azure dédiée à une charge de travail d’application spécifique. Lorsque vous désactivez la planification des tâches sur un nœud de calcul, vous avez également la possibilité de déterminer ce qu’il faut faire sur les tâches actuellement dans la file d’attente des tâches du nœud. Disable-AzBatchComputeNodeScheduling vous permet d’effectuer les opérations suivantes :

  • Terminez les tâches et remettez-les dans la file d’attente des travaux. Cela permet à ces tâches d’être replanifiées sur un autre nœud de calcul.
  • Terminez les tâches et supprimez-les de la file d’attente de travaux. Les tâches arrêtées de cette manière ne seront pas replanifiées.
  • Attendez que toutes les tâches en cours d’exécution soient terminées, puis désactivez la planification des tâches sur le nœud de calcul.
  • Attendez que toutes les tâches en cours d’exécution se terminent et que toutes les périodes de rétention des données expirent, puis désactivez la planification des tâches sur le nœud de calcul.

Exemples

Exemple 1 : Désactiver la planification des tâches sur un nœud de calcul

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

Ces commandes désactivent la planification des tâches sur le nœud de calcul tvm-1783593343_34-2015117t222514z. Pour ce faire, la première commande de l’exemple crée une référence d’objet aux clés de compte pour le compte batch contosobatchaccount. Cette référence d’objet est stockée dans une variable nommée $context. La deuxième commande utilise ensuite cette référence d’objet et l’applet de commande Disable-AzBatchComputeNodeScheduling pour se connecter au pool myPool et désactiver la planification des tâches sur le nœud tvm-1783593343_34-20151117t222514z. Étant donné que le paramètre DisableComputeNodeSchedulingOptions n’a pas été inclus, aucune tâche en cours d’exécution sur le nœud de calcul sera réinitulée.

Exemple 2 : Désactiver la planification des tâches sur tous les nœuds de calcul d’un pool

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

Ces commandes désactivent la planification des tâches sur tous les nœuds d’ordinateur du pool de lots Pool06. Pour effectuer cette tâche, la première commande de l’exemple crée une référence d’objet aux clés de compte pour le compte batch contosobatchaccount. Cette référence d’objet est stockée dans une variable nommée $context. La deuxième commande de l’exemple utilise ensuite cette référence d’objet et Get-AzBatchComputeNode pour retourner une collection de tous les nœuds de calcul trouvés dans Pool06. Cette collection est ensuite redirigée vers l’applet de commande Disable-AzBatchComputeNodeScheduling pour désactiver la planification des tâches sur chaque nœud de calcul de la collection. Étant donné que le paramètre DisableComputeNodeSchedulingOptions n’a pas été inclus, aucune tâche en cours d’exécution sur les nœuds de calcul sera mise en file d’attente.

Paramètres

-BatchContext

Spécifie l’instance BatchAccountContext utilisée par cette applet de commande pour interagir avec le service Batch. Si vous utilisez l’applet de commande Get-AzBatchAccount pour obtenir votre BatchAccountContext, l’authentification Microsoft Entra sera utilisée lors de l’interaction avec le service Batch. Pour utiliser l’authentification par clé partagée à la place, utilisez l’applet de commande Get-AzBatchAccountKey pour obtenir un objet BatchAccountContext avec ses clés d’accès remplies. Lorsque vous utilisez l’authentification par clé partagée, la clé d’accès primaire est utilisée par défaut. Pour modifier la clé à utiliser, définissez la propriété BatchAccountContext.KeyInUse.

Type:BatchAccountContext
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ComputeNode

Spécifie une référence d’objet au nœud de calcul où la planification des tâches est désactivée. Cette référence d’objet est créée à l’aide de l’applet de commande Get-AzBatchComputeNode et du stockage de l’objet de nœud de calcul retourné dans une variable.

Type:PSComputeNode
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableSchedulingOption

Spécifie la façon dont cette applet de commande traite les tâches en cours d’exécution sur le nœud d’ordinateur où la planification est désactivée. Les valeurs valides pour ce paramètre sont :

  • Requeue. Les tâches sont arrêtées immédiatement et retournées à la file d’attente de travaux. Cela permet aux tâches d’être replanifiées sur un autre nœud de calcul. Il s’agit de la valeur par défaut.
  • Terminate. Les tâches sont arrêtées immédiatement et supprimées de la file d’attente de travaux. Ces tâches ne seront pas replanifiées.
  • TaskCompletion. Actuellement, les tâches en cours d’exécution peuvent être effectuées avant la désactivation de la planification des tâches sur le nœud de calcul. Aucune nouvelle tâche n’est planifiée sur ce nœud.
  • RetainedData. Actuellement, les tâches en cours d’exécution pourront terminer et les périodes de rétention des données pourront expirer avant la désactivation de la planification des tâches sur le nœud de calcul. Aucune nouvelle tâche n’est planifiée sur ce nœud.
Type:Nullable<T>[DisableComputeNodeSchedulingOption]
Valeurs acceptées:Requeue, Terminate, TaskCompletion
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Id

Spécifie l’ID du nœud de calcul dans lequel la planification des tâches est désactivée.

Type:String
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PoolId

Spécifie l’ID du pool de lots qui contient le nœud de calcul où la planification des tâches est désactivée. Si vous utilisez le paramètre PoolId , n’utilisez pas le paramètre ComputeNode dans cette même commande.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

PSComputeNode

BatchAccountContext

Sorties

Void