Get-Random
获取随机数，或从集合中随机选择对象。
语法
Get-Random
[-SetSeed <Int32>]
[[-Maximum] <Object>]
[-Minimum <Object>]
[-Count <Int32>]
[<CommonParameters>]Get-Random
[-SetSeed <Int32>]
[-InputObject] <Object[]>
[-Count <Int32>]
[<CommonParameters>]Get-Random
[-SetSeed <Int32>]
[-InputObject] <Object[]>
[-Shuffle]
[<CommonParameters>]说明
Get-Random cmdlet 获取随机选择的数字。 如果将对象集合提交到 Get-Random，它将从集合中获取一个或多个随机选择的对象。
如果没有参数或输入，Get-Random 命令将返回介于 0（零）和 [int32]::MaxValue之间的随机选择的 32 位无符号整数。
可以使用 Get-Random 的参数来指定最小值和最大值、从集合返回的对象数或种子编号。
谨慎
Get-Random 不确保加密安全随机性。 种子值用于当前命令和当前会话中的所有后续 Get-Random 命令，直到再次 SetSeed 或关闭会话为止。 无法将种子重置为其默认值。
故意设置种子会导致非随机的可重复行为。 仅当尝试重现行为时（例如调试或分析包含 Get-Random 命令的脚本时），才应使用它。 请注意，种子值可由同一会话中的其他代码（例如导入的模块）设置。
示例
示例 1：获取随机整数
此命令获取介于 0（零）和 Int32.MaxValue之间的随机整数。
Get-Random
3951433示例 2：获取介于 0 和 99 之间的随机整数
Get-Random -Maximum 100
47示例 3：获取 -100 和 99 之间的随机整数
Get-Random -Minimum -100 -Maximum 100
56示例 4：获取随机浮点数
此命令获取大于或等于 10.7 且小于 20.93 的随机浮点数。
Get-Random -Minimum 10.7 -Maximum 20.93
18.08467273887示例 5：从数组获取随机整数
此命令从指定的数组中获取随机选择的数字。
1, 2, 3, 5, 8, 13 | Get-Random
8示例 6：从数组中获取多个随机整数
此命令从数组中按随机顺序获取三个随机选择的数字。
1, 2, 3, 5, 8, 13 | Get-Random -Count 3
3
1
13示例 7：随机化整个集合
从 PowerShell 7.1 开始，可以使用 Shuffle 参数以随机顺序返回整个集合。
1, 2, 3, 5, 8, 13 | Get-Random -Shuffle
2
3
5
1
8
13示例 8：获取随机非数值
此命令从非数值集合返回随机值。
"red", "yellow", "blue" | Get-Random
yellow示例 9：使用 SetSeed 参数
此示例显示使用 SetSeed 参数的效果。
由于 SetSeed 生成非随机行为，因此通常用于重现结果，例如调试或分析脚本。
# Commands with the default seed are pseudorandom
Get-Random -Maximum 100 -SetSeed 23
Get-Random -Maximum 100
Get-Random -Maximum 100
Get-Random -Maximum 100
32
25
93
95
# Commands with the same seed aren't random
Get-Random -Maximum 100 -SetSeed 23
Get-Random -Maximum 100 -SetSeed 23
Get-Random -Maximum 100 -SetSeed 23
32
32
32
# SetSeed results in a repeatable series
Get-Random -Maximum 100 -SetSeed 23
Get-Random -Maximum 100
Get-Random -Maximum 100
Get-Random -Maximum 100
32
25
93
95示例 10：获取随机文件
这些命令从本地计算机的 C: 驱动器中随机选择 50 个文件的示例。
$Files = Get-ChildItem -Path C:\* -Recurse
$Sample = $Files | Get-Random -Count 50示例 11：滚动公平切分
本示例滚动 1200 次公平死亡，并计算结果。 第一个命令，ForEach-Object 重复调用从通过管道传送的数字（1-6）Get-Random。 结果按其值进行分组，Group-Object 格式为具有 Select-Object的表。
1..1200 | ForEach-Object {
1..6 | Get-Random
} | Group-Object | Select-Object Name,Count
Name Count
---- -----
1 206
2 199
3 196
4 226
5 185
6 188示例 12：使用 Count 参数
现在可以使用 Count 参数，而无需管道对象来 Get-Random。
以下示例获取三个小于 10 的随机数。
Get-Random -Count 3 -Maximum 10
9
0
8示例 13：将 InputObject 参数与空字符串或$null
在此示例中，InputObject 参数指定包含空字符串（''）和 $null的数组。
Get-Random -InputObject @('a','',$null)
Get-Random 返回 a、空字符串或 $null。 空 sting 显示为空白行，$null 返回到 PowerShell 提示符。
参数
-Count
指定要返回的随机对象数。 默认值为 1。
与包含集合 InputObject 一起使用时：
- 每个随机选择的项仅返回一次。
- 如果 Count 的值超过集合中的对象数，则集合中的所有对象都按随机顺序返回。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-InputObject
指定对象的集合。
Get-Random 按随机顺序从集合中随机获取对象，以 计数指定的数字。 输入对象、包含对象的变量或获取对象的命令或表达式。 还可以通过管道将对象集合传递给 Get-Random。
从 PowerShell 7 开始，InputObject 参数接受可以包含空字符串或 $null的数组。 数组可以向下发送管道，也可以作为 InputObject 参数值发送。
| 类型: | Object[] |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-Maximum
指定随机数的最大值。
Get-Random 返回的值小于最大值（不相等）。 输入整数、双精度浮点数或可转换为整数或双精度的对象，例如数字字符串（“100”）。
最大值 的值必须大于（不等于）最小值的值。 如果 最大值 或 最小值 是浮点数，则 Get-Random 返回随机选择的浮点数。
在 64 位计算机上，如果 最小 的值为 32 位整数，则 Maximum 的默认值 Int32.MaxValue。
如果 最小 的值为双精度值（浮点数），则 最大值 的默认值 Double.MaxValue。 否则，默认值 Int32.MaxValue。
| 类型: | Object |
| Position: | 0 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Minimum
指定随机数的最小值。 输入整数、双精度浮点数或可转换为整数或双精度的对象，例如数字字符串（“100”）。 默认值为 0（零）。
最小值 的值必须小于（不等于）最大值的值。 如果 最大值 或 最小值 是浮点数，则 Get-Random 返回随机选择的浮点数。
| 类型: | Object |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SetSeed
指定随机数生成器的种子值。 使用 SetSeed时，cmdlet 将生成非加密安全的伪随机数。
谨慎
设置种子会导致非随机行为。 仅当尝试重现行为时（例如调试或分析包含 Get-Random 命令的脚本时），才应使用它。
此种子值用于当前命令和当前会话中的所有后续 Get-Random 命令，直到再次使用 SetSeed 或关闭会话。 无法将种子重置为其默认值。
| 类型: | Nullable<T>[Int32] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Shuffle
按随机顺序返回整个集合。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
可以通过管道将任何对象传递给此 cmdlet。 它从管道对象中随机选择值。
输出
此 cmdlet 返回整数或浮点数，或从提交的集合中随机选择的对象。
备注
Get-Random 并不总是返回与输入值相同的数据类型。 下表显示了每个数值输入类型的输出类型。
| 输入类型 | 输出类型 |
|---|---|
| SByte | 双 |
| 字节 | 双 |
| Int16 | 双 |
| UInt16 | 双 |
| Int32 | Int32 |
| UInt32 | 双 |
| Int64 | Int64 |
| UInt64 | 双 |
| 双 | 双 |
| 单 | 双 |
从 Windows PowerShell 3.0 开始，Get-Random 支持 64 位整数。 在 Windows PowerShell 2.0 中，所有值都转换为 system.Int32 。
从 PowerShell 7 开始，RandomListItemParameterSet 参数集中的 InputObject 参数接受包含空字符串或 $null的数组。 在早期 PowerShell 版本中，只有 RandomNumberParameterSet 中的 Maximum 参数 集接受空字符串或 $null。
