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 プロパティを設定します。
| 型: | BatchAccountContext |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ComputeNode
このコマンドレットが削除するコンピューティング ノードを表す PSComputeNode オブジェクトを指定します。
| 型: | PSComputeNode |
| 配置: | 0 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DeallocationOption
このコマンドレットが開始する削除操作の割り当て解除オプションを指定します。 既定値は Requeue です。
| 型: | Nullable<T>[ComputeNodeDeallocationOption] |
| 指定可能な値: | Requeue, Terminate, TaskCompletion, RetainedData |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
| 型: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Force
ユーザーに確認せずに、直ちにコマンドを実行します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Ids
このコマンドレットがプールから削除するコンピューティング ノードの ID の配列を指定します。
| 型: | String[] |
| Aliases: | Id |
| 配置: | 1 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PoolId
このコマンドレットが削除するコンピューティング ノードを含むプールの ID を指定します。
| 型: | String |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ResizeTimeout
プールからコンピューティング ノードを削除するためのタイムアウト間隔を指定します。 既定値は 10 分です。 最小値は 5 分です。
| 型: | Nullable<T>[TimeSpan] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |