简短说明
描述数组，数组是旨在存储项集合的数据结构。
详细说明
数组是一种数据结构，旨在存储项目集合。 这些项可以是相同类型或不同类型的。
从 Windows PowerShell 3.0 开始，零个或一个对象的集合具有数组的某些属性。
创建和初始化数组
要创建和初始化数组，请为变量分配多个值。 数组中存储的值用逗号分隔，并用赋值运算符 （）= 与变量名称分隔。
例如，要创建一个名为 $A 的数组，其中包含 22、5、10、8、12、9 和 80 这七个数字（整数）值，请键入：
$A = 22,5,10,8,12,9,80
逗号还可用于初始化单个项数组，方法是将逗号放在单个项之前。
例如，要创建一个包含单个值 7 的单 $B 项数组，请键入：
$B = ,7
您还可以使用范围运算符 （）.. 创建和初始化数组。
以下示例创建一个包含值 5 到 8 的数组。
$C = 5..8
因此， $C 包含四个值：5、6、7 和 8。
如果未指定数据类型，PowerShell 会将每个数组创建为对象数组 （System.Object[]）。 要确定数组的数据类型，请使用 GetType() method. 例如：
$A.GetType()
要创建强类型数组（即只能包含特定类型值的数组），请将变量强制转换为数组类型，例如 string[]、long[] 或 int32[]。 若要强制转换数组，请在变量 name 前面加上用方括号括起来的数组类型。 例如：
[int32[]]$ia = 1500, 2230, 3350, 4000
因此， $ia 数组只能包含整数。
可以创建转换为 .NET 中任何受支持类型的数组。 例如， Get-Process 检索以表示进程的对象是 System.Diagnostics.Process 类型。 要创建进程对象的强类型数组，请输入以下命令：
[Diagnostics.Process[]]$zz = Get-Process
数组子表达式运算符
array 子表达式运算符从其中的语句创建一个数组。 无论运算符内部的语句生成什么，运算符都会将其放入数组中。 即使有零个或一个对象。
数组运算符的语法如下：
@( ... )
您可以使用 array 运算符创建包含零个或一个对象的数组。 例如：
$a = @("Hello World")
$a.Count
1
$b = @()
$b.Count
0
数组运算符在脚本中很有用，当你要获取对象，但不知道预期有多少对象时。 例如：
$p = @(Get-Process Notepad)
有关 array 子表达式运算符的更多信息，请参阅 about_Operators。
访问和使用数组元素
读取数组
您可以使用数组的变量名称来引用数组。 要显示数组中的所有元素，请调用数组名称。 例如， $a 是数字 0 到 9 的数组：
$a
0
1
2
3
4
5
6
7
8
9
您可以使用索引引用数组中的元素。 将索引号括在括号中。 索引值从 0. 例如，若要显示 $a 数组中的第一个元素，请键入：
$a[0]
0
要显示数组中的 $a 第三个元素，请键入：
$a[2]
2
您可以使用索引的 range 运算符检索数组的一部分。 例如，要检索数组的第二个到第五个元素，您可以键入：
$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 运算符。 例如，要列出元素 0 到 2、4 到 6 以及第 8 个位置的元素类型：
$a = 0..9
$a[+0..2+4..6+8]
0
1
2
4
5
6
8
数组元素的迭代
您还可以使用循环构造（如 foreach、 for和 while loops）来引用数组中的元素。 例如，要使用 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 循环显示数组中的元素，直到定义的条件不再为 true。 例如，要在数组索引小于 4 时显示数组中的 $a 元素，请键入：
$a = 0..9
$i=0
while($i -lt 4) {
$a[$i]
$i++
}
0
1
2
3
数组的属性
Count 或 Length 或 LongLength
要确定数组中有多少项，请使用 Length property 或其 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
要访问多维数组中的项目，请在一组方括号 （）, 中使用逗号 （）[] 分隔索引。
对多维数组的某些作（如复制和串联）需要将该数组展平。 展平将数组转换为无约束类型的一维数组。 结果数组按行优先顺序接收所有元素。 请看下面的示例：
$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一维数组，其中包含行优先顺序中的$a$b项目。
Object[]
Int32[,]
Object[]
red
True
10
20
30
40
数组的方法
Clear
将所有元素值设置为数组元素类型的 默认值。 该方法 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 参数一样，该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（字符串 propertyName）
ForEach（字符串 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（字符串 methodName）
ForEach（字符串 methodName， object[] 参数）
最后， ForEach() 方法可用于对集合中的每个项目执行方法。
("one", "two", "three").ForEach("ToUpper")
ONE
TWO
THREE
就像 的 ForEach-Object 参数一样，该arguments参数允许将值数组传递给配置为接受值的脚本块。
注释
从 Windows PowerShell 3.0 开始，还可以使用“标量对象和集合的方法”来检索集合中每个项的属性和执行方法。 您可以在此处阅读更多相关信息 about_Methods.
其中（）
允许筛选或选择数组的元素。 脚本的计算结果必须为以下值：零 （0）、空字符串， $false 或者 $null 元素显示在 Where(). 有关布尔计算的详细信息，请参阅 about_Booleans。
该方法 Where() 有一个定义。
Where(scriptblock expression[, WhereOperatorSelectionMode mode
[, int numberToReturn]])
注释
该语法需要使用脚本块。 如果 scriptblock 是唯一的参数，则括号是可选的。 此外，方法与左括号或大括号之间不得有空格。
这是 Expression 筛选所需的脚本块， mode optional 参数允许其他选择功能， numberToReturn optional 参数允许限制从筛选器返回的项目数。
的值 mode 必须是 WhereOperatorSelectionMode 枚举值：
-
Default（0） - 返回所有项目 -
First（1） - 返回第一项 -
Last（2） - 返回最后一个项目 -
SkipUntil（3） - 跳过项，直到条件为 true，返回所有剩余项（包括条件为 true 的第一项） -
Until（4） - 返回所有项目，直到条件为 true -
Split（5） - 返回包含两个元素的数组- 第一个元素包含匹配项
- 第二个元素包含其余项
以下示例演示如何从数组中选择所有奇数。
(0..9).Where{ $_ % 2 }
1
3
5
7
9
此示例演示如何选择不为空的字符串。
('hi', '', 'there').Where({$_.Length})
hi
there
Default
该 Default 模式使用 Expression scriptblock 筛选项目。
如果提供 a 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
注释
Until两者都SkipUntil在不测试一批项目的前提下运行。
Until 在第一次传递之前返回项。
SkipUntil 在第一次传递之后返回所有项，包括第一个传递项。
Split
该 Split 模式将集合项拆分或分组为两个单独的集合。 传递 scriptblock 表达式的函数和不传递 scriptblock 表达式的函数。
如果指定了 numberToReturn，则第一个集合包含传递项，而不是超过指定的值。
其余对象（甚至是那些 PASS 表达式 filter 的对象）将在第二个集合中返回。
$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
...
注释
both ForEach() 和 Where() methods 都是内部成员。 有关内部成员的更多信息，请参阅 about_Instrinsic_Members。
获取数组的成员
若要获取数组的属性和方法（如Length属性和 SetValue 方法），请使用 cmdlet 的 Get-Member 参数。
当您通过管道将数组传递给 Get-Member时，PowerShell 一次发送一个项，并 Get-Member 返回数组中每个项的类型（忽略重复项）。
使用 InputObject 参数时， Get-Member 返回数组的成员。
例如，以下命令获取 array 变量的成员 $a 。
Get-Member -InputObject $a
还可以通过在通过管道传输到 , cmdlet 的值之前键入逗号 （）Get-Member 来获取数组的成员。 逗号使数组成为数组数组中的第二项。 PowerShell 一次通过管道传输一个数组，并 Get-Member 返回数组的成员。 就像接下来的两个例子一样。
,$a | Get-Member
,(1,2,3) | Get-Member
作数组
您可以更改数组中的元素，将元素添加到数组中，并将两个数组中的值合并为第三个数组。
要更改数组中特定元素的值，请指定要更改的元素的数组名称和索引，然后使用赋值运算符 （）= 为该元素指定新值。 例如，要将数组中 $a 第二项（索引位置 1）的值更改为 10，请键入：
$a[1] = 10
还可以使用数组的 SetValue 方法来更改值。 以下示例将数组的 $a 第二个值（索引位置 1）更改为 500：
$a.SetValue(500,1)
您可以使用 += 运算符 将元素添加到数组中。 下面的示例演示如何将元素添加到数组中 $a 。
$a = @(0..4)
$a += 5
注释
当您使用运算符 += 时，PowerShell 实际上会使用原始数组的值和添加的值创建一个新数组。 如果作重复多次或数组大小太大，这可能会导致性能问题。
从数组中删除元素并不容易，但您可以创建一个仅包含现有数组的选定元素的新数组。 例如，要创建 $t 包含数组中 $a 除索引位置 2 处的值之外的所有元素的数组，请键入：
$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，但分配值 NAME $null 会更快，尤其是对于大型数组。
零个或 1 个数组
从 Windows PowerShell 3.0 开始，零个或一个对象的集合具有 Count and Length 属性。 此外，还可以索引到一个对象的数组中。 此功能可帮助您避免在需要集合的命令获得少于两个项时发生脚本错误。
以下示例显示不包含任何对象的变量的 a Count 和 Length 为 0。
PS> $a = $null
PS> $a.Count
0
PS> $a.Length
0
以下示例显示包含一个对象的变量的 and CountLength 为 1。 您还可以使用数组索引来访问对象的值。
PS> $a = 4
PS> $a.Count
1
PS> $a.Length
1
PS> $a[0]
4
PS> $a[-1]
4
当您运行可能返回集合或单个对象的命令时，您可以使用数组索引来访问对象的值，而无需测试 Count or Length 属性。 但是，如果结果是单个对象（单一实例），并且该对象具有 Count or Length 属性，则这些属性的值属于单一实例对象，不表示集合中的项数。
在下面的示例中，该命令返回单个字符串对象。 该字符串的 是 Length4。
PS> $result = 'one','two','three','four' | Where-Object {$_ -like 'f*'}
PS> $result.GetType().FullName
System.String
PS> $result
four
PS> $result.Count
1
PS❯ $result.Length
4
如果你想 $result 成为一个字符串数组，你需要将变量声明为一个数组。
在此示例中， $result 是一个字符串数组。 数组的 Count 和 Length 是 1，第一个元素的 Length 是 4。
PS> [string[]]$result = 'one','two','three','four' |
Where-Object {$_ -like 'f*'}
PS> $result.GetType().FullName
System.String[]
PS> $result
four
PS> $result.Count
1
PS> $result.Length
1
PS> $result[0].Length
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.
为实现的 .NET 类型编制索引 IDictionary<TKey, TValue>
PowerShell 不会为实现泛型 IDictionary<TKey, TValue> 接口的类型调用类型的 true 索引器。 相反，当给定密钥时，PowerShell 会使用 TryGetValue()来测试密钥是否存在，当密钥不存在时，它会返回 $null 。
相比之下，如果使用 调用 Item(<key>)类型的 true indexer，则该方法会在键不存在时引发异常。
以下示例演示了差异。
PS> [Collections.Generic.Dictionary[string, int]]::new()['nosuchkey']
# No output ($null)
PS> [Collections.Generic.Dictionary[string, int]]::new().Item('nosuchkey')
GetValueInvocationException: Exception getting "Item": "The given key 'nosuchkey'
was not present in the dictionary."
成员访问枚举
从 PowerShell 3.0 开始，当您使用 member-access 运算符访问列表集合上不存在的成员时，PowerShell 会自动枚举集合中的项，并尝试访问每个项上的指定成员。 有关详细信息，请参阅 about_Member Access_Enumeration。
例子
以下示例创建两个新文件，并将生成的对象存储在 array 变量 $files. 由于数组对象没有 LastWriteTime 成员，因此会为数组中的每个项返回 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.
要设置值，您必须使用 method.
$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 对象的隐藏成员。 下面的示例演示如何查找具有 hiddenset 方法的成员。
$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;}
谨慎
由于该方法是针对集合中的每个项执行的，因此在使用成员枚举调用方法时应小心。