HOME > Variable系コマンドレット > Remove-Variable
Remove-Variable
Remove-Variableは、変数の定義を削除するコマンドです。
エイリアスrv
解説
変数の定義自体を削除します。
PowerShellが自動で定義する変数や定数は削除できません。
変数の値のみをクリアしたい場合は、Clear-Variableをご使用ください。
構文
- （構文）
- Remove-Variable [-Name] <string[]> [<CommonParameters>]
| パラメータ | 説明 |
|---|---|
| -Name 変数名 | 対象の変数を指定する |
| -Include 文字列 | 指定した文字列を対象に含める （ワイルドカード使用可） |
| -Exclude 文字列 | 指定した文字列を対象から除外する （ワイルドカード使用可） |
| -Force | 強制的に実行する |
| -Scope 値 | 対象とするスコープを指定する ・Global：どこからでもアクセス可能 ・Local：現在のスコープのみアクセス可能（デフォルト） ・Script：スクリプト内のみアクセス可能 |
| -WhatIf | 実行はせずに実行結果の確認のみ行う |
| -Confirm | 実行前に確認メッセージの表示を行う |
共通的なパラメータは「共通パラメータ」をご覧ください。
サンプル
変数aを削除する
Remove-Variable -Name a
変数aと変数bを削除する
Remove-Variable -Name a,b
コマンドのヘルプを表示する
Get-Help Remove-Variable
備考
- パラメータ名の「-Name」は省略可能です。
関連項目
- Variable系コマンドレット
- Get-Variable：変数を取得する
- Set-Variable：変数を設定する
- New-Variable：変数を作成する
- Clear-Variable：変数の値をクリアする
- Remove-Variable：変数の定義を削除する
