Get-Random
获取一个随机数，或从集合中随机选择对象。
语法
Get-Random
[-SetSeed <Int32>]
[[-Maximum] <Object>]
[-Minimum <Object>]
[<CommonParameters>]Get-Random
[-SetSeed <Int32>]
[-InputObject] <Object[]>
[-Count <Int32>]
[<CommonParameters>]说明
cmdlet Get-Random 获取随机选择的数字。 如果将 对象的集合提交到 Get-Random，它将从集合中获取一个或多个随机选择的对象。
如果没有参数或输入， Get-Random 命令将返回介于 0 (零) 和 Int32.MaxValue (0x7FFFFFFF、 2,147,483,647) 之间的随机选择的 32 位无符号整数。
可以使用 的参数 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.92 的随机浮点数。
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：随机化整个集合
此命令将按随机顺序返回整个集合。
Count 参数的值是整数的 MaxValue 静态属性。
若要按随机顺序返回整个集合，请输入任一大于或等于该集合中的对象数的数字。
1, 2, 3, 5, 8, 13 | Get-Random -Count ([int]::MaxValue)
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
74
56
84
46
# Commands with the same seed are not random
Get-Random -Maximum 100 -SetSeed 23
Get-Random -Maximum 100 -SetSeed 23
Get-Random -Maximum 100 -SetSeed 23
74
74
74
# SetSeed results in a repeatable series
Get-Random -Maximum 100 -SetSeed 23
Get-Random -Maximum 100
Get-Random -Maximum 100
Get-Random -Maximum 100
74
56
84
46示例 10：获取随机文件
这些命令从本地计算机的驱动器中 C: 获取随机选择的 50 个文件示例。
$Files = Get-ChildItem -Path C:\* -Recurse
$Sample = $Files | Get-Random -Count 50示例 11：滚动公平骰子
此示例将公平模具滚动 1200 次，并计算结果。 第一个命令 For-EachObject 重复从通过管道传递的数字 (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参数
-Count
指定要返回的随机对象或数字的数目。 默认值为 1。
与 一起使用 InputObject时，如果 Count 的值超过集合中的对象数， Get-Random 则按随机顺序返回所有对象。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
指定对象的集合。 Get-Random 从集合中以随机顺序获取随机选择的对象，最多获取 Count 指定的数量。 输入对象、一个包含这些对象的变量，或可获取这些对象的命令或表达式。 还可以通过管道将 对象的集合传递给 Get-Random。
| Type: | Object[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Maximum
指定随机数的最大值。 Get-Random 返回的值小于最大 (不等于) 。 输入整数、双精度浮点数或可转换为整数或双精度值的对象，例如数字字符串 (“100”) 。
Maximum 值必须大于（不等于）Minimum 值。 如果 “最大值 ”或“ 最小值 ”是浮点数， Get-Random 则 返回随机选择的浮点数。
在 64 位计算机上，如果 Minimum 值为 32 位整数，则 Maximum 的默认值为 Int32.MaxValue。
如果 Minimum 的值为双精度值 (浮点数) ，则 Maximum 的默认值为 Double.MaxValue。 否则，默认值为 Int32.MaxValue。
| Type: | Object |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Minimum
指定随机数的最小值。 输入整数、双精度浮点数或可转换为整数或双精度值的对象，例如数字字符串 (“100”) 。 默认值为 0（零）。
Minimum 值必须小于（不等于）Maximum 值。 如果 “最大值 ”或“ 最小值 ”是浮点数， Get-Random 则 返回随机选择的浮点数。
| Type: | Object |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SetSeed
为随机数生成程序指定种子值。 此种子值用于当前命令和当前会话中的所有后续 Get-Random 命令，直到再次使用 SetSeed 或关闭会话。 无法将种子重置为其默认值。
SetSeed 参数不是必需的。 默认情况下， Get-Random 使用 RandomNumberGenerator () 方法生成种子值。 由于 SetSeed 会导致非随机行为，因此通常仅在尝试重现行为时使用，例如调试或分析包含 Get-Random 命令的脚本时。
| Type: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
输入
可以通过管道传递一个或多个对象。 Get-Random 从管道对象中随机选择值。
输出
System.Int32, System.Int64, System.Double
Get-Random 返回整数或浮点数，或者从提交的集合中随机选择的对象。
备注
Get-Random 根据会话启动时的系统时间时钟为每个会话设置默认种子。
Get-Random 不会始终返回与输入值相同的数据类型。 下表显示了每个数字输入类型的输出类型。
| 输入类型 | 输出类型 |
|---|---|
| SByte | Double |
| Byte | Double |
| Int16 | Double |
| UInt16 | Double |
| Int32 | Int32 |
| UInt32 | Double |
| Int64 | Int64 |
| UInt64 | Double |
| Double | Double |
| Single | Double |
从 Windows PowerShell 3.0 开始， Get-Random 支持 64 位整数。 在 Windows PowerShell 2.0 中，所有值都转换为 System.Int32。