Partager via

Get-AzBatchSubtask

Module:
Az.Batch Module

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

Syntaxe

ODataFilter (Par défaut) 

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

ParentObject 

Get-AzBatchSubtask
    [[-Task] <PSCloudTask>]
    -BatchContext <BatchAccountContext>
    [-MaxCount <Int32>]
    [-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.

Propriétés du paramètre

Type:BatchAccountContext
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DefaultProfile

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

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-JobId

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ODataFilter
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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 1 000.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:PSCloudTask
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ParentObject
Position:0
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-TaskId

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ODataFilter
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

String

PSCloudTask

BatchAccountContext

Sorties

PSSubtaskInformation