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是其父系）

本機是預設值。 如需詳細資訊，請參閱 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

您可以使用管線將變數物件傳送至此 Cmdlet。

輸出

None

此 Cmdlet 不會傳回任何輸出。

備註

PowerShell 包含下列的 Remove-Variable別名：

  • 所有平臺：

    • rv

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