Delen via

New-AzBatchJob

  • Referentie
Module:
Az.Batch

Hiermee maakt u een taak in de Batch-service.

Syntaxis

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

Met de cmdlet New-AzBatchJob maakt u een taak in de Azure Batch-service in het account dat is opgegeven door de parameter BatchAccountContext.

Voorbeelden

Voorbeeld 1: Een taak maken

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

Met de eerste opdracht maakt u een PSPoolInformation--object met behulp van de New-Object-cmdlet. Met de opdracht wordt dat object opgeslagen in de $PoolInformation variabele. Met de tweede opdracht wordt de id-pool22 toegewezen aan de eigenschap PoolId van het object in $PoolInformation. Met de laatste opdracht maakt u een taak met de id ContosoJob35. Taken die zijn toegevoegd aan de taak die worden uitgevoerd in de pool met de id-pool22. Gebruik de cmdlet Get-AzBatchAccountKey om een context toe te wijzen aan de $Context variabele.

Parameters

-BatchContext

Hiermee geeft u het BatchAccountContext exemplaar dat door deze cmdlet wordt gebruikt om te communiceren met de Batch-service. Als u de cmdlet Get-AzBatchAccount gebruikt om uw BatchAccountContext op te halen, wordt Microsoft Entra-verificatie gebruikt bij interactie met de Batch-service. Als u in plaats daarvan verificatie met gedeelde sleutels wilt gebruiken, gebruikt u de cmdlet Get-AzBatchAccountKey om een BatchAccountContext-object op te halen waarin de bijbehorende toegangssleutels zijn ingevuld. Wanneer u verificatie met gedeelde sleutels gebruikt, wordt de primaire toegangssleutel standaard gebruikt. Als u de sleutel wilt wijzigen die u wilt gebruiken, stelt u de eigenschap BatchAccountContext.KeyInUse in.

Type:BatchAccountContext
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-CommonEnvironmentSettings

Hiermee geeft u de algemene omgevingsvariabelen op, als sleutel-waardeparen, die met deze cmdlet worden ingesteld voor alle taken in de taak. De sleutel is de naam van de omgevingsvariabele. De waarde is de waarde van de omgevingsvariabele.

Type:IDictionary
Aliassen:CommonEnvironmentSetting
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Constraints

Hiermee geeft u de uitvoeringsbeperkingen voor de taak.

Type:PSJobConstraints
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DisplayName

Hiermee geeft u de weergavenaam voor de taak.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Id

Hiermee geeft u een id voor de taak op.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-JobManagerTask

Hiermee geeft u de taak Job Manager. De Batch-service voert de Taakbeheertaak uit wanneer de taak wordt gestart.

Type:PSJobManagerTask
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-JobPreparationTask

Hiermee geeft u de taak jobvoorbereiding. De Batch-service voert de taak Taakvoorbereiding uit op een rekenknooppunt voordat de taken van die taak op dat rekenknooppunt worden gestart.

Type:PSJobPreparationTask
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-JobReleaseTask

Hiermee geeft u de taak jobrelease op. De Batch-service voert de taak Job Release uit wanneer de taak eindigt. De Batch-service voert de taak Job Release uit op elk rekenknooppunt waarop een taak van de taak is uitgevoerd.

Type:PSJobReleaseTask
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Metadata

Hiermee geeft u metagegevens op, als sleutel-waardeparen, die u aan de taak wilt toevoegen. De sleutel is de naam van de metagegevens. De waarde is de metagegevenswaarde.

Type:IDictionary
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OnAllTasksComplete

Hiermee geeft u een actie op die de Batch-service uitvoert als alle taken in de taak de voltooide status hebben.

Type:Nullable<T>[OnAllTasksComplete]
Geaccepteerde waarden:NoAction, TerminateJob
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OnTaskFailure

Hiermee geeft u een actie op die de Batch-service uitvoert als een taak in de taak mislukt.

Type:Nullable<T>[OnTaskFailure]
Geaccepteerde waarden:NoAction, PerformExitOptionsJobAction
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PoolInformation

Hiermee geeft u de details op van de pool waarop de Batch-service de taken van de taak uitvoert.

Type:PSPoolInformation
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Priority

Hiermee geeft u de prioriteit van de taak. Geldige waarden zijn: gehele getallen van -1000 tot 1000. Een waarde van -1000 is de laagste prioriteit. Een waarde van 1000 is de hoogste prioriteit. De standaardwaarde is 0.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-UsesTaskDependencies

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

Uitvoerwaarden