New-AzBatchJob

  • 參考
模組:
Az.Batch

在 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 屬性。 最後一個命令會建立標識碼為 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

指定作業的識別碼。

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