Get-Random

Get-Random
    [[-Maximum] <Object>]
    [-SetSeed <Int32>]
    [-Minimum <Object>]
    [-Count <Int32>]
    [<CommonParameters>]

Get-Random
    [-InputObject] <Object[]>
    [-SetSeed <Int32>]
    [-Count <Int32>]
    [<CommonParameters>]

Get-Random
    [-InputObject] <Object[]>
    [-SetSeed <Int32>]
    [-Shuffle]
    [<CommonParameters>]

Командлет Get-Random получает случайно выбранное число. Если вы отправляете коллекцию объектов в Get-Random, она получает один или несколько случайных выбранных объектов из коллекции.

Без параметров или входных данных команда Get-Random возвращает случайно выбранное 32-разрядное целое число без знака от 0 до [int32]::MaxValue.

Параметры Get-Random можно использовать для указания минимального и максимального значений, количества объектов, возвращаемых из коллекции, или начального числа.

Эта команда возвращает случайное целое число в диапазоне от 0 до Int32.MaxValue.

Get-Random

3951433

Get-Random -Maximum 100

47

Get-Random -Minimum -100 -Maximum 100

56

Эта команда получает случайное число с плавающей запятой больше или равно 10,7 и меньше 20,93.

Get-Random -Minimum 10.7 -Maximum 20.93

18.08467273887

Эта команда получает случайно выбранное число из указанного массива.

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

8

Эта команда получает три случайных выбранных числа в случайном порядке из массива.

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

3
1
13

Начиная с PowerShell 7.1, можно использовать параметр Shuffle для возврата всей коллекции в случайном порядке.

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

2
3
5
1
8
13

Эта команда возвращает случайное значение из нечисленной коллекции.

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

yellow

В этом примере показан эффект использования параметра 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

Эти команды получают выборку из 50 файлов из C: диска локального компьютера.

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

В этом примере честный кубик бросают 1200 раз и подсчитывают результаты. Первая команда ForEach-Object повторяет вызов Get-Random, используя поступающие на вход номера (1-6). Результаты группируются по их значению с 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 без Get-Random. В следующем примере получается три случайных числа меньше 10.

Get-Random -Count 3 -Maximum 10

9
0
8

В этом примере параметр inputObject указывает массив, содержащий пустую строку () и .

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

Get-Random возвращает a, пустую строку или $null. Пустая строка отображается как пустая строка и $null возвращается в запрос PowerShell.

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Вы можете передать любой объект в этот cmdlet. Он выбирает значения случайным образом из конвейерных объектов.

Этот командлет возвращает целое число или число с плавающей запятой или объект, выбранный случайным образом из отправленной коллекции.

Get-Random не всегда возвращает тот же тип данных, что и входное значение. В следующей таблице показан тип вывода для каждого из числовых типов входных данных.

Начиная с Windows PowerShell 3.0, Get-Random поддерживает 64-разрядные целые числа. В Windows PowerShell 2.0 все значения приведение к System.Int32.

Начиная с PowerShell 7, параметр InputObjectв наборе параметров randomListItemParameterSet принимает массивы, содержащие пустую строку или $null. В более ранних версиях PowerShell только параметр Maximumв наборе параметров randomNumberParameterSet принял пустую строку или $null.