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 |