共用方式為

Remove-Variable

  • 參考
模組:
Microsoft.PowerShell.Utility

刪除變數和它的值。

Syntax

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

Description

Remove-Variable Cmdlet 會從定義變數的範圍中刪除變數及其值，例如目前的會話。 您無法使用此 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

輸入

PSVariable

您可以使用管線將變數物件傳送至 Remove-Variable。

輸出

None

此 Cmdlet 不會傳回任何輸出。

備註

  • 變更只會影響目前的範圍，例如工作階段。 若要從所有會話中刪除變數，請將命令新增 Remove-Variable 至您的PowerShell配置檔。

  • 您也可以Remove-Variable參考其內建別名 。 rv 如需詳細資訊，請參閱 about_Aliases。