Remove-Variable

刪除變數及其值。

語法

Remove-Variable [-Name] <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-Scope <string>] [-Confirm] [-WhatIf] [<CommonParameters>]

描述

Remove-Variable Cmdlet 會從定義變數的範圍 (如目前的主控台) 刪除變數及其值。您無法使用這個 cmdlet 來刪除設定為常數或系統所擁有的變數。

參數

-Exclude <string[]>

忽略指定的項目。此參數的值用於限定 Name 參數。輸入名稱元素或模式，例如 "s*"。允許使用萬用字元。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

-Force

允許此 Cmdlet 移除變數，即使它是唯讀的亦然。即便使用 Force 參數，此 Cmdlet 也無法移除常數。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

-Include <string[]>

只刪除指定的項目。此參數的值用於限定 Name 參數。輸入名稱元素或模式，例如 "s*"。允許使用萬用字元。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

-Name <string[]>

指定要移除的變數的名稱。參數名稱 ("Name") 為選擇項。

必要?	true
位置?	1
預設值
接受管線輸入?	true (ByPropertyName)
接受萬用字元?	false

-Scope <string>

指定此別名仍屬有效的範圍。有效的值包括 "Global"、"Local"、"Script" 或相對於目前範圍的數字 (從 0 到範圍總數，其中 0 代表目前範圍，1 代表其上層)。預設值為 "Local"。如需詳細資訊，請參閱 about_Scopes。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

-Confirm

在執行命令前先提示確認。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

-WhatIf

說明執行命令時將會發生何種情況，但不會實際執行命令。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

<CommonParameters>

這個 Cmdlet 支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊，請參閱 about_Commonparameters.

輸入和輸出

輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。

輸入	System.Management.Automation.PSVariable 您可經由管道將變數物件輸出至 Remove-Variable。
輸出	無 這個 Cmdlet 不會傳回任何輸出。

附註

變更效果僅限目前的範圍，如工作階段。若要從所有工作階段刪除變數，請將 Remove-Variable 命令新增至 Windows PowerShell 設定檔。

您也可以利用內建的別名 "rv" 來參照 RemoveVariable。如需詳細資訊，請參閱 about_Aliases。

範例 1

C:\PS>remove-variable Smp

描述
-----------
這個命令會刪除 $Smp 變數。

請參閱

概念

Set-Variable
Get-Variable
Clear-Variable
New-Variable
about_Profiles