Get-Variable
取得目前主控台中的變數。
語法
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。 |
輸出 |
變數物件 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) 中的變數。