New-AzBatchTask

Ссылка

Модуль:: Az.Batch

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

Синтаксис

New-AzBatchTask
   -JobId <String>
   -Id <String>
   [-DisplayName <String>]
   -CommandLine <String>
   [-ResourceFiles <PSResourceFile[]>]
   [-EnvironmentSettings <IDictionary>]
   [-AuthenticationTokenSettings <PSAuthenticationTokenSettings>]
   [-UserIdentity <PSUserIdentity>]
   [-AffinityInformation <PSAffinityInformation>]
   [-Constraints <PSTaskConstraints>]
   [-MultiInstanceSettings <PSMultiInstanceSettings>]
   [-DependsOn <TaskDependencies>]
   [-ApplicationPackageReferences <PSApplicationPackageReference[]>]
   [-OutputFile <PSOutputFile[]>]
   [-ExitConditions <PSExitConditions>]
   [-ContainerSettings <PSTaskContainerSettings>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzBatchTask
   -JobId <String>
   [-Tasks <PSCloudTask[]>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzBatchTask
   [-Job <PSCloudJob>]
   [-Tasks <PSCloudTask[]>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzBatchTask
   [-Job <PSCloudJob>]
   -Id <String>
   [-DisplayName <String>]
   -CommandLine <String>
   [-ResourceFiles <PSResourceFile[]>]
   [-EnvironmentSettings <IDictionary>]
   [-AuthenticationTokenSettings <PSAuthenticationTokenSettings>]
   [-UserIdentity <PSUserIdentity>]
   [-AffinityInformation <PSAffinityInformation>]
   [-Constraints <PSTaskConstraints>]
   [-MultiInstanceSettings <PSMultiInstanceSettings>]
   [-DependsOn <TaskDependencies>]
   [-ApplicationPackageReferences <PSApplicationPackageReference[]>]
   [-OutputFile <PSOutputFile[]>]
   [-ExitConditions <PSExitConditions>]
   [-ContainerSettings <PSTaskContainerSettings>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Описание

Командлет New-AzBatchTask создает задачу пакетная служба Azure в задании, указанном параметром JobId или параметром Job.

Примеры

Пример 1. Создание задачи пакетной службы

New-AzBatchTask -JobId "Job-000001" -Id "Task23" -CommandLine "cmd /c dir /s" -BatchContext $Context

Эта команда создает задачу с идентификатором Task23 в задании с идентификатором job-000001. Задача выполняет указанную команду. Используйте командлет Get-AzBatchAccountKey, чтобы назначить контекст переменной $Context.

Пример 2. Создание задачи пакетной службы

$autoUser = New-Object Microsoft.Azure.Commands.Batch.Models.PSAutoUserSpecification -ArgumentList @("Task", "Admin")
$userIdentity = New-Object Microsoft.Azure.Commands.Batch.Models.PSUserIdentity $autoUser
Get-AzBatchJob -Id "Job-000001" -BatchContext $Context | New-AzBatchTask -Id "Task26" -CommandLine "cmd /c echo hello > newFile.txt" -UserIdentity $userIdentity -BatchContext $Context

Эта команда получает пакетное задание с идентификатором job-000001 с помощью командлета Get-AzBatchJob . Команда передает это задание текущему командлету с помощью оператора конвейера. Команда создает задачу с идентификатором Task26 в этом задании. Задача выполняет указанную команду с помощью повышенных разрешений.

Пример 3. Добавление коллекции задач в указанное задание с помощью конвейера

$Context = Get-AzBatchAccountKey -AccountName "ContosoBatchAccount"
$Task01 = New-Object Microsoft.Azure.Commands.Batch.Models.PSCloudTask("Task23", "cmd /c dir /s")
$Task02 = New-Object Microsoft.Azure.Commands.Batch.Models.PSCloudTask("Task24", "cmd /c dir /s")
Get-AzBatchJob -Id "Job-000001" -BatchContext $Context | New-AzBatchTask -Tasks @($Task01, $Task02) -BatchContext $Context

Первая команда создает ссылку на объект ключи учетной записи для учетной записи пакетной службы ContosoBatchAccount с помощью Get-AzBatchAccountKey. Команда сохраняет ссылку на этот объект в переменной $Context. Следующие две команды создают объекты PSCloudTask с помощью командлета New-Object. Команды хранят задачи в переменных $Task 01 и $Task 02. Последняя команда получает пакетное задание с идентификатором job-000001 с помощью Get-AzBatchJob. Затем команда передает это задание текущему командлету с помощью оператора конвейера. Команда добавляет коллекцию задач в этом задании. Команда использует контекст, хранящийся в $Context.

Пример 4. Добавление коллекции задач в указанное задание

$Context = Get-AzBatchAccountKey -AccountName "ContosoBatchAccount"
$Task01 = New-Object Microsoft.Azure.Commands.Batch.Models.PSCloudTask("Task23", "cmd /c dir /s")
$Task02 = New-Object Microsoft.Azure.Commands.Batch.Models.PSCloudTask("Task24", "cmd /c dir /s")
New-AzBatchTask -JobId "Job-000001" -Tasks @($Task01, $Task02) -BatchContext $Context

Пример 5. Добавление задачи с выходными файлами

New-AzBatchTask -JobId "Job-000001" -Id "Task23" -CommandLine "cmd /c dir /s" -BatchContext $Context
$blobContainerDestination = New-Object Microsoft.Azure.Commands.Batch.Models.PSOutputFileBlobContainerDestination "https://myaccount.blob.core.windows.net/sascontainer?sv=2015-04-05&st=2015-04-29T22%3A18%3A26Z&se=2015-04-30T02%3A23%3A26Z&sr=b&sp=rw&spr=https&sig=Z%2FRHIX5Xcg0Mq2rqI3OlWTjEg2tYkboXr1P9ZUXDtkk%3D"
$destination = New-Object Microsoft.Azure.Commands.Batch.Models.PSOutputFileDestination $blobContainerDestination
$uploadOptions = New-Object Microsoft.Azure.Commands.Batch.Models.PSOutputFileUploadOptions "TaskSuccess"
$outputFile = New-Object Microsoft.Azure.Commands.Batch.Models.PSOutputFile "*.txt", $blobContainerDestination, $uploadOptions

New-AzBatchTask -JobId "Job-000001" -Id "Task23" -CommandLine "cmd /c dir /s" -OutputFile $outputFile -BatchContext $Context

Пример 6. Добавление задачи с параметрами маркера проверки подлинности

$authSettings = New-Object Microsoft.Azure.Commands.Batch.Models.PSAuthenticationTokenSettings
$authSettings.Access = "Job"
New-AzBatchTask -JobId "Job-000001" -Id "Task23" -CommandLine "cmd /c dir /s" -AuthenticationTokenSettings $authSettings -BatchContext $Context

Пример 7. Добавление задачи, которая выполняется в контейнере

$Context = Get-AzBatchAccountKey -AccountName "ContosoBatchAccount"
New-AzBatchTask -JobId "Job-000001" -Id "Task23" -CommandLine "cmd /c dir /s" -ContainerSettings (New-Object Microsoft.Azure.Commands.Batch.Models.PSTaskContainerSettings "containerImageName") -BatchContext $Context

Параметры

-AffinityInformation

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

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

-ApplicationPackageReferences

Type:	PSApplicationPackageReference[]
Aliases:	ApplicationPackageReference
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AuthenticationTokenSettings

Параметры маркера проверки подлинности, который задача может использовать для выполнения операций пакетной службы. Если это задано, пакетная служба предоставляет задачу маркером проверки подлинности, который можно использовать для проверки подлинности операций пакетной службы, не требуя ключа доступа к учетной записи. Маркер предоставляется с помощью переменной среды AZ_BATCH_AUTHENTICATION_TOKEN. Операции, которые задача может выполнять с помощью маркера, зависят от параметров. Например, задача может запрашивать разрешения задания, чтобы добавить другие задачи в задание или проверка состояние задания или других задач.

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

-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

-CommandLine

Указывает командную строку для задачи.

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

-Constraints

Указывает ограничения выполнения, которые применяются к этой задаче.

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

-ContainerSettings

Параметры контейнера, в котором выполняется задача. Если пул, который будет запускать эту задачу, имеет набор containerConfiguration, это также должно быть установлено. Если пул, который будет выполнять эту задачу, не имеет набора containerConfiguration, это не должно быть задано. При указании все каталоги рекурсивно под AZ_BATCH_NODE_ROOT_DIR (корнем каталогов пакетная служба Azure на узле) сопоставляются с контейнером, все переменные среды задач сопоставляются с контейнером, а командная строка задачи выполняется в контейнере.

Type:	PSTaskContainerSettings
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

-DependsOn

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

Type:	TaskDependencies
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

-EnvironmentSettings

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

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

-ExitConditions

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

-Id

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

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

-Job

Указывает задание, в котором этот командлет создает задачу. Чтобы получить объект PSCloudJob , используйте командлет Get-AzBatchJob.

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

-JobId

Указывает идентификатор задания, в котором этот командлет создает задачу.

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

-MultiInstanceSettings

Указывает сведения о выполнении задачи с несколькими экземплярами.

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

-OutputFile

Возвращает или задает список файлов, которые служба пакетной службы отправит из вычислительного узла после выполнения командной строки. Для задач с несколькими экземплярами файлы будут отправляться только с вычислительного узла, на котором выполняется основная задача.

Type:	PSOutputFile[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceFiles

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

Type:	PSResourceFile[]
Aliases:	ResourceFile
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tasks

Указывает коллекцию добавляемых задач. Каждая задача должна иметь уникальный идентификатор.

Type:	PSCloudTask[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UserIdentity

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

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

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

PSCloudJob

BatchAccountContext

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

Void

New-AzBatchTask

Синтаксис

Описание

Примеры

Пример 1. Создание задачи пакетной службы

Пример 2. Создание задачи пакетной службы

Пример 3. Добавление коллекции задач в указанное задание с помощью конвейера

Пример 4. Добавление коллекции задач в указанное задание

Пример 5. Добавление задачи с выходными файлами

Пример 6. Добавление задачи с параметрами маркера проверки подлинности

Пример 7. Добавление задачи, которая выполняется в контейнере

Параметры

-AffinityInformation

-ApplicationPackageReferences

-AuthenticationTokenSettings

-BatchContext

-CommandLine

-Constraints

-ContainerSettings

-DefaultProfile

-DependsOn

-DisplayName

-EnvironmentSettings

-ExitConditions

-Id

-Job

-JobId

-MultiInstanceSettings

-OutputFile

-ResourceFiles

-Tasks

-UserIdentity

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

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

Обратная связь

Дополнительные ресурсы

New-AzBatchTask

Синтаксис

Описание

Примеры

Пример 1. Создание задачи пакетной службы

Пример 2. Создание задачи пакетной службы

Пример 3. Добавление коллекции задач в указанное задание с помощью конвейера

Пример 4. Добавление коллекции задач в указанное задание

Пример 5. Добавление задачи с выходными файлами

Пример 6. Добавление задачи с параметрами маркера проверки подлинности

Пример 7. Добавление задачи, которая выполняется в контейнере

Параметры

-AffinityInformation

-ApplicationPackageReferences

-AuthenticationTokenSettings

-BatchContext

-CommandLine

-Constraints

-ContainerSettings

-DefaultProfile

-DependsOn

-DisplayName

-EnvironmentSettings

-ExitConditions

-Id

-Job

-JobId

-MultiInstanceSettings

-OutputFile

-ResourceFiles

-Tasks

-UserIdentity

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

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

Связанные ссылки

Обратная связь

Дополнительные ресурсы