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

Der erste Befehl erstellt ein PSPoolInformation-Objekt mithilfe des Cmdlets New-Object. Der Befehl speichert dieses Objekt in der $PoolInformation Variablen. Der zweite Befehl weist die ID Pool22 der PoolId-Eigenschaft des Objekts in $PoolInformation zu. 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.

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

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

-Constraints

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

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

-DefaultProfile

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

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

-DisplayName

Gibt den Anzeigenamen für den Auftrag an.

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

-Id

Gibt eine ID für den Auftrag an.

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

-JobManagerTask

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

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

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

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

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

-OnAllTasksComplete

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

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

-OnTaskFailure

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

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

-PoolInformation

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

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

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

Eingaben

String

BatchAccountContext

Ausgaben

Void