about_Arrays
簡短描述
描述陣列，這是設計用來儲存專案集合的數據結構。
完整描述
數位是設計來儲存專案集合的數據結構。 專案可以是相同的類型或不同的類型。
從 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[]。 若要轉換陣列，請在變數名稱前面加上以括弧括住的陣列類型。 例如，若要建立名為 $ia 的 32 位整數陣列，其中包含四個整數（1500、2230、3350 和 4000），請輸入：
[int32[]]$ia = 1500,2230,3350,4000
因此，$ia 陣列只能包含整數。
您可以建立數位，這些陣列會轉換成 .NET 中的任何支援類型。 例如，
[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、until 9 的陣列;打字：
$a
0
1
2
3
4
5
6
7
8
9
您可以使用索引，從位置 0 開始，參考陣列中的專案。 以括弧括住索引編號。 例如，若要在 $a 陣列中顯示 first 專案，請輸入：
$a[0]
0
若要在 $a 陣列中顯示第三個專案，請輸入：
$a[2]
2
您可以使用索引的範圍運算符來擷取陣列的一部分。 例如，若要擷取陣列的第二到第五個專案，您可以輸入：
$a[1..4]
1
2
3
4
從陣列結尾 count 負數。 例如，“-1” 是指數組的 last 元素。 若要以索引遞增順序顯示陣列的三個專案 last，請輸入：
$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] 是指數組的所有元素，但 last 除外。 它是指數組中的 first、last和第二last 元素。
您可以使用加號運算子 （+） 來結合範圍與陣列中的元素清單。 例如，若要在索引位置 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 迴圈會逐一查看數位，並傳回數位列中的每個值，until 到達陣列結尾。
當您在檢查陣列中的專案時，遞增計數器時，For 迴圈很有用。 例如，若要使用 For 循環來傳回陣列中的每個其他值，請輸入：
$a = 0..9
for ($i = 0; $i -le ($a.length - 1); $i += 2) {
$a[$i]
}
0
2
4
6
8
您可以使用 While 循環來顯示數位中的元素，until 定義的條件不再成立。 例如，若要在陣列索引小於 4 時顯示 $a 陣列中的專案，請輸入：
$a = 0..9
$i=0
while($i -lt 4) {
$a[$i]
$i++
}
0
1
2
3
陣列的屬性
Count 或 Length 或 LongLength
若要判斷陣列中的項目數，請使用 Length 屬性或其 Count 別名。 如果陣列包含超過 2,147,483,647 個元素，則 Longlength 很有用。
$a = 0..9
$a.Count
$a.Length
10
10
Rank
傳回陣列中的維度數目。 PowerShell 中的大多數陣列只有一個維度。 即使您認為您要建置多維度陣列，如下列範例所示：
$a = @(
@(0,1),
@("b", "c"),
@(Get-Process)
)
"`$a rank: $($a.Rank)"
"`$a length: $($a.Length)"
"`$a[2] length: $($a[2].Length)"
"Process `$a[2][1]: $($a[2][1].ProcessName)"
在此範例中，您會建立包含其他數位的單一維度陣列。 這也稱為 鋸齒狀陣列。
Rank 屬性證明這是單一維度。 若要存取不規則陣列中的專案，索引必須位於不同的方括弧中（[]）。
$a rank: 1
$a length: 3
$a[2] length: 348
Process $a[2][1]: AcroRd32
多維度陣列資料列主要順序 儲存。 下列範例示範如何建立真正的多維度陣列。
[string[,]]$rank2 = [string[,]]::New(3,2)
$rank2.rank
$rank2.Length
$rank2[0,0] = 'a'
$rank2[0,1] = 'b'
$rank2[1,0] = 'c'
$rank2[1,1] = 'd'
$rank2[2,0] = 'e'
$rank2[2,1] = 'f'
$rank2[1,1]
2
6
d
若要存取多維度陣列中的專案，請使用單一方括弧 （[]） 內的逗號 （,） 分隔索引。
多維度陣列的某些作業，例如復寫和串連，需要扁平化該陣列。 扁平化會將數位轉換成不受限制類型的 1 維陣列。 產生的陣列會依數據列主要順序接受所有元素。 請考慮下列範例：
$a = "red",$true
$b = (New-Object 'int[,]' 2,2)
$b[0,0] = 10
$b[0,1] = 20
$b[1,0] = 30
$b[1,1] = 40
$c = $a + $b
$a.GetType().Name
$b.GetType().Name
$c.GetType().Name
$c
輸出顯示 $c 是一個 1 維陣列，其中包含數據列主要順序 $a 和 $b 的專案。
Object[]
Int32[,]
Object[]
red
True
10
20
30
40
陣列的方法
Clear
將所有項目值設定為陣列元素類型的 default 值。
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
就像 ForEach-Object的 -ArgumentList 參數一樣，arguments 參數允許將自變數陣列傳遞至設定接受它們的腳本區塊。
如需 ArgumentList行為的詳細資訊，請參閱 about_Splatting。
ForEach（type 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[] arguments）
最後，ForEach 方法可用來在集合中的每個項目上執行方法。
("one", "two", "three").ForEach("ToUpper")
ONE
TWO
THREE
就像 ForEach-Object的 -ArgumentList 參數一樣，Arguments 參數允許將值陣列傳遞至設定接受它們的腳本區塊。
注意
從 Windows PowerShell 3.0 開始擷取屬性，以及針對集合中的每個項目執行方法，也可以使用「純量物件和集合的方法」來完成。 您可以在這裡深入瞭解，about_methods。
哪裡
允許篩選或選取陣列的專案。 腳本必須評估為與 ：零 （0）、空字串、$false 或 $null 不同的專案，才能在 Where之後顯示。 如需布林值評估的詳細資訊，請參閱 about_Booleans。
Where 方法有一個定義。
Where(scriptblock expression[, WhereOperatorSelectionMode mode
[, int numberToReturn]])
注意
語法需要使用腳本區塊。 如果 scriptblock 是唯一的參數，則括弧是選擇性的。 此外，方法與左括弧或大括弧之間不得有空格。
Expression 是篩選所需的 scriptblock，mode 選擇性自變數允許其他選取功能，而 numberToReturn 選擇性自變數允許限制從篩選傳回的項目數。
mode 可接受的值為：
- Default （0） - 傳回所有專案
- First （1） - 傳回 first 專案
- Last （2） - 傳回 last 專案
- SkipUntil （3） - 略過專案 until 條件為 true，傳回其餘所有專案（包括條件為 true 的 first 專案）
- Until （4） - 傳回所有專案 until 條件為 true
-
Split （5） - 傳回兩個項目的陣列
- first 專案包含相符的專案
- 第二個專案包含剩餘的專案
下列範例示範如何從陣列中選取所有奇數。
(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 模式都會傳回 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 模式會略過集合中的所有物件，until 對象會傳遞腳本區塊表達式篩選。 然後，它會 傳回所有 其餘集合專案，而不進行測試。
只會測試一個通過的專案，。
這表示傳回的集合同時包含 傳遞 和 尚未測試 專案。
傳回的項目數目可以藉由將值傳遞至 numberToReturn 自變數來限制。
$computers = "Server01", "Server02", "Server03", "localhost", "Server04"
# Find the first available online server.
$computers.Where({ Test-Connection $_ }, 'SkipUntil', 1)
localhost
Until
Until 模式會反轉 SkipUntil 模式。 它會傳回集合中所有 專案 Where 方法就會停止處理專案。
這表示您會收到來自 Where 方法 非傳遞 項目的 first 集。
一個專案通過之後，其餘專案不會經過測試或傳回。
傳回的項目數目可以藉由將值傳遞至 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
注意
Until 和 SkipUntil 在NOT測試一批專案的前提下運作。
SkipUntil 會傳回 AFTER 所有專案，first傳遞，包括 first 傳遞專案。
Split
Split 模式會將集合專案分割成兩個不同的集合。 傳遞 scriptblock 運算式和未傳遞腳本區塊表達式的表達式。
如果指定了
其餘物件，即使是 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
...
注意
foreach 和 where 方法是內部成員。 如需內部成員的詳細資訊，請參閱 about_Instrinsic_Members
取得陣列的成員
若要取得數位的屬性和方法，例如 Length 屬性和 SetValue 方法，請使用 Get-Member Cmdlet 的 InputObject 參數。
當您使用管線將陣列傳送至 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 陣列中第二個專案的值變更為 10，請輸入：
$a[1] = 10
您也可以使用陣列的 SetValue 方法來變更值。 下列範例會將 $a 陣列的第二個值（索引位置 1） 變更為 500：
$a.SetValue(500,1)
您可以使用 += 運算子，將元素新增至數位。 下列範例示範如何將專案加入至 $a 陣列。
$a = @(0..4)
$a += 5
注意
當您使用 += 運算符時，PowerShell 實際上會使用原始數位的值和加值來建立新的數位。 如果作業重複數次，或數位的大小太大，這可能會導致效能問題。
從陣列中刪除專案並不容易，但您可以建立只包含現有數位選取專案的新陣列。 例如，若要使用 $a 陣列中的所有元素來建立 $t 陣列，除了索引位置 2 的值之外，請輸入：
$t = $a[0,1 + 3..($a.length - 1)]
若要將兩個數組合並成單一陣列，請使用 plus 運算子 （+）。 下列範例會建立兩個陣列、將它們結合，然後顯示產生的合併陣列。
$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 透過管線傳遞時，或透過支援物件陣列的參數，將對象視為單一物件。
如需詳細資訊，請參閱 系統。Tuple。
成員存取列舉
從 PowerShell 3.0 開始，當您使用成員存取運算符來存取清單集合上不存在的成員時，PowerShell 會自動列舉集合中的專案，並嘗試存取每個專案上的指定成員。 如需詳細資訊，請參閱 about_Member-Access_Enumeration。
例子
下列範例會建立兩個新的檔案，並將產生的物件儲存在數位變數中 $files。 由於陣列物件沒有 lastWriteTime 成員
$files = (New-Item -Type File -Force '/temp/t1.txt'),
(New-Item -Force -Type File '/temp/t2.txt')
$files.LastWriteTime
Friday, June 25, 2021 1:21:17 PM
Friday, June 25, 2021 1:21:17 PM
成員存取列舉可讓您 從集合中的專案取得 值，但不 設定集合中專案的 值。 例如：
$files.LastWriteTime = (Get-Date).AddDays(-1)
InvalidOperation: The property 'LastWriteTime' cannot be found on this object.
Verify that the property exists and can be set.
若要設定值，您必須使用 方法。
$files.set_LastWriteTime((Get-Date).AddDays(-1))
$files.LastWriteTime
Thursday, June 24, 2021 1:23:30 PM
Thursday, June 24, 2021 1:23:30 PM
set_LastWriteTime() 方法是 FileInfo 物件的 隱藏 成員。 下列範例示範如何尋找 隱藏set 方法的成員。
$files | Get-Member | Where-Object Definition -like '*set;*'
TypeName: System.IO.FileInfo
Name MemberType Definition
---- ---------- ----------
Attributes Property System.IO.FileAttributes Attributes {get;set;}
CreationTime Property datetime CreationTime {get;set;}
CreationTimeUtc Property datetime CreationTimeUtc {get;set;}
IsReadOnly Property bool IsReadOnly {get;set;}
LastAccessTime Property datetime LastAccessTime {get;set;}
LastAccessTimeUtc Property datetime LastAccessTimeUtc {get;set;}
LastWriteTime Property datetime LastWriteTime {get;set;}
LastWriteTimeUtc Property datetime LastWriteTimeUtc {get;set;}
謹慎
由於方法會針對集合中的每個項目執行，因此在使用成員列舉呼叫方法時，應該小心。