Partager via

Get-AzBatchSubtask

  • Référence
Module:
Az.Batch

Obtient les informations de sous-tâche de la tâche spécifiée.

Syntaxe

Get-AzBatchSubtask
   [-JobId] <String>
   [-TaskId] <String>
   [-MaxCount <Int32>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzBatchSubtask
   [[-Task] <PSCloudTask>]
   [-MaxCount <Int32>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

L’applet de commande Get-AzBatchSubtask récupère les informations relatives à la tâche spécifiée. Les tâches subordonnées fournissent un traitement parallèle pour des tâches individuelles et permettent une surveillance précise de l’exécution et de la progression des tâches.

Exemples

Exemple 1 : Retourner toutes les tâches subordonnées pour une tâche spécifiée

$Context = Get-AzBatchAccountKey -AccountName "contosobatchaccount"
Get-AzBatchSubtask -JobId "Job-01" -TaskID "myTask" -BatchContext $Context

Ces commandes retournent toutes les tâches subordonnées pour la tâche avec l’ID myTask. 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 Get-AzBatchSubtask pour renvoyer toutes les tâches subordonnées pour myTask, une tâche qui s’exécute dans le cadre du travail Job-01.

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

-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

-JobId

Spécifie l’ID du travail qui contient la tâche dont la sous-tâche obtient cette applet de commande.

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

-MaxCount

Spécifie le nombre maximal de tâches subordonnées à retourner. Si vous spécifiez une valeur de zéro (0) ou moins, l’applet de commande n’utilise pas de limite supérieure. La valeur par défaut est 1000.

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

-Task

Spécifie une référence d’objet à la tâche qui contient les tâches subordonnées retournées par cette applet de commande. Cette référence d’objet est créée à l’aide de l’applet de commande Get-AzBatchTask et du stockage de l’objet retourné dans une variable.

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

-TaskId

Spécifie l’ID de la tâche dont la sous-tâche retourne cette applet de commande.

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

Entrées

String

PSCloudTask

BatchAccountContext

Sorties

PSSubtaskInformation