關於陣列
簡短描述
描述陣列，這是設計來儲存專案集合的數據結構。
完整描述
數位是設計來儲存專案集合的數據結構。 專案可以是相同類型或不同的類型。
從 Windows PowerShell 3.0 開始，零或一個 物件的集合具有陣列的某些屬性。
建立和初始化陣列
若要建立和初始化陣列，請將多個值指派給變數。 儲存在陣列中的值會以逗號分隔，並以指派運算符分隔變數名稱 (=) 。
例如，若要建立名為 $A 的陣列，其中包含22、5、10、8、12、9和80的七個數值 (int) 值，請輸入：
$A = 22,5,10,8,12,9,80
逗號也可以用來初始化單一項目數位，方法是將逗號放在單一專案之前。
例如，若要建立名為 的單 $B 一項目數位，其中包含7的單一值，請輸入：
$B = ,7
您也可以使用範圍運算子 () .. 來建立和初始化數位。
下列範例會建立包含值 5 到 8 的陣列。
$C = 5..8
因此， $C 包含四個值：5、6、7 和 8。
未指定數據類型時，PowerShell 會建立每個數位做為物件陣列， (System.Object[]) 。 若要判斷陣列的數據類型，請使用 GetType () 方法。 例如，若要判斷陣列的 $A 資料類型，請輸入：
$A.GetType()
若要建立強型別陣列，也就是只能包含特定型別值的陣列，請將變數轉換成數位類型，例如 string[]、long[]或 int32[]。 若要轉換陣列，請在變數名稱前面加上括弧括住的陣列類型。 例如，若要建立名為的 32 位整數陣列，其中包含 $ia 四個整數， (1500、2230、3350 和 4000) ，請輸入：
[int32[]]$ia = 1500,2230,3350,4000
因此， $ia 陣列只能包含整數。
您可以在 Microsoft .NET Framework 中建立轉換成任何支援類型的陣列。 例如，擷取以表示進程的對象 Get-Process 屬於 System.Diagnostics.Process 類型。 若要建立進程物件的強型別數位列，請輸入下列命令：
[Diagnostics.Process[]]$zz = Get-Process
陣列子表達式運算子
陣列子表達式運算子會從其內的語句建立陣列。 運算子內的任何語句都會產生，運算子會將它放在陣列中。 即使有零或一個 物件也一樣。
陣列運算子的語法如下所示：
@( ... )
您可以使用數位運算子來建立零或一個物件的陣列。 例如：
$a = @("Hello World")
$a.Count
1
$b = @()
$b.Count
0
當您取得物件時，陣列運算子在腳本中很有用，但不知道您取得的物件數目。 例如：
$p = @(Get-Process Notepad)
如需數位子表示式運算子的詳細資訊，請參閱 about_Operators。
存取和使用陣列元素
讀取陣列
您可以使用數位的變數名稱來參考數位。 若要顯示陣列中的所有專案，請輸入數位名稱。 例如，假設 $a 是包含整數 0、1、2 到 9 的陣列;輸入：
$a
0
1
2
3
4
5
6
7
8
9
您可以使用索引，從位置 0 開始參考陣列中的專案。 以括弧括住索引編號。 例如，若要顯示陣列中的 $a 第一個專案，請輸入：
$a[0]
0
若要在陣列中 $a 顯示第三個專案，請輸入：
$a[2]
2
您可以使用索引的範圍運算符來擷取陣列的一部分。 例如，若要擷取陣列的第二到第五個元素，您可以輸入：
$a[1..4]
1
2
3
4
陣組結尾的負數計數。 例如，“-1” 是指數組的最後一個專案。 若要顯示陣列的最後三個專案，請依索引遞增順序輸入：
$a = 0 .. 9
$a[-3..-1]
7
8
9
如果您以遞減順序輸入負數索引，則輸出會變更。
$a = 0 .. 9
$a[-1..-3]
9
8
7
不過，使用此表示法時請小心。 表示法會從結束界限迴圈到陣列的開頭。
$a = 0 .. 9
$a[2..-2]
2
1
0
9
8
此外，一個常見的錯誤是假設 $a[0..-2] 是指數組的所有元素，但最後一個元素除外。 它是指數組中的第一個、最後一個和第二個元素。
您可以使用加號運算子 (+) ，將範圍與陣列中的專案清單結合。 例如，若要在索引位置 0、2 和 4 到 6 顯示元素，請輸入：
$a = 0 .. 9
$a[0,2+4..6]
0
2
4
5
6
此外，若要列出多個範圍和個別元素，您可以使用 plus 運算符。 例如，若要列出零到二的專案、四到六，以及第八個位置類型的元素：
$a = 0..9
$a[+0..2+4..6+8]
0
1
2
4
5
6
8
陣列元素上的反覆專案
您也可以使用迴圈建構，例如 ForEach、For 和 While 循環，來參考數位中的專案。 例如，若要使用 ForEach 循環來顯示陣列中的 $a 元素，請輸入：
$a = 0..9
foreach ($element in $a) {
$element
}
0
1
2
3
4
5
6
7
8
9
Foreach 循環會逐一查看數位，並傳回數位列中的每個值，直到到達數位結尾為止。
當您在檢查陣列中的元素時，For 循環在遞增計數器時很有用。 例如，若要使用 For 循環傳回數位中的其他每個值，請輸入：
$a = 0..9
for ($i = 0; $i -le ($a.length - 1); $i += 2) {
$a[$i]
}
0
2
4
6
8
您可以使用 While 循環來顯示陣列中的元素，直到定義的條件不再成立為止。 例如，若要在陣列索引小於 4 時顯示陣列中的 $a 元素，請輸入：
$a = 0..9
$i=0
while($i -lt 4) {
$a[$i];
$i++
}
0
1
2
3
陣列的屬性
Count 或 Length 或 LongLength
若要判斷陣列中的項目數目，請使用 Length 屬性或其 Count 別名。 Longlength 如果陣列包含超過 2,147,483,647 個元素，則很有用。
$a = 0..9
$a.Count
$a.Length
10
10
Rank
傳回陣列中的維度數目。 PowerShell 中的大部分數位只有一個維度。 即使您認為要建置多維度陣列也一般;如下列範例所示：
$a = @(
@(0,1),
@("b", "c"),
@(Get-Process)
)
[int]$r = $a.Rank
"`$a rank: $r"
$a rank: 1
下列範例示範如何使用 .Net Framework 建立真正的多維度陣列。
[int[,]]$rank2 = [int[,]]::new(5,5)
$rank2.rank
2
陣列的方法
清除
將所有專案值設定為陣列專案類型的 預設值 。 Clear () 方法不會重設數位大小。
在下列範例 $a 中，是對象的陣列。
$a = 1, 2, 3
$a.Clear()
$a | % { $null -eq $_ }
True
True
True
在此範例中， $intA 會明確輸入 ，以包含整數。
[int[]] $intA = 1, 2, 3
$intA.Clear()
$intA
0
0
0
ForEach
允許逐一查看陣列中的所有專案，並針對數位的每個元素執行指定的作業。
ForEach 方法有數個執行不同作業的多載。
ForEach(scriptblock expression)
ForEach(scriptblock expression, object[] arguments)
ForEach(type convertToType)
ForEach(string propertyName)
ForEach(string propertyName, object[] newValue)
ForEach(string methodName)
ForEach(string methodName, object[] arguments)
ForEach (scriptblock 表達式)
ForEach (scriptblock 表達式，object[] 自變數)
這個方法已在PowerShell v4中新增。
注意
語法需要使用腳本區塊。 如果 scriptblock 是唯一的參數，則括弧是選擇性的。 此外，方法與左括弧或大括弧之間不得有空格。
下列範例示範如何使用 foreach 方法。 在此情況下，意圖是產生陣列中專案的平方值。
$a = @(0 .. 3)
$a.ForEach({ $_ * $_})
0
1
4
9
就像 的 -ArgumentListForEach-Object參數一 arguments 樣，參數允許將自變數陣列傳遞至設定為接受它們的腳本區塊。
如需 ArgumentList 行為的詳細資訊，請參閱 about_Splatting。
ForEach (類型 convertToType)
方法 ForEach 可用來將元素快速轉換成不同的類型;下列範例示範如何將字串日期 [DateTime] 清單轉換成類型。
@("1/1/2017", "2/1/2017", "3/1/2017").ForEach([datetime])
Sunday, January 1, 2017 12:00:00 AM
Wednesday, February 1, 2017 12:00:00 AM
Wednesday, March 1, 2017 12:00:00 AM
ForEach (string propertyName)
ForEach (string propertyName， object[] newValue)
方法 ForEach 也可以用來快速擷取或設定集合中每個項目的屬性值。
# Set all LastAccessTime properties of files to the current date.
(dir 'C:\Temp').ForEach('LastAccessTime', (Get-Date))
# View the newly set LastAccessTime of all items, and find Unique entries.
(dir 'C:\Temp').ForEach('LastAccessTime') | Get-Unique
Wednesday, June 20, 2018 9:21:57 AM
ForEach (string methodName)
ForEach (string methodName， object[] 自變數)
最後， ForEach 方法可以用來在集合中的每個專案上執行方法。
("one", "two", "three").ForEach("ToUpper")
ONE
TWO
THREE
就像的參數ForEach-Object一-ArgumentList樣，參數arguments允許將自變數陣列傳遞至設定為接受這些自變數的腳本區塊。
注意
從 Windows PowerShell 3.0 開始擷取屬性，以及針對集合中的每個項目執行方法，也可以使用「純量物件和集合的方法」來完成。您可以在這裡深入瞭解about_methods。
其中
允許篩選或選取陣列的專案。 腳本必須評估為與下列專案不同的：零 (0) 、空字串， $false 或 $null 專案在 之後顯示 Where
方法有一個定義 Where 。
Where(scriptblock expression[, WhereOperatorSelectionMode mode
[, int numberToReturn]])
注意
語法需要使用腳本區塊。 如果 scriptblock 是唯一的參數，則括弧是選擇性的。 此外，方法與左括弧或大括弧之間不得有空格。
Expression是篩選所需的 scriptblock、mode選擇性自變數允許其他選取功能，而numberToReturn選擇性自變數允許限制從篩選傳回的項目數目。
可接受的值為 mode ：
- 默認 (0) - 傳回所有專案
- 第一 (1) - 傳回第一個專案
- 上次 (2) - 傳回最後一個專案
- SkipUntil (3) - 在條件為 true 之前略過專案，傳回其餘專案
- 直到 (4) - 傳回所有專案，直到條件為 true 為止
- 分割 (5) - 傳回兩個元素的陣列
- 第一個專案包含相符的專案
- 第二個專案包含其餘專案
下列範例示範如何從陣列中選取所有奇數。
(0..9).Where{ $_ % 2 }
1
3
5
7
9
此範例示範如何選取非空白的字串。
('hi', '', 'there').Where({$_.Length})
hi
there
Default
模式會 Default 使用 Expression scriptblock 來篩選專案。
numberToReturn如果提供 ，它會指定要傳回的項目數目上限。
# Get the zip files in the current users profile, sorted by LastAccessTime.
$Zips = dir $env:userprofile -Recurse '*.zip' | Sort-Object LastAccessTime
# Get the least accessed file over 100MB
$Zips.Where({$_.Length -gt 100MB}, 'Default', 1)
注意
Default模式和First模式都會傳回第一個 (numberToReturn) 專案，而且可以交換使用。
Last
$h = (Get-Date).AddHours(-1)
$logs = dir 'C:\' -Recurse '*.log' | Sort-Object CreationTime
# Find the last 5 log files created in the past hour.
$logs.Where({$_.CreationTime -gt $h}, 'Last', 5)
SkipUntil
模式 SkipUntil 會略過集合中的所有物件，直到對象通過腳本區塊表達式篩選為止。 然後，它會傳回 所有 剩餘的集合專案，而不會進行測試。 只會測試一個通過的專案。
這表示傳回的集合同時包含未測試的 傳遞 和非 傳遞 專案。
傳回的項目數目可以透過將值傳遞至 numberToReturn 自變數來限制。
$computers = "Server01", "Server02", "Server03", "localhost", "Server04"
# Find the first available online server.
$computers.Where({ Test-Connection $_ }, 'SkipUntil', 1)
localhost
Until
模式 Until 會 SkipUntil 反轉模式。 它會 傳回 集合中的所有專案，直到專案傳遞腳本區塊表達式為止。 一旦專案 傳遞 scriptblock 運算式， Where 方法就會停止處理專案。
這表示您會收到方法的第一組 非傳遞 專案 Where 。 一 個專案通過之後，其餘專案會經過測試或傳回。
傳回的項目數目可以透過將值傳遞至 numberToReturn 自變數來限制。
# Retrieve the first set of numbers less than or equal to 10.
(1..50).Where({$_ -gt 10}, 'Until')
# This would perform the same operation.
(1..50).Where({$_ -le 10})
1
2
3
4
5
6
7
8
9
10
注意
和 SkipUntil 在 Until NOT 測試一批項目的內部部署下運作。
Until會傳回第一次傳遞前的專案。
SkipUntil會傳回第一次傳遞之後的所有專案，包括第一個傳遞的專案。
分割
模式會將 Split 集合專案分割成兩個不同的集合。 傳遞 scriptblock 運算式且未傳遞的表達式。
numberToReturn如果指定 ，則第一個集合會包含傳遞的專案，而不是超過指定的值。
其餘物件，即使是 PASS 運算式篩選條件的物件，也會在第二個集合中傳回。
$running, $stopped = (Get-Service).Where({$_.Status -eq 'Running'}, 'Split')
$running
Status Name DisplayName
------ ---- -----------
Running Appinfo Application Information
Running AudioEndpointBu... Windows Audio Endpoint Builder
Running Audiosrv Windows Audio
...
$stopped
Status Name DisplayName
------ ---- -----------
Stopped AJRouter AllJoyn Router Service
Stopped ALG Application Layer Gateway Service
Stopped AppIDSvc Application Identity
...
取得陣列的成員
若要取得數位的屬性和方法，例如 Length 屬性和 SetValue 方法，請使用 Cmdlet 的 Get-MemberInputObject 參數。
當您使用管線將數位傳送至 Get-Member時，PowerShell 會一次傳送一個專案，並 Get-Member 傳回陣列中每個專案的類型， (忽略重複專案) 。
當您使用 InputObject 參數時， Get-Member 會傳回陣列的成員。
例如，下列命令會取得陣列變數的成員 $a 。
Get-Member -InputObject $a
您也可以在傳送至 Get-Member Cmdlet 的值之前輸入逗號 (，) ，以取得陣列的成員。 逗號會使數組成為陣列數位列中的第二個專案。 PowerShell 會一次傳送一個陣列，並 Get-Member 傳回陣列的成員。 如同下兩個範例。
,$a | Get-Member
,(1,2,3) | Get-Member
操作陣列
您可以變更陣列中的元素、將元素新增至陣列，並將兩個陣列中的值合併為第三個陣列。
若要變更陣列中特定元素的值，請指定您要變更之專案的陣列名稱和索引，然後使用指派運算子 (=) 指定專案的新值。 例如，若要將陣列中 $a 第二個專案的值變更 (索引位置 1) 為 10，請輸入：
$a[1] = 10
您也可以使用陣列的 SetValue 方法來變更值。 下列範例會將陣列的第二個值 (索引位置 1) $a 變更為 500：
$a.SetValue(500,1)
您可以使用 += 運算子，將元素加入至陣列。 下列範例示範如何將專案新增至 $a 陣列。
$a = @(0..4)
$a += 5
注意
當您使用 運算符時 += ，PowerShell 實際上會使用原始數位的值和新增的值來建立新的陣列。 如果作業重複數次，或數位的大小太大，這可能會導致效能問題。
從陣列中刪除專案並不容易，但您可以建立只包含現有陣列所選元素的新陣列。 例如，若要使用陣列中的所有元素建立 $t 陣列，但索引位置 2 的值 $a 除外，請輸入：
$t = $a[0,1 + 3..($a.length - 1)]
若要將兩個陣列結合成單一陣列，請使用加號運算子 (+) 。 下列範例會建立兩個陣列、將它們合併，然後顯示產生的合併陣列。
$x = 1,3
$y = 5,9
$z = $x + $y
因此， $z 陣列包含1、3、5和9。
若要刪除陣列，請將的值 $null 指派給陣列。 下列命令會刪除變數中的 $a 陣列。
$a = $null
您也可以使用 Remove-Item Cmdlet，但指派 的值 $null 較快，特別是針對大型陣列。
零或一個陣列
從 Windows PowerShell 3.0 開始，零或一個物件的集合具有 Count 和 Length 屬性。 此外，您可以將索引編製成一個對象的陣列。 這項功能可協助您避免在預期集合的命令取得少於兩個專案時發生的腳本錯誤。
下列範例示範這項功能。
零物件
$a = $null
$a.Count
$a.Length
0
0
一個物件
$a = 4
$a.Count
$a.Length
$a[0]
$a[-1]
1
1
4
4
System.Tuple 物件的索引支援
PowerShell 6.1 新增了 Tuple 物件的索引存取支援，類似於陣列。 例如：
PS> $tuple = [Tuple]::Create(1, 'test')
PS> $tuple[0]
1
PS> $tuple[1]
test
PS> $tuple[0..1]
1
test
PS> $tuple[-1]
test
不同於陣列和其他集合物件， Tuple 物件會在通過管線或支援物件陣列的參數傳遞時視為單一物件。
如需詳細資訊，請參閱 System.Tuple。