Share via

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.

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

-CommonEnvironmentSettings

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

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

-Constraints

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

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

-DefaultProfile

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

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

-DisplayName

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

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

-Id

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

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

-JobManagerTask

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

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

-JobPreparationTask

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

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

-JobReleaseTask

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

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

-Metadata

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

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

-OnAllTasksComplete

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

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

-OnTaskFailure

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

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

-PoolInformation

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

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

-Priority

Указывает приоритет задания. Допустимые значения: целые числа от -1000 до 1000. Значение -1000 является самым низким приоритетом. Значение 1000 является самым высоким приоритетом. Значение по умолчанию равно 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

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

String

BatchAccountContext

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

Void