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 den 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.

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

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

-Constraints

Anger körningsbegränsningarna för jobbet.

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

-DefaultProfile

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

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

-DisplayName

Anger visningsnamnet för jobbet.

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

-Id

Anger ett ID för jobbet.

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

-JobManagerTask

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

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

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

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

-Metadata

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

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

-OnAllTasksComplete

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

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

-OnTaskFailure

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

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

-PoolInformation

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

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

-Priority

Anger jobbets prioritet. Giltiga värden är: heltal från -1 000 till 1 000. Värdet -1 000 är den lägsta prioriteten. Värdet 1 000 är den högsta prioriteten. Standardvärdet är 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

Indata

String

BatchAccountContext

Utdata

Void