取得目前主控台中的變數。

語法

Get-Variable [[-Name] <string[]>] [-Exclude <string[]>] [-Include <string[]>] [-Scope <string>] [-ValueOnly] [<CommonParameters>]

描述

Get-Variable Cmdlet 會取得目前主控台中的 Windows PowerShell 變數。您可以指定 ValueOnly 參數,只擷取變數的值,然後依據名稱篩選傳回的變數。

參數

-Exclude <string[]>

忽略指定的項目。允許使用萬用字元。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-Include <string[]>

指定僅限此 Cmdlet 將對其執行的項目,排除其餘所有項目。允許使用萬用字元。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-Name <string[]>

指定變數的名稱。

必要?

false

位置?

1

預設值

接受管線輸入?

true (ByValue, ByPropertyName)

接受萬用字元?

false

-Scope <string>

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

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-ValueOnly

只取得變數的值。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

<CommonParameters>

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

輸入和輸出

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

輸入

System.String

您可經由管道將包含變數名稱的字串輸出至 Get-Variable。

輸出

Variable object

Get-Variable 會針對它取得的每一個變數各傳回一個 System.Management.Automation 變數物件。物件類型取決於變數。

附註

這個 cmdlet 並不管理環境變數。若要管理環境變數,您可以使用環境變數提供者。

範例 1

C:\PS>get-variable m*

描述
-----------
這個命令顯示名稱開頭為字母 "m" 的變數,同時也會顯示變數的值。






範例 2

C:\PS>get-variable m* -valueonly

描述
-----------
這個命令只顯示名稱開頭為字母 "m" 之變數的值。






範例 3

C:\PS>get-variable -include M*,P* | sort-object name

描述
-----------
這個命令會取得以字母 "M" 或字母 "P" 開頭之變數的相關資訊。結果會經由管道輸出至 Sort-Object Cmdlet,然後依據名稱排序後顯示出來。






範例 4

C:\PS>get-variable -scope 0

C:\PS> compare-object (get-variable -scope 0) (get-variable -scope 1)

描述
-----------
第一個命令只會取得定義在區域範圍中的變數。此命令相當於 "get-variable -scope local",而且可縮短為 "gv -s 0"。

第二個命令會使用 Compare-Object Cmdlet 找出定義在父範圍 (範圍 1) 但只顯示在區域範圍 (範圍 0) 中的變數。






請參閱




目錄