about_Variables

發行項
03/08/2024

簡短描述

描述變數如何儲存可在PowerShell中使用的值。

詳細描述

您可以將所有類型的值儲存在 PowerShell 變數中。例如，儲存命令的結果，並儲存命令和表達式中使用的專案，例如名稱、路徑、設定和值。

變數是儲存值的記憶體單位。在 PowerShell 中，變數會以以貨幣符號（$）開頭的文字字串表示，例如 $a、 $process或 $my_var。

變數名稱不區分大小寫，而且可以包含空格和特殊字元。但是，包含特殊字元和空格的變數名稱很難使用，因此應避免使用。如需詳細資訊，請參閱包含特殊字元的變數名稱。

PowerShell 中有數種不同類型的變數。

使用者建立的變數：使用者建立的變數是由使用者建立和維護。根據預設，您在 PowerShell 命令行上建立的變數只有在 PowerShell 視窗開啟時才存在。關閉 PowerShell 視窗時，會刪除變數。若要儲存變數，請將它新增至 PowerShell 配置檔。您也可以在具有全域、腳本或本機範圍的腳本中建立變數。
自動變數：自動變數會儲存PowerShell的狀態。這些變數是由 PowerShell 所建立，而 PowerShell 會視需要變更其值，以維持其精確度。用戶無法變更這些變數的值。例如， $PSHOME 變數會儲存PowerShell安裝目錄的路徑。

如需詳細資訊、清單和自動變數的描述，請參閱 about_Automatic_Variables。
喜好設定變數：喜好設定變數會儲存 PowerShell 的使用者喜好設定。這些變數是由 PowerShell 所建立，並填入預設值。用戶可以變更這些變數的值。例如， $MaximumHistoryCount 變數會決定會話歷程記錄中的項目數目上限。

如需詳細資訊、清單和喜好設定變數的描述，請參閱 about_Preference_Variables。

使用變數

若要建立新的變數，請使用 assignment 語句將值指派給變數。您不需要在使用它之前宣告變數。所有變數的預設值為 $null。

若要取得 PowerShell 工作階段中所有變數的清單，請輸入 Get-Variable。變數名稱會顯示，而沒有用來參考變數的前一個貨幣符號（$）符號。

例如：

$MyVariable = 1, 2, 3

$Path = "C:\Windows\System32"

變數可用於儲存命令的結果。

例如：

$Processes = Get-Process

$Today = (Get-Date).DateTime

若要顯示變數的值，請輸入變數名稱，前面加上貨幣符號（$）。

例如：

$MyVariable

1
2
3

$Today

Tuesday, September 3, 2019 09:46:46

若要變更變數的值，請將新的值指派給變數。

下列範例會顯示變數的值、變更變數的值 $MyVariable ，然後顯示新的值。

$MyVariable = 1, 2, 3
$MyVariable

1
2
3

$MyVariable = "The green cat."
$MyVariable

The green cat.

若要刪除變數的值，請使用 Clear-Variable Cmdlet 或將值變更為 $null。

Clear-Variable -Name MyVariable

$MyVariable = $null

若要刪除變數，請使用 Remove-Variable 或 Remove-Item。

Remove-Variable -Name MyVariable

Remove-Item -Path Variable:\MyVariable

您也可以使用一個語句將值指派給多個變數。下列範例會將相同的值指派給多個變數：

$a = $b = $c = 0

下一個範例會將多個值指派給多個變數。

$i,$j,$k = 10, "red", $true    # $i is 10, $j is "red", $k is True
$i,$j = 10, "red", $true       # $i is 10, $j is [object[]], Length 2

如需詳細資訊，請參閱about_Assignment_Operators的指派多個變數一節。

變數類型

您可以將任何類型的物件儲存在變數中，包括整數、字串、陣列和哈希表。而且，代表進程、服務、事件記錄檔和計算機的物件。

PowerShell 變數是鬆散類型，這表示它們不限於特定類型的物件。單一變數甚至可以同時包含不同類型的物件集合或陣列。

