Remove-Variable
刪除變數和它的值。
Syntax
Remove-Variable
[-Name] <String[]>
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Scope <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Cmdlet Remove-Variable
會從定義變數的範圍中刪除變數及其值,例如目前的會話。 您無法使用此 Cmdlet 刪除設定為常數或系統所擁有的變數。
範例
範例 1︰移除變數
Remove-Variable Smp
此命令會 $Smp
刪除變數。
參數
-Confirm
在執行 Cmdlet 前提示您確認。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Exclude
指定此 Cmdlet 從作業省略之項目的陣列。 此參數的值會限定 Name 參數。 輸入名稱元素或模式,例如 "s*"。 允許使用萬用字元。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Force
指示 Cmdlet 移除變數,即使它是唯讀的。 即使使用 Force 參數,Cmdlet 也無法移除常數。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Include
指定此 Cmdlet 在作業中刪除之項目的陣列。 此參數的值會限定 Name 參數。 輸入名稱元素或模式,例如 s*。 允許使用萬用字元。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Name
指定要移除之變數的名稱。 參數名稱 (Name) 是選擇性的。 允許通配符
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Scope
只取得指定範圍內的變數。 此參數可接受的值為:
- 全球
- 本機
- 指令碼
- 相對於目前範圍的數字 (0 至範圍數目,0 為目前範圍,1 為其父系)。
Local 為預設值。 如需詳細資訊,請參閱 about_Scopes。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
您可以使用管線將變數物件傳送至此 Cmdlet。
輸出
None
此 Cmdlet 不會傳回任何輸出。
備註
PowerShell 包含下列的 Remove-Variable
別名:
所有平台:
rv
變更只會影響目前的範圍,例如工作階段。 若要從所有會話中刪除變數,請將命令新增
Remove-Variable
至您的PowerShell配置檔。