Start-AzBatchPoolResize

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

プールのサイズ変更を開始します。

構文

Start-AzBatchPoolResize
     [-Id] <String>
     [-TargetDedicatedComputeNodes <Int32>]
     [-TargetLowPriorityComputeNodes <Int32>]
     [-ResizeTimeout <TimeSpan>]
     [-ComputeNodeDeallocationOption <ComputeNodeDeallocationOption>]
     -BatchContext <BatchAccountContext>
     [-DefaultProfile <IAzureContextContainer>]
     [<CommonParameters>]

説明

Start-AzBatchPoolResize コマンドレットは、プールで Azure Batch のサイズ変更操作を開始します。

例

例 1: プールのサイズを 12 ノードに変更する

Start-AzBatchPoolResize -Id "ContosoPool06" -TargetDedicatedComputeNodes 12 -BatchContext $Context

このコマンドは、ID ContosoPool06 を持つプールでサイズ変更操作を開始します。 操作のターゲットは、12 個の専用コンピューティング ノードです。 Get-AzBatchAccountKey コマンドレットを使用して、$Context変数にコンテキストを割り当てます。

例 2: 割り当て解除オプションを使用してプールのサイズを変更する

Get-AzBatchPool -Id "ContosoPool06" -BatchContext $Context | Start-AzBatchPoolResize -TargetDedicatedComputeNodes 5 -ResizeTimeout ([TimeSpan]::FromHours(1)) -ComputeNodeDeallocationOption ([Microsoft.Azure.Batch.Common.ComputeNodeDeallocationOption]::Terminate) -BatchContext $Context

このコマンドレットは、プールのサイズを 5 つの専用コンピューティング ノードに変更します。 このコマンドは、Get-AzBatchPool コマンドレットを使用して、ID ContosoPool06 を持つプールを取得します。 このコマンドは、パイプライン演算子を使用して、そのプール オブジェクトを現在のコマンドレットに渡します。 このコマンドは、プールでサイズ変更操作を開始します。 ターゲットは 5 つの専用コンピューティング ノードです。 このコマンドは、1 時間のタイムアウト期間を指定します。 このコマンドは、Terminate の割り当て解除オプションを指定します。

パラメーター

-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

-ComputeNodeDeallocationOption

このコマンドレットが開始するサイズ変更操作の割り当て解除オプションを指定します。

Type:Nullable<T>[ComputeNodeDeallocationOption]
Accepted values:Requeue, Terminate, TaskCompletion, RetainedData
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

-Id

このコマンドレットのサイズを変更するプールの ID を指定します。

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

-ResizeTimeout

サイズ変更操作のタイムアウト期間を指定します。 この時点までにプールがターゲット サイズに達しない場合、サイズ変更操作は停止します。

Type:Nullable<T>[TimeSpan]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TargetDedicatedComputeNodes

ターゲットの専用コンピューティング ノードの数。

Type:Nullable<T>[Int32]
Aliases:TargetDedicated
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TargetLowPriorityComputeNodes

ターゲットの優先順位の低いコンピューティング ノードの数。

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

String

BatchAccountContext

出力

Void