變數的數據類型是由變數值的 .NET 類型所決定。若要檢視變數的物件類型，請使用 Get-Member。

例如：

$a = 12                         # System.Int32
$a = "Word"                     # System.String
$a = 12, "Word"                 # array of System.Int32, System.String
$a = Get-ChildItem C:\Windows   # FileInfo and DirectoryInfo types

您可以使用類型屬性和轉換表示法，確保變數只能包含可轉換成該類型的特定物件類型或物件。如果您嘗試指派另一個類型的值，PowerShell 會嘗試將值轉換成其類型。如果無法轉換類型，指派語句就會失敗。

若要使用轉換表示法，請在變數名稱之前輸入以括弧括住的類型名稱（在指派語句的左側）。下列範例會 $number 建立只能包含整數的變數、 $words 只能包含字串的變數，以及 $dates 只能 包含 DateTime 物件的變數。

[int]$number = 8
$number = "12345"  # The string is converted to an integer.
$number = "Hello"

Cannot convert value "Hello" to type "System.Int32". Error: "Input string
was not in a correct format."
At line:1 char:1
+ $number = "Hello"
+ ~~~~~~~~~~~~~~~~~
+ CategoryInfo          : MetadataError: (:) [],
    ArgumentTransformationMetadataException
+ FullyQualifiedErrorId : RuntimeException

[string]$words = "Hello"
$words = 2       # The integer is converted to a string.
$words += 10     # The plus (+) sign concatenates the strings.
$words

[datetime] $dates = "09/12/91"  # The string is converted to a DateTime object.
$dates

Thursday, September 12, 1991 00:00:00

$dates = 10    # The integer is converted to a DateTime object.
$dates

Monday, January 1, 0001 00:00:00

在命令和表達式中使用變數

若要在命令或表示式中使用變數，請輸入變數名稱，前面加上 dollar （$）符號。

如果變數名稱和貨幣符號未以引弧括住，或以雙引號括"住，變數的值會用在命令或表達式中。

如果變數名稱和貨幣符號以單引號（'）標記括住，則會在表達式中使用變數名稱。

如需在PowerShell中使用引號的詳細資訊，請參閱 about_Quoting_Rules。

這個範例會取得變數的值 $PROFILE ，這是 PowerShell 控制台中 PowerShell 使用者配置檔檔案的路徑。

$PROFILE

C:\Users\User01\Documents\PowerShell\Microsoft.PowerShell_profile.ps1

在此範例中，會顯示兩個命令，可在 notepad.exe中開啟 PowerShell 配置檔。具有雙引號（"）標記的範例會使用變數的值。

notepad $PROFILE

notepad "$PROFILE"

下列範例使用將變數視為常值文字的單引號（'）標記。

'$PROFILE'

$PROFILE

'Use the $PROFILE variable.'

Use the $PROFILE variable.

包含特殊字元的變數名稱

變數名稱以貨幣（$）符號開頭，可以包含英數位元和特殊字元。變數名稱長度只受限於可用的記憶體。

最佳做法是變數名稱只包含英數位元和底線（_）字元。包含空格和其他特殊字元的變數名稱難以使用，因此應避免使用。

英數位元變數名稱可以包含下列字元：

這些類別的 Unicode 字元：Lu、Ll、Lt、Lm、Lo 或 Nd。
底線（_）字元。
問號（?）字元。

下列清單包含 Unicode 類別描述。如需詳細資訊，請參閱 UnicodeCategory。

Lu - UppercaseLetter
Ll - LowercaseLetter
Lt - TitlecaseLetter
Lm - ModifierLetter
Lo - OtherLetter
Nd - DecimalDigitNumber

若要建立或顯示包含空格或特殊字元的變數名稱，請使用大括號（{}）字元括住變數名稱。大括弧會指示PowerShell將變數名稱的字元解譯為常值。

特殊字元變數名稱可以包含下列字元：

