New-AzBatchJob

  • Reference
Modul:
Az.Batch

Vytvoří úlohu ve službě Batch.

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

Rutina New-AzBatchJob vytvoří úlohu ve službě Azure Batch v účtu určeném parametrem BatchAccountContext .

Příklady

Příklad 1: Vytvoření úlohy

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

První příkaz vytvoří PSPoolInformation objekt pomocí New-Object rutiny. Příkaz uloží tento objekt do $PoolInformation proměnné. Druhý příkaz přiřadí ID Pool22 vlastnost PoolId objektu v $PoolInformation. Poslední příkaz vytvoří úlohu s ID ContosoJob35. Úkoly přidané do úlohy se spouštějí ve fondu s ID Pool22. Pomocí rutiny Get-AzBatchAccountKey přiřaďte kontext k proměnné $Context.

Parametry

-BatchContext

Určuje instanci BatchAccountContext , kterou tato rutina používá k interakci se službou Batch. Pokud k získání účtu BatchAccount použijete rutinu Get-AzBatchAccount, použije se při interakci se službou Batch ověřování Microsoft Entra. Pokud chcete místo toho použít ověřování pomocí sdíleného klíče, použijte rutinu Get-AzBatchAccountKey k získání objektu BatchAccountContext s vyplněnými přístupovými klíči. Při použití ověřování pomocí sdíleného klíče se ve výchozím nastavení používá primární přístupový klíč. Pokud chcete změnit klíč, který chcete použít, nastavte vlastnost BatchAccountContext.KeyInUse.

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

-CommonEnvironmentSettings

Určuje společné proměnné prostředí, jako páry klíč/hodnota, které tato rutina nastaví pro všechny úlohy v úloze. Klíč je název proměnné prostředí. Hodnota je hodnota proměnné prostředí.

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

-Constraints

Určuje omezení provádění úlohy.

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

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

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

-DisplayName

Určuje zobrazovaný název úlohy.

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

-Id

Určuje ID úlohy.

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

-JobManagerTask

Určuje úkol Správce úloh. Služba Batch spustí úlohu Správce úloh při spuštění úlohy.

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

-JobPreparationTask

Určuje úkol přípravy úlohy. Služba Batch spustí úlohu Přípravy úloh na výpočetním uzlu předtím, než spustí všechny úkoly této úlohy na daném výpočetním uzlu.

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

-JobReleaseTask

Určuje úlohu uvolnění úlohy. Služba Batch spustí úlohu uvolnění úlohy, když úloha skončí. Služba Batch spustí úlohu uvolnění úlohy na každém výpočetním uzlu, kde spustila libovolný úkol úlohy.

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

-Metadata

Určuje metadata, která se mají do úlohy přidat jako páry klíč/hodnota. Klíč je název metadat. Hodnota je hodnota metadat.

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

-OnAllTasksComplete

Určuje akci, kterou služba Batch provede, pokud jsou všechny úkoly v úloze v dokončeném stavu.

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

-OnTaskFailure

Určuje akci, kterou služba Batch provede, pokud některý úkol v úloze selže.

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

-PoolInformation

Určuje podrobnosti fondu, na kterém služba Batch spouští úlohy.

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

-Priority

Určuje prioritu úlohy. Platné hodnoty jsou: celá čísla od -1000 do 1000. Nejnižší prioritou je hodnota -1000. Nejvyšší prioritou je hodnota 1000. Výchozí hodnota je 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

Vstupy

String

BatchAccountContext

Výstupy

Void