New-AzBatchJob
Crée un travail dans le service Batch.
Syntaxe
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 $ContextLa 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 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | 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 |
| Alias: | CommonEnvironmentSetting |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Constraints
Spécifie les contraintes d’exécution du travail.
| Type: | PSJobConstraints |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| 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 |
-DisplayName
Spécifie le nom complet du travail.
| Type: | String |
| 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 un ID pour le travail.
| 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 |
-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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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] |
| Valeurs acceptées: | NoAction, TerminateJob |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-OnTaskFailure
Spécifie une action effectuée par le service Batch si une tâche dans le travail échoue.
| Type: | Nullable<T>[OnTaskFailure] |
| Valeurs acceptées: | NoAction, PerformExitOptionsJobAction |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-UsesTaskDependencies
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
