Поделиться через

New-AzBatchJob

  • Ссылка
Модуль:
Az.Batch

Создает задание в пакетной службе.

Синтаксис

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

Описание

Командлет New-AzBatchJob создает задание в службе пакетной службы Azure в учетной записи, указанной параметром BatchAccountContext.

Примеры

Пример 1. Создание задания

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

Первая команда создает объект PSPoolInformation с помощью командлета New-Object. Команда сохраняет этот объект в переменной $PoolInformation. Вторая команда назначает идентификатор Pool22 свойству PoolId объекта в $PoolInformation. Последняя команда создает задание с идентификатором ContosoJob35. Задачи, добавленные в задание, выполняются в пуле с идентификатором Pool22. Используйте командлет Get-AzBatchAccountKey для назначения контекста переменной $Context.

Параметры

-BatchContext

Указывает экземпляр BatchAccountContext, используемый этим командлетом для взаимодействия со службой пакетной службы. Если вы используете командлет Get-AzBatchAccount для получения batchAccountContext, при взаимодействии со службой пакетной службы будет использоваться проверка подлинности Microsoft Entra. Чтобы использовать проверку подлинности с общим ключом, используйте командлет Get-AzBatchAccountKey, чтобы получить объект BatchAccountContext с заполненными ключами доступа. При использовании проверки подлинности общего ключа первичный ключ доступа используется по умолчанию. Чтобы изменить используемый ключ, задайте свойство BatchAccountContext.KeyInUse.

Тип:BatchAccountContext
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-CommonEnvironmentSettings

Указывает общие переменные среды в виде пар "ключ-значение", которые этот командлет задает для всех задач в задании. Ключ — это имя переменной среды. Значением является значение переменной среды.

Тип:IDictionary
Aliases:CommonEnvironmentSetting
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Constraints

Указывает ограничения выполнения для задания.

Тип:PSJobConstraints
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.

Тип:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisplayName

Указывает отображаемое имя задания.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Id

Указывает идентификатор задания.

Тип:String
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-JobManagerTask

Задает задачу диспетчера заданий. Пакетная служба запускает задачу Диспетчера заданий при запуске задания.

Тип:PSJobManagerTask
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-JobPreparationTask

Указывает задачу подготовки заданий. Пакетная служба запускает задачу подготовки заданий на вычислительном узле перед запуском любых задач этого задания на этом вычислительном узле.

Тип:PSJobPreparationTask
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-JobReleaseTask

Указывает задачу выпуска задания. Пакетная служба запускает задачу выпуска задания при завершении задания. Пакетная служба запускает задачу выпуска задания на каждом вычислительном узле, где она выполняла любую задачу задания.

Тип:PSJobReleaseTask
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Metadata

Указывает метаданные в виде пар "ключ-значение", добавляемого в задание. Ключ — это имя метаданных. Значением является значение метаданных.

Тип:IDictionary
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-OnAllTasksComplete

Указывает действие пакетной службы, если все задачи в задании находятся в состоянии завершения.

Тип:Nullable<T>[OnAllTasksComplete]
Допустимые значения:NoAction, TerminateJob
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-OnTaskFailure

Указывает действие пакетной службы, которое принимает, если какая-либо задача в задании завершается ошибкой.

Тип:Nullable<T>[OnTaskFailure]
Допустимые значения:NoAction, PerformExitOptionsJobAction
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PoolInformation

Указывает сведения о пуле, в котором служба пакетной службы выполняет задачи задания.

Тип:PSPoolInformation
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Priority

Указывает приоритет задания. Допустимые значения: целые числа от -1000 до 1000. Значение -1000 является самым низким приоритетом. Значение 1000 является самым высоким приоритетом. Значение по умолчанию — 0.

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-UsesTaskDependencies

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

String

BatchAccountContext

Выходные данные

Void