Remove-AzBatchComputeNode
プールからコンピューティング ノードを削除します。
構文
Remove-AzBatchComputeNode
[-PoolId] <String>
[-Ids] <String[]>
[-DeallocationOption <ComputeNodeDeallocationOption>]
[-ResizeTimeout <TimeSpan>]
[-Force]
-BatchContext <BatchAccountContext>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Remove-AzBatchComputeNode
[[-ComputeNode] <PSComputeNode>]
[-DeallocationOption <ComputeNodeDeallocationOption>]
[-ResizeTimeout <TimeSpan>]
[-Force]
-BatchContext <BatchAccountContext>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
Remove-AzBatchComputeNode コマンドレットは、Azure Batch コンピューティング ノードをプールから削除します。
例
例 1: コンピューティング ノードを削除する
Remove-AzBatchComputeNode -PoolId "Pool07" -Ids "tvm-2316545714_1-20150725t213220z" -DeallocationOption Terminate -ResizeTimeout ([TimeSpan]::FromMinutes(10)) -BatchContext $Contextこのコマンドは、ID Pool07 を持つプールから、指定した ID を持つコンピューティング ノードを削除します。 このコマンドは、割り当て解除オプションを指定します。 サイズ変更のタイムアウトは 10 分です。
例 2: パイプラインを使用してコンピューティング ノードを削除する
Get-AzBatchComputeNode -PoolId "Pool07" -Id "tvm-2316545714_1-20150725t213220z" -BatchContext $Context | Remove-AzBatchComputeNode -Force -BatchContext $Contextこのコマンドは、Get-AzBatchComputeNode コマンドレットを使用して、ID Pool07 を持つプールから、指定された ID を持つコンピューティング ノードを取得します。 このコマンドは、パイプラインを使用してそのノードを現在のコマンドレットに渡します。 現在のコマンドレットは、コンピューティング ノードを削除します。 このコマンドは Force パラメーターを指定します。 したがって、このコマンドは確認を求めるメッセージを表示しません。
例 3: 複数のノードを削除する
Remove-AzBatchComputeNode -PoolId "Pool07" @("tvm-1783593343_28-20151117t214257z","tvm-1783593343_29-20151117t214257z") -Force -BatchContext $Contextこのコマンドは、ID Pool07 を持つプールから 2 つのコンピューティング ノードを削除します。 このコマンドは、確認を求めるメッセージを表示しません。
パラメーター
-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 |
-ComputeNode
このコマンドレットが削除する コンピューティング ノードを表す PSComputeNode オブジェクトを指定します。
| Type: | PSComputeNode |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeallocationOption
このコマンドレットが開始する削除操作の割り当て解除オプションを指定します。 既定値は Requeue です。
| 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 |
-Force
ユーザーに確認せずに、直ちにコマンドを実行します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Ids
このコマンドレットがプールから削除するコンピューティング ノードの ID の配列を指定します。
| Type: | String[] |
| Aliases: | Id |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PoolId
このコマンドレットが削除するコンピューティング ノードを含むプールの ID を指定します。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResizeTimeout
プールからコンピューティング ノードを削除するためのタイムアウト間隔を指定します。 既定値は 10 分です。 最小値は 5 分です。
| Type: | Nullable<T>[TimeSpan] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |