Get-Variable
取得目前主控台中的變數。
Syntax
Get-Variable
[[-Name] <String[]>]
[-ValueOnly]
[-Include <String[]>]
[-Exclude <String[]>]
[-Scope <String>]
[<CommonParameters>]
Description
Cmdlet Get-Variable
會取得目前控制台中的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 從作業排除之項目的陣列。 允許使用萬用字元。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Include
指定 Cmdlet 會在其中作用的項目陣列,不包含其他所有項目。 允許使用萬用字元。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Name
指定變數的名稱。
允許使用萬用字元。
您也可以使用管線將變數名稱傳送至 Get-Variable
。
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | False |
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 |
-ValueOnly
指示此 Cmdlet 只取得變數的值。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
您可以使用管線將包含變數名稱的字串傳送至 Get-Variable
。
輸出
此 Cmdlet 會傳回它所取得之每個變數的 System.Management.AutomationPSVariable 物件。 物件類型會視變數而定。
Object[]
當您指定 ValueOnly 參數時,如果指定的變數值為集合,則會 Get-Variable
傳 [System.Object[]]
回 。 此行為可防止一般管線作業一次處理變數的值。 強制集合列舉的因應措施是以 Get-Variable
括弧括住命令。
備註
- 此 Cmdlet 並不會管理環境變數。 若要管理環境變數,您可以使用環境變數提供者。