Sdílet prostřednictvím

New-AzBatchJob

  • Reference
Modul:
Az.Batch

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

Syntaxe

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

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ří objekt PSPoolInformation pomocí rutiny New-Object. Příkaz uloží tento objekt do $PoolInformation proměnné. Druhý příkaz přiřadí id Pool22 PoolId vlastnost 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 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 BatchAccountContext 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.

Typ:BatchAccountContext
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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í.

Typ:IDictionary
Aliasy:CommonEnvironmentSetting
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Constraints

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

Typ:PSJobConstraints
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DisplayName

Určuje zobrazovaný název úlohy.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Id

Určuje ID úlohy.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-JobManagerTask

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

Typ:PSJobManagerTask
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:PSJobPreparationTask
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:PSJobReleaseTask
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:IDictionary
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-OnAllTasksComplete

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

Typ:Nullable<T>[OnAllTasksComplete]
Přípustné hodnoty:NoAction, TerminateJob
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-OnTaskFailure

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

Typ:Nullable<T>[OnTaskFailure]
Přípustné hodnoty:NoAction, PerformExitOptionsJobAction
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PoolInformation

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

Typ:PSPoolInformation
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Priority

Určuje prioritu úlohy. Platné hodnoty jsou: celá čísla od -1000 do 1 000. Hodnota -1000 je nejnižší prioritou. Nejvyšší prioritou je hodnota 1000. Výchozí hodnota je 0.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-UsesTaskDependencies

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

BatchAccountContext

Výstupy

Void