Get-AzBatchSubtask

Module:

Az.Batch

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

Syntax

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
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-TaskId

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

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

Entrées

String

PSCloudTask

BatchAccountContext

Sorties

PSSubtaskInformation

Liens associés

• Get-AzBatchTask