Freigeben über

New-AzBatchJob

  • Referenz
Modul:
Az.Batch

Erstellt einen Auftrag im Batchdienst.

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>]

Beschreibung

Das Cmdlet New-AzBatchJob erstellt einen Auftrag im Azure Batch-Dienst in dem konto, das durch den parameter BatchAccountContext angegeben wurde.

Beispiele

Beispiel 1: Erstellen eines Auftrags

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

Mit dem ersten Befehl wird mithilfe des cmdlets New-Object ein PSPoolInformation--Objekt erstellt. Der Befehl speichert dieses Objekt in der $PoolInformation Variablen. Mit dem zweiten Befehl wird der ID Pool22 der PoolId- Eigenschaft des Objekts in $PoolInformation zugewiesen. Der letzte Befehl erstellt einen Auftrag mit der ID ContosoJob35. Aufgaben, die dem Auftrag hinzugefügt werden, der auf dem Pool ausgeführt wird, der über den ID Pool22 verfügt. Verwenden Sie das Cmdlet Get-AzBatchAccountKey, um der variablen $Context einen Kontext zuzuweisen.

Parameter

-BatchContext

Gibt die BatchAccountContext- Instanz an, die dieses Cmdlet für die Interaktion mit dem Batchdienst verwendet. Wenn Sie das Cmdlet Get-AzBatchAccount verwenden, um Ihren BatchAccountContext abzurufen, wird die Microsoft Entra-Authentifizierung bei der Interaktion mit dem Batchdienst verwendet. Verwenden Sie zum Verwenden der gemeinsamen Schlüsselauthentifizierung stattdessen das cmdlet Get-AzBatchAccountKey, um ein BatchAccountContext-Objekt mit den aufgefüllten Zugriffstasten abzurufen. Bei Verwendung der Authentifizierung mit gemeinsam genutzten Schlüsseln wird standardmäßig der primäre Zugriffsschlüssel verwendet. Um den zu verwendenden Schlüssel zu ändern, legen Sie die BatchAccountContext.KeyInUse-Eigenschaft fest.

Typ:BatchAccountContext
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-CommonEnvironmentSettings

Gibt die allgemeinen Umgebungsvariablen als Schlüssel-Wert-Paare an, die dieses Cmdlet für alle Aufgaben im Auftrag festlegt. Der Schlüssel ist der Name der Umgebungsvariable. Der Wert ist der Umgebungsvariablenwert.

Typ:IDictionary
Aliase:CommonEnvironmentSetting
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Constraints

Gibt die Ausführungseinschränkungen für den Auftrag an.

Typ:PSJobConstraints
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisplayName

Gibt den Anzeigenamen für den Auftrag an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Id

Gibt eine ID für den Auftrag an.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-JobManagerTask

Gibt die Aufgabe "Auftrags-Manager" an. Der Batchdienst führt die Auftrags-Manager-Aufgabe aus, wenn der Auftrag gestartet wird.

Typ:PSJobManagerTask
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobPreparationTask

Gibt den Vorgang "Auftragsvorbereitung" an. Der Batchdienst führt den Auftragvorbereitungsvorgang auf einem Computeknoten aus, bevor er Aufgaben dieses Auftrags auf diesem Computeknoten startet.

Typ:PSJobPreparationTask
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobReleaseTask

Gibt die Aufgabe "Auftragsfreigabe" an. Der Batchdienst führt die Auftragsfreigabeaufgabe aus, wenn der Auftrag endet. Der Batchdienst führt die Aufgabe "Auftragsfreigabe" auf jedem Computeknoten aus, in dem er eine Aufgabe des Auftrags ausgeführt hat.

Typ:PSJobReleaseTask
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Metadata

Gibt Metadaten als Schlüssel-Wert-Paare an, die dem Auftrag hinzugefügt werden sollen. Der Schlüssel ist der Metadatenname. Der Wert ist der Metadatenwert.

Typ:IDictionary
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OnAllTasksComplete

Gibt eine Aktion an, die der Batchdienst ausführt, wenn sich alle Aufgaben im Auftrag im abgeschlossenen Zustand befinden.

Typ:Nullable<T>[OnAllTasksComplete]
Zulässige Werte:NoAction, TerminateJob
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OnTaskFailure

Gibt eine Aktion an, die der Batchdienst ausführt, wenn eine Aufgabe im Auftrag fehlschlägt.

Typ:Nullable<T>[OnTaskFailure]
Zulässige Werte:NoAction, PerformExitOptionsJobAction
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PoolInformation

Gibt die Details des Pools an, in dem der Batchdienst die Aufgaben des Auftrags ausführt.

Typ:PSPoolInformation
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Priority

Gibt die Priorität des Auftrags an. Gültige Werte sind: ganze Zahlen von -1000 bis 1000. Ein Wert von -1000 ist die niedrigste Priorität. Der Wert 1000 ist die höchste Priorität. Der Standardwert ist 0.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UsesTaskDependencies

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Ausgaben