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.

Type:BatchAccountContext
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

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

-Constraints

Specifica i vincoli di esecuzione per il processo.

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

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Specifica il nome visualizzato per il processo.

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

-Id

Specifica un ID per il processo.

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

-JobManagerTask

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

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

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

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

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

-OnAllTasksComplete

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

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

-OnTaskFailure

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

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

-PoolInformation

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

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

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

Input

String

BatchAccountContext

Output

Void