Condividi tramite

New-AzBatchJob

  • Riferimento
Modulo:
Az.Batch

Crea un processo nel servizio Batch.

Sintassi

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>]

Descrizione

Il cmdlet New-AzBatchJob crea un processo nel servizio Azure Batch nell'account specificato dal parametro BatchContext .

Esempio

Esempio 1: Creare un processo

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

Il primo comando crea un oggetto PSPoolInformation usando il cmdlet New-Object. Il comando archivia l'oggetto nella variabile $PoolInformation. Il secondo comando assegna l'ID Pool22 alla proprietà PoolId dell'oggetto in $PoolInformation. Il comando finale crea un processo con ID ContosoJob35. Le attività aggiunte al processo vengono eseguite nel pool con ID Pool22. Usare il cmdlet Get-AzBatchAccountKey per assegnare un contesto alla variabile $Context.

Parametri

-BatchContext

Specifica l'istanza batchAccountContext usata da questo cmdlet per interagire con il servizio Batch. Se si usa il cmdlet Get-AzBatchAccount per ottenere BatchAccountContext, l'autenticazione di Microsoft Entra verrà usata durante l'interazione con il servizio Batch. Per usare invece l'autenticazione con chiave condivisa, usare il cmdlet Get-AzBatchAccountKey per ottenere un oggetto BatchAccountContext con le relative chiavi di accesso popolate. Quando si usa l'autenticazione con chiave condivisa, la chiave di accesso primaria viene usata per impostazione predefinita. Per modificare la chiave da usare, impostare la proprietà BatchAccountContext.KeyInUse.

Tipo:BatchAccountContext
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-CommonEnvironmentSettings

Specifica le variabili di ambiente comuni, come coppie chiave/valore, impostate da questo cmdlet per tutte le attività del processo. La chiave è il nome della variabile di ambiente. Il valore è il valore della variabile di ambiente.

Tipo:IDictionary
Alias:CommonEnvironmentSetting
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Constraints

Specifica i vincoli di esecuzione per il processo.

Tipo:PSJobConstraints
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisplayName

Specifica il nome visualizzato per il processo.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Id

Specifica un ID per il processo.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-JobManagerTask

Specifica l'attività Job Manager. Il servizio Batch esegue l'attività Gestione processi all'avvio del processo.

Tipo:PSJobManagerTask
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-JobPreparationTask

Specifica l'attività Preparazione processo. Il servizio Batch esegue l'attività Preparazione processo in un nodo di calcolo prima di avviare qualsiasi attività del processo in tale nodo di calcolo.

Tipo:PSJobPreparationTask
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-JobReleaseTask

Specifica l'attività Rilascio processo. Il servizio Batch esegue l'attività Rilascio processi al termine del processo. Il servizio Batch esegue l'attività Rilascio processo in ogni nodo di calcolo in cui è stata eseguita qualsiasi attività del processo.

Tipo:PSJobReleaseTask
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Metadata

Specifica i metadati, come coppie chiave/valore, da aggiungere al processo. La chiave è il nome dei metadati. Il valore è il valore dei metadati.

Tipo:IDictionary
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-OnAllTasksComplete

Specifica un'azione eseguita dal servizio Batch se tutte le attività nel processo sono nello stato completato.

Tipo:Nullable<T>[OnAllTasksComplete]
Valori accettati:NoAction, TerminateJob
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-OnTaskFailure

Specifica un'azione eseguita dal servizio Batch se un'attività nel processo non riesce.

Tipo:Nullable<T>[OnTaskFailure]
Valori accettati:NoAction, PerformExitOptionsJobAction
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PoolInformation

Specifica i dettagli del pool in cui il servizio Batch esegue le attività del processo.

Tipo:PSPoolInformation
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Priority

Specifica la priorità del processo. I valori validi sono: numeri interi compresi tra -1000 e 1000. Il valore -1000 è la priorità più bassa. Il valore 1000 è la priorità più alta. Il valore predefinito è 0.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UsesTaskDependencies

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String

BatchAccountContext

Output

Void