다음을 통해 공유


New-AzBatchJob

Batch 서비스에서 작업을 만듭니다.

Syntax

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

Description

New-AzBatchJob cmdlet은 BatchAccountContext 매개 변수로 지정된 계정의 Azure Batch 서비스에서 작업을 만듭니다.

예제

예제 1: 작업 만들기

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

첫 번째 명령은 New-Object cmdlet을 사용하여 PSPoolInformation 개체를 만듭니다. 명령은 해당 개체를 $PoolInformation 변수에 저장합니다. 두 번째 명령은 id Pool22를 $PoolInformation 개체의 PoolId 속성에 할당합니다. 마지막 명령은 ID ContosoJob35가 있는 작업을 만듭니다. 작업에 추가된 작업은 ID Pool22가 있는 풀에서 실행됩니다. Get-AzBatchAccountKey cmdlet을 사용하여 $Context 변수에 컨텍스트를 할당합니다.

매개 변수

-BatchContext

이 cmdlet이 Batch 서비스와 상호 작용하는 데 사용하는 BatchAccountContext 인스턴스를 지정합니다. Get-AzBatchAccount cmdlet을 사용하여 BatchAccountContext를 가져오는 경우 Batch 서비스와 상호 작용할 때 Microsoft Entra 인증이 사용됩니다. 대신 공유 키 인증을 사용하려면 Get-AzBatchAccountKey cmdlet을 사용하여 액세스 키가 채워진 BatchAccountContext 개체를 가져옵니다. 공유 키 인증을 사용하는 경우 기본 액세스 키가 기본적으로 사용됩니다. 사용할 키를 변경하려면 BatchAccountContext.KeyInUse 속성을 설정합니다.

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

-CommonEnvironmentSettings

이 cmdlet이 작업의 모든 작업에 대해 설정하는 공통 환경 변수를 키/값 쌍으로 지정합니다. 키는 환경 변수 이름입니다. 값은 환경 변수 값입니다.

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

작업의 ID를 지정합니다.

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

-JobManagerTask

작업 관리자 작업을 지정합니다. Batch 서비스는 작업이 시작될 때 작업 관리자 작업을 실행합니다.

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

-JobPreparationTask

작업 준비 태스크를 지정합니다. Batch 서비스는 해당 컴퓨팅 노드에서 해당 작업의 작업을 시작하기 전에 컴퓨팅 노드에서 작업 준비 태스크를 실행합니다.

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

-JobReleaseTask

작업 릴리스 작업을 지정합니다. Batch 서비스는 작업이 종료될 때 작업 릴리스 작업을 실행합니다. Batch 서비스는 작업의 모든 작업을 실행한 각 컴퓨팅 노드에서 작업 릴리스 작업을 실행합니다.

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

작업의 모든 작업이 완료된 상태인 경우 Batch 서비스에서 수행하는 작업을 지정합니다.

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

-OnTaskFailure

작업의 작업이 실패할 경우 Batch 서비스에서 수행하는 작업을 지정합니다.

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

-PoolInformation

Batch 서비스가 작업의 작업을 실행하는 풀의 세부 정보를 지정합니다.

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