Get-SecureRandom

获取一个随机数,或从集合中随机选择对象。

语法

Get-SecureRandom
   [[-Maximum] <Object>]
   [-Minimum <Object>]
   [-Count <Int32>]
   [<CommonParameters>]
Get-SecureRandom
   [-InputObject] <Object[]>
   [-Count <Int32>]
   [<CommonParameters>]
Get-SecureRandom
   [-InputObject] <Object[]>
   [-Shuffle]
   [<CommonParameters>]

说明

Get-SecureRandom cmdlet 获取随机选择的数字。 如果将对象集合提交到 Get-SecureRandom,则它将从该集合中获取一个或多个随机选择的对象。

如果没有参数或输入,Get-SecureRandom 命令将返回介于 0(零)和 [int32]::MaxValue之间随机选择的 32 位无符号整数。

可以使用 Get-SecureRandom 的参数来指定最小值和最大值以及从集合返回的对象数。

Get-SecureRandom 使用 RandomNumberGenerator 类生成加密安全的随机性。

示例

示例 1:获取随机整数

此命令将获取一个介于 0(零)与 Int32.MaxValue 之间的随机整数。

Get-SecureRandom

3951433

示例 2:获取介于 0 和 99 之间的随机整数

Get-SecureRandom -Maximum 100

47

示例 3:获取介于 -100 和 99 之间的随机整数

Get-SecureRandom -Minimum -100 -Maximum 100

56

示例 4:获取随机浮点数

此命令将获取一个大于或等于 10.7 且小于 20.93 的随机浮点数。

Get-SecureRandom -Minimum 10.7 -Maximum 20.93

18.08467273887

示例 5:从数组获取随机整数

此命令将从指定的数组中获取一个随机选择的数字。

1, 2, 3, 5, 8, 13 | Get-SecureRandom

8

示例 6:从数组中获取多个随机整数

此命令按随机顺序从数组中获取三个随机选择的数字。

1, 2, 3, 5, 8, 13 | Get-SecureRandom -Count 3

3
1
13

示例 7:随机化整个集合

可以使用 Shuffle 参数以随机顺序返回整个集合。

1, 2, 3, 5, 8, 13 | Get-SecureRandom -Shuffle

2
3
5
1
8
13

示例 8:获取随机非数值

此命令将从非数值集合中返回一个随机值。

"red", "yellow", "blue" | Get-SecureRandom

yellow

示例 9:获取随机文件

这些命令将从本地计算机的 C: 驱动器中获取随机选择的包含 50 个文件的样本。

$Files = Get-ChildItem -Path C:\* -Recurse
$Sample = $Files | Get-SecureRandom -Count 50

示例 10:滚动骰子

本示例滚动 1200 次骰子,并计算结果。 第一个命令 ForEach-Object 重复调用通过管道传送的数字 (1-6) 到 Get-SecureRandom。 结果使用 Group-Object 按其值进行分组格式,并格式化为具有 Select-Object 的表。

1..1200 | ForEach-Object {
    1..6 | Get-SecureRandom
} | Group-Object | Select-Object Name,Count

Name Count
---- -----
1      206
2      199
3      196
4      226
5      185
6      188

示例 11:使用 Count 参数

可以使用 Count 参数,则无需通过管道传送对象到 Get-SecureRandom。 以下示例获取三个小于 10 的随机数。

Get-SecureRandom -Count 3 -Maximum 10

9
0
8

示例 12:将 InputObject 参数与空字符串或 $null 配合使用

在此示例中,InputObject 参数指定包含空字符串 ('') 和 $null 的数组。

Get-SecureRandom -InputObject @('a','',$null)

Get-SecureRandom 返回 a、空字符串或 $null。 空字符串显示为空白行,$null 返回到 PowerShell 提示。

参数

-Count

指定要返回的随机对象数。 默认值为 1。

与包含集合的 InputObject 一起使用时:

  • 每个随机选择的项仅返回一次。
  • 如果 Count 的值超过集合中的对象数,则集合中的所有对象都按随机顺序返回。
类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-InputObject

指定对象的集合。 Get-SecureRandom 按随机顺序从集合中获取随机选择的对象,最多获取由 Count 指定的数字。 输入对象、一个包含这些对象的变量,或可获取这些对象的命令或表达式。 还可以通过管道将对象集合传递给 Get-SecureRandom

InputObject 参数接受可以包含空字符串或 $null 的数组。 数组可以沿管道向下发送,也可以作为 InputObject 参数值发送。

类型:Object[]
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Maximum

指定随机数的最大值。 Get-SecureRandom 返回一个小于(不等于)最大值的值。 输入整数或双精度浮点数,或可以转换为整数或双精度的对象,如数值字符串(“100”)。

Maximum 值必须大于(不等于)Minimum 值。 如果 MaximumMinimum 值是浮点数,则 Get-SecureRandom 将返回随机选择的浮点数。

在 64 位计算机上,如果 Minimum 值是一个 32 位整数,则 Maximum 的默认值为 Int32.MaxValue

如果 Minimum 值是双精度(浮点数),则 Maximum 的默认值为 Double.MaxValue。 否则,默认值为 Int32.MaxValue

类型:Object
Position:0
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Minimum

指定随机数的最小值。 输入整数或双精度浮点数,或可以转换为整数或双精度的对象,如数值字符串(“100”)。 默认值为 0(零)。

Minimum 值必须小于(不等于)Maximum 值。 如果 MaximumMinimum 值是浮点数,则 Get-SecureRandom 将返回随机选择的浮点数。

类型:Object
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Shuffle

按随机顺序返回整个集合。

类型:SwitchParameter
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

输入

Object

你可以通过管道将任何对象传递给此 cmdlet。 它从通过管道传递的对象中随机选择值。

输出

Int32

Int64

Double

PSObject

此 cmdlet 返回整数或浮点数,或从提交的集合中随机选择的对象。

备注

Get-SecureRandom 并不总是返回与输入值相同的数据类型。 下表显示了每个数值输入类型的输出类型。

输入类型 输出类型
SByte 双精度
Byte 双精度
Int16 双精度
UInt16 双精度
Int32 Int32
UInt32 双精度
Int64 Int64
UInt64 双精度
双精度 Double
Single 双精度