Udostępnij za pośrednictwem

New-AzBatchJob

  • Odwołanie
Moduł:
Az.Batch

Tworzy zadanie w usłudze Batch.

Składnia

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

Opis

Polecenie cmdlet New-AzBatchJob tworzy zadanie w usłudze Azure Batch na koncie określonym przez parametr BatchAccountContext .

Przykłady

Przykład 1. Tworzenie zadania

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

Pierwsze polecenie tworzy obiekt PSPoolInformation przy użyciu polecenia cmdlet New-Object. Polecenie przechowuje ten obiekt w zmiennej $PoolInformation. Drugie polecenie przypisuje właściwość Pool22 identyfikatora do właściwości PoolId obiektu w $PoolInformation. Ostatnie polecenie tworzy zadanie o identyfikatorze ContosoJob35. Zadania dodane do zadania podrzędnego są uruchamiane w puli z pulą identyfikatorów 22. Użyj polecenia cmdlet Get-AzBatchAccountKey, aby przypisać kontekst do zmiennej $Context.

Parametry

-BatchContext

Określa wystąpienie BatchAccountContext używane przez to polecenie cmdlet do interakcji z usługą Batch. Jeśli użyjesz polecenia cmdlet Get-AzBatchAccount, aby uzyskać element BatchAccountContext, uwierzytelnianie Microsoft Entra będzie używane podczas interakcji z usługą Batch. Aby zamiast tego użyć uwierzytelniania klucza współużytkowanego, użyj polecenia cmdlet Get-AzBatchAccountKey, aby uzyskać obiekt BatchAccountContext z wypełnionymi kluczami dostępu. W przypadku korzystania z uwierzytelniania za pomocą klucza współużytkowanego klucz podstawowy jest używany domyślnie. Aby zmienić klucz do użycia, ustaw właściwość BatchAccountContext.KeyInUse.

Typ:BatchAccountContext
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-CommonEnvironmentSettings

Określa typowe zmienne środowiskowe jako pary klucz/wartość, które to polecenie cmdlet ustawia dla wszystkich zadań w zadaniu. Klucz to nazwa zmiennej środowiskowej. Wartość jest wartością zmiennej środowiskowej.

Typ:IDictionary
Aliasy:CommonEnvironmentSetting
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Constraints

Określa ograniczenia wykonywania zadania.

Typ:PSJobConstraints
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DisplayName

Określa nazwę wyświetlaną zadania.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Id

Określa identyfikator zadania.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-JobManagerTask

Określa zadanie Menedżera zadań. Usługa Batch uruchamia zadanie Menedżera zadań po uruchomieniu zadania.

Typ:PSJobManagerTask
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-JobPreparationTask

Określa zadanie przygotowania zadania. Usługa Batch uruchamia zadanie przygotowania zadania w węźle obliczeniowym, zanim uruchomi wszystkie zadania tego zadania w tym węźle obliczeniowym.

Typ:PSJobPreparationTask
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-JobReleaseTask

Określa zadanie zwolnienia zadania. Usługa Batch uruchamia zadanie zwolnienia zadania po zakończeniu zadania. Usługa Batch uruchamia zadanie zwalniania zadań w każdym węźle obliczeniowym, w którym uruchomiono dowolne zadanie zadania.

Typ:PSJobReleaseTask
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Metadata

Określa metadane jako pary klucz/wartość, które mają zostać dodane do zadania. Klucz jest nazwą metadanych. Wartość to wartość metadanych.

Typ:IDictionary
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-OnAllTasksComplete

Określa akcję wykonywaną przez usługę Batch, jeśli wszystkie zadania w zadaniu są w stanie ukończonym.

Typ:Nullable<T>[OnAllTasksComplete]
Dopuszczalne wartości:NoAction, TerminateJob
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-OnTaskFailure

Określa akcję wykonywaną przez usługę Batch, jeśli jakiekolwiek zadanie w zadaniu zakończy się niepowodzeniem.

Typ:Nullable<T>[OnTaskFailure]
Dopuszczalne wartości:NoAction, PerformExitOptionsJobAction
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PoolInformation

Określa szczegóły puli, w której usługa Batch uruchamia zadania podrzędne zadania.

Typ:PSPoolInformation
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Priority

Określa priorytet zadania. Prawidłowe wartości to: liczby całkowite z -1000 do 1000. Wartość -1000 jest najniższym priorytetem. Wartość 1000 jest najwyższym priorytetem. Wartość domyślna to 0.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UsesTaskDependencies

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

BatchAccountContext

Dane wyjściowe

Void