Get-AzBatchSubtask

  • リファレンス
モジュール:
Az.Batch

指定したタスクのサブタスク情報を取得します。

構文

Get-AzBatchSubtask
   [-JobId] <String>
   [-TaskId] <String>
   [-MaxCount <Int32>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzBatchSubtask
   [[-Task] <PSCloudTask>]
   [-MaxCount <Int32>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

説明

Get-AzBatchSubtask コマンドレットは、指定されたタスクに関するサブタスク情報を取得します。 サブタスクは、個々のタスクに並列処理を提供し、タスクの実行と進行状況を正確に監視できるようにします。

例

例 1: 指定したタスクのすべてのサブタスクを返す

$Context = Get-AzBatchAccountKey -AccountName "contosobatchaccount"
Get-AzBatchSubtask -JobId "Job-01" -TaskID "myTask" -BatchContext $Context

これらのコマンドは、ID myTask を持つタスクのすべてのサブタスクを返します。 これを行うには、この例の最初のコマンドで、バッチ アカウント contosobatchaccount のアカウント キーへのオブジェクト参照を作成します。 このオブジェクト参照は、$contextという名前の変数に格納されます。 2 番目のコマンドでは、そのオブジェクト参照と Get-AzBatchSubtask コマンドレットを使用して、ジョブ Job-01 の一部として実行されるタスク myTask のすべてのサブタスクを返します。

パラメーター

-BatchContext

このコマンドレットが Batch サービスとの対話に使用する BatchAccountContext インスタンスを指定します。 Get-AzBatchAccount コマンドレットを使用して BatchAccountContext を取得する場合、Batch サービスと対話するときに Microsoft Entra 認証が使用されます。 代わりに共有キー認証を使用するには、Get-AzBatchAccountKey コマンドレットを使用して、アクセス キーが設定された BatchAccountContext オブジェクトを取得します。 共有キー認証を使用する場合、プライマリ アクセス キーは既定で使用されます。 使用するキーを変更するには、BatchAccountContext.KeyInUse プロパティを設定します。

Type:BatchAccountContext
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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

-JobId

このコマンドレットが取得するサブタスクを持つタスクを含むジョブの ID を指定します。

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

-MaxCount

返されるサブタスクの最大数を指定します。 0 以下の値を指定した場合、このコマンドレットでは上限は使用されません。 既定値は 1000 です。

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

-Task

このコマンドレットが返すサブタスクを含むタスクへのオブジェクト参照を指定します。 このオブジェクト参照は、Get-AzBatchTask コマンドレットを使用して作成され、返されたオブジェクトを変数に格納します。

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

-TaskId

このコマンドレットが返すサブタスクを持つタスクの ID を指定します。

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

入力

String

PSCloudTask

BatchAccountContext

出力

PSSubtaskInformation