Udostępnij za pośrednictwem

New-AzBatchJob

Moduł:
Az.Batch Module

Tworzy zadanie w usłudze Batch.

Składnia

Default (domyślnie) 

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 pobrać element BatchAccountContext, Microsoft Entra uwierzytelnianie 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.

Właściwości parametru

Typ:BatchAccountContext
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:IDictionary
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:CommonEnvironmentSetting

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Constraints

Określa ograniczenia wykonywania zadania.

Właściwości parametru

Typ:PSJobConstraints
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DefaultProfile

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

Właściwości parametru

Typ:IAzureContextContainer
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DisplayName

Określa nazwę wyświetlaną zadania.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Id

Określa identyfikator zadania.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:0
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-JobManagerTask

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

Właściwości parametru

Typ:PSJobManagerTask
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:PSJobPreparationTask
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:PSJobReleaseTask
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Metadata

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

Właściwości parametru

Typ:IDictionary
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-OnAllTasksComplete

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

Właściwości parametru

Typ:

Nullable<T>[OnAllTasksComplete]

Domyślna wartość:None
Dopuszczalne wartości:NoAction, TerminateJob
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-OnTaskFailure

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

Właściwości parametru

Typ:

Nullable<T>[OnTaskFailure]

Domyślna wartość:None
Dopuszczalne wartości:NoAction, PerformExitOptionsJobAction
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-PoolInformation

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

Właściwości parametru

Typ:PSPoolInformation
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:Int32
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-UsesTaskDependencies

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

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

String

BatchAccountContext

Dane wyjściowe

Void