Dela via

New-AzBatchJob

  • Referens
Modul:
Az.Batch

Skapar ett jobb i Batch-tjänsten.

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

Cmdleten New-AzBatchJob skapar ett jobb i Azure Batch-tjänsten i det konto som anges av parametern BatchAccountContext.

Exempel

Exempel 1: Skapa ett jobb

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

Det första kommandot skapar ett PSPoolInformation-objekt med hjälp av cmdleten New-Object. Kommandot lagrar objektet i variabeln $PoolInformation. Det andra kommandot tilldelar ID Pool22 till egenskapen PoolId för objektet i $PoolInformation. Det sista kommandot skapar ett jobb som har ID ContosoJob35. Uppgifter som lagts till i jobbet körs i poolen som har ID-pool 22. Använd cmdleten Get-AzBatchAccountKey för att tilldela en kontext till variabeln $Context.

Parametrar

-BatchContext

Anger BatchAccountContext instans som den här cmdleten använder för att interagera med Batch-tjänsten. Om du använder cmdleten Get-AzBatchAccount för att hämta BatchAccountContext används Microsoft Entra-autentisering när du interagerar med Batch-tjänsten. Om du vill använda autentisering med delad nyckel i stället använder du cmdleten Get-AzBatchAccountKey för att hämta ett BatchAccountContext-objekt med dess åtkomstnycklar ifyllda. När du använder autentisering med delad nyckel används den primära åtkomstnyckeln som standard. Om du vill ändra vilken nyckel som ska användas anger du egenskapen BatchAccountContext.KeyInUse.

Typ:BatchAccountContext
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-CommonEnvironmentSettings

Anger de vanliga miljövariablerna, som nyckel/värde-par, som denna cmdlet anger för alla aktiviteter i jobbet. Nyckeln är miljövariabelns namn. Värdet är miljövariabelvärdet.

Typ:IDictionary
Alias:CommonEnvironmentSetting
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Constraints

Anger körningsbegränsningarna för jobbet.

Typ:PSJobConstraints
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DisplayName

Anger visningsnamnet för jobbet.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Id

Anger ett ID för jobbet.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-JobManagerTask

Anger Job Manager-aktiviteten. Batch-tjänsten kör Job Manager-aktiviteten när jobbet startas.

Typ:PSJobManagerTask
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-JobPreparationTask

Anger uppgiften Jobbförberedelse. Batch-tjänsten kör uppgiften Jobbförberedelse på en beräkningsnod innan den startar några uppgifter för det jobbet på beräkningsnoden.

Typ:PSJobPreparationTask
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-JobReleaseTask

Anger uppgiften Jobbfrisläpp. Batch-tjänsten kör uppgiften Job Release när jobbet slutar. Batch-tjänsten kör jobbpubliceringsaktiviteten på varje beräkningsnod där den körde någon uppgift i jobbet.

Typ:PSJobReleaseTask
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Metadata

Anger metadata, som nyckel/värde-par, som ska läggas till i jobbet. Nyckeln är metadatanamnet. Värdet är metadatavärdet.

Typ:IDictionary
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-OnAllTasksComplete

Anger en åtgärd som Batch-tjänsten vidtar om alla aktiviteter i jobbet är i slutfört tillstånd.

Typ:Nullable<T>[OnAllTasksComplete]
Godkända värden:NoAction, TerminateJob
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-OnTaskFailure

Anger en åtgärd som Batch-tjänsten vidtar om någon uppgift i jobbet misslyckas.

Typ:Nullable<T>[OnTaskFailure]
Godkända värden:NoAction, PerformExitOptionsJobAction
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PoolInformation

Anger information om poolen där Batch-tjänsten kör jobbets uppgifter.

Typ:PSPoolInformation
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Priority

Anger jobbets prioritet. Giltiga värden är: heltal från -1000 till 1 000. Värdet -1000 är den lägsta prioriteten. Värdet 1 000 är den högsta prioriteten. Standardvärdet är 0.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-UsesTaskDependencies

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String

BatchAccountContext

Utdata

Void