New-AzBatchJob

  • Référence
Module:
Az.Batch

Crée un travail dans le service Batch.

Syntax

New-AzBatchJob
   [-Id] <String>
   [-CommonEnvironmentSettings <IDictionary>]
   [-DisplayName <String>]
   [-Constraints <PSJobConstraints>]
   [-JobManagerTask <PSJobManagerTask>]
   [-JobPreparationTask <PSJobPreparationTask>]
   [-JobReleaseTask <PSJobReleaseTask>]
   [-Metadata <IDictionary>]
   -PoolInformation <PSPoolInformation>
   [-Priority <Int32>]
   [-UsesTaskDependencies]
   [-OnTaskFailure <OnTaskFailure>]
   [-OnAllTasksComplete <OnAllTasksComplete>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

L’applet de commande New-AzBatchJob crée un travail dans le service Azure Batch dans le compte spécifié par le paramètre BatchAccountContext .

Exemples

Exemple 1 : Créer un travail

$PoolInformation = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSPoolInformation"
$PoolInformation.PoolId = "Pool22"
New-AzBatchJob -Id "ContosoJob35" -PoolInformation $PoolInformation -BatchContext $Context

La première commande crée un objet PSPoolInformation à l’aide de l’applet de commande New-Object. La commande stocke cet objet dans la variable $PoolInformation. La deuxième commande affecte l’ID Pool22 à la propriété PoolId de l’objet dans $PoolInformation. La commande finale crée un travail qui a l’ID ContosoJob35. Les tâches ajoutées au travail s’exécutent sur le pool avec l’ID Pool22. Utilisez l’applet de commande Get-AzBatchAccountKey pour affecter un contexte à la variable $Context.

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

-CommonEnvironmentSettings

Spécifie les variables d’environnement courantes, en tant que paires clé/valeur, que cette applet de commande définit pour toutes les tâches du travail. La clé est le nom de la variable d’environnement. La valeur est la valeur de la variable d’environnement.

Type:IDictionary
Aliases:CommonEnvironmentSetting
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Constraints

Spécifie les contraintes d’exécution du travail.

Type:PSJobConstraints
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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

-DisplayName

Spécifie le nom complet du travail.

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

-Id

Spécifie un ID pour le travail.

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

-JobManagerTask

Spécifie la tâche du Gestionnaire de travaux. Le service Batch exécute la tâche du Gestionnaire de travaux au démarrage du travail.

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

-JobPreparationTask

Spécifie la tâche de préparation du travail. Le service Batch exécute la tâche de préparation du travail sur un nœud de calcul avant de démarrer les tâches de ce travail sur ce nœud de calcul.

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

-JobReleaseTask

Spécifie la tâche de mise en production du travail. Le service Batch exécute la tâche de mise en production du travail lorsque le travail se termine. Le service Batch exécute la tâche de mise en production du travail sur chaque nœud de calcul où elle a exécuté n’importe quelle tâche du travail.

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

-Metadata

Spécifie les métadonnées, en tant que paires clé/valeur, à ajouter au travail. La clé est le nom des métadonnées. La valeur est la valeur des métadonnées.

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

-OnAllTasksComplete

Spécifie une action effectuée par le service Batch si toutes les tâches du travail sont dans l’état terminé.

Type:Nullable<T>[OnAllTasksComplete]
Accepted values:NoAction, TerminateJob
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnTaskFailure

Spécifie une action effectuée par le service Batch si une tâche dans le travail échoue.

Type:Nullable<T>[OnTaskFailure]
Accepted values:NoAction, PerformExitOptionsJobAction
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PoolInformation

Spécifie les détails du pool sur lequel le service Batch exécute les tâches du travail.

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

-Priority

Spécifie la priorité du travail. Les valeurs valides sont les suivantes : entiers compris entre -1000 et 1000. La valeur -1000 est la priorité la plus basse. La valeur 1000 est la priorité la plus élevée. La valeur par défaut est 0.

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

-UsesTaskDependencies

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

Entrées

String

BatchAccountContext

Sorties

Void