Get-Variable
取得目前控制台中的變數。
語法
Default (預設值)
Get-Variable
[[-Name] <String[]>]
[-ValueOnly]
[-Include <String[]>]
[-Exclude <String[]>]
[-Scope <String>]
[<CommonParameters>]
Description
Get-Variable Cmdlet 會取得目前控制台中的 PowerShell 變數。
您可以只藉由指定 ValueOnly 參數來擷取變數的值，而且您可以篩選依名稱傳回的變數。
範例
範例 1：依字母取得變數
此命令會取得名稱開頭為字母 m 的變數。 此命令也會取得變數的值。
Get-Variable m*
範例 2：依字母取得變數值
此命令只會取得名稱開頭為 m 的變數值。
Get-Variable m* -ValueOnly
範例 3：以兩個字母取得變數
此命令會取得以字母 M 或字母 P 開頭之變數的相關信息。
Get-Variable -Include M*,P*
範例 4：依範圍取得變數
第一個指令只會取得在本機範圍中定義的變數。
它相當於 Get-Variable -Scope Local，而且可以縮寫為 gv -s 0。
第二個命令會使用 Compare-Object Cmdlet 來尋找父範圍 （範圍 1） 中所定義的變數，但只能在本機範圍 （範圍 0） 中看到。
Get-Variable -Scope 0
Compare-Object (Get-Variable -Scope 0) (Get-Variable -Scope 1)
參數
-Exclude
指定此 Cmdlet 從作業中排除的項目列表。 允許使用通配符。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | True |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Include
指定 Cmdlet 將採取動作的項目數組，排除所有其他項目。 允許使用通配符。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | True |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Name
指定變數的名稱。
允許使用通配符。
您也可以將變數名稱透過管線傳送至 Get-Variable。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | True |
| 不要顯示: | False |
參數集
(All)
| Position: | 0 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Scope
指定範圍中的變數。此參數可接受的值為：
- 全球
- 本地
- 指令碼
- 相對於目前範圍的數字（0 到範圍的總數，其中0是目前的範圍，1是其父系）
本地 是預設。 如需詳細資訊，請參閱 about_Scopes。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ValueOnly
表示此 Cmdlet 只會取得變數的值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸入
String
您可以將包含變數名稱的字串透過管線傳送至此 cmdlet。
輸出
PSVariable
根據預設，此 Cmdlet 會針對它取得的每個變數傳回 AutomationPSVariable 物件。 物件類型取決於變數。
Object
當您指定 ValueOnly 參數，而指定的變數值是集合時，這個 Cmdlet 會傳回 [System.Object[]]。 此行為阻止管線正常運行逐一處理變數的值。 強制集合列舉的因應措施是將 Get-Variable 命令括在括弧中。
備註
PowerShell 包含下列 Get-Variable的別名：
所有平臺：
gv
此 Cmdlet 不會管理環境變數。 若要管理環境變數，您可以使用環境提供者。