任何 Unicode 字元，但有下列例外狀況：
- 右大括弧（}）字元（U+007D）。
- 反引號字元` （U+0060）。反引號用來逸出 Unicode 字元，使其被視為常值。

PowerShell 具有包含英數位元和特殊字元的保留變數，例如$$、 $?$^$_ 和。如需詳細資訊，請參閱 about_Automatic_Variables。

例如，下列命令會建立名為的 save-items變數。因為變數名稱包含連字元（）特殊字元，因此需要大括號{} （-）。

${save-items} = "a", "b", "c"
${save-items}

a
b
c

下列命令會取得環境變數所 ProgramFiles(x86) 表示之目錄中的子專案。

Get-ChildItem ${env:ProgramFiles(x86)}

若要參考包含大括號的變數名稱，請以大括弧括住變數名稱，並使用反引號字元逸出大括弧。例如，若要建立名為 this{value}is 類型的變數：

${this`{value`}is} = "This variable name uses braces and backticks."
${this`{value`}is}

This variable name uses braces and backticks.

變數和範圍

根據預設，變數只能在建立變數的範圍中使用。

例如，您在函式中建立的變數只能在函式內使用。您在文稿中建立的變數只能在腳本中使用。如果您以點來源撰寫腳本，變數就會新增至目前的範圍。如需詳細資訊，請參閱 about_Scopes。

您可以使用範圍修飾詞來變更變數的預設範圍。下列表達式會建立名為的 Computers變數。變數具有全域範圍，即使在腳本或函式中建立變數也一樣。

$Global:Computers = "Server01"

針對任何在會話外執行的腳本或命令，您需要 Using 範圍修飾詞來內嵌來自呼叫會話範圍的變數值，讓會話程序代碼可以存取它們。

如需詳細資訊，請參閱 about_Remote_Variables。

儲存變數

您建立的變數只能在您建立它們的會話中使用。當您關閉工作階段時，它們就會遺失。

若要在您啟動的每個 PowerShell 工作階段中建立變數，請將變數新增至 PowerShell 配置檔。

例如，若要變更每個 PowerShell 工作階段中的變數值 $VerbosePreference ，請將下列命令新增至 PowerShell 配置檔。

$VerbosePreference = "Continue"

您可以在文字編輯器中開啟 $PROFILE 檔案，例如 notepad.exe，將此命令新增至 PowerShell 配置檔。如需 PowerShell 配置檔的詳細資訊，請參閱 about_Profiles。

變數：磁碟驅動器

PowerShell 變數提供者會建立看起來像 Variable: 文件系統磁碟驅動器的磁碟驅動器，但它包含會話中的變數及其值。

若要變更為 Variable: 磁碟驅動器，請使用下列命令：

Set-Location Variable:

若要列出磁碟驅動器中的 Variable: 專案和變數，請使用 Get-Item 或 Get-ChildItem Cmdlet。

Get-ChildItem Variable:

若要取得特定變數的值，請使用檔案系統表示法來指定磁碟驅動器的名稱和變數的名稱。例如，若要取得 $PSCulture 自動變數，請使用下列命令。

Get-Item Variable:\PSCulture

Name                           Value
----                           -----
PSCulture                      en-US

若要顯示磁碟驅動器和 PowerShell 變數提供者的詳細資訊 Variable: ，請輸入：

Get-Help Variable

具有提供者路徑的變數語法

您可以在提供者路徑前面加上貨幣（$）符號，並存取任何實作 IContentCmdletProvider 介面的提供者內容。

下列內建 PowerShell 提供者支援此表示法：

變數 Cmdlet

PowerShell 包含一組設計用來管理變數的 Cmdlet。

若要列出 Cmdlet，請輸入：

Get-Command -Noun Variable

若要取得特定 Cmdlet 的說明，請輸入：

Get-Help <cmdlet-name>

Cmdlet 名稱	描述
`Clear-Variable`	刪除變數的值。
`Get-Variable`	取得目前控制台中的變數。
`New-Variable`	建立新變數。
`Remove-Variable`	刪除變數及其值。
`Set-Variable`	變更變數的值。

共用方式為