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にオブジェクトのコレクションを送信すると、そのコレクションからランダムに選択された 1 つ以上のオブジェクトが取得されます。

パラメーターまたは入力がない場合、Get-Random コマンドは、ランダムに選択された 0 (ゼロ) ~ [int32]::MaxValueの 32 ビット符号なし整数を返します。

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

このコマンドは、配列からランダムに選択された 3 つの数値をランダムに取得します。

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

これらのコマンドは、ローカル コンピューターの C: ドライブからランダムに選択された 50 個のファイルのサンプルを取得します。

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

この例では、フェア ダイを 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

Count パラメータを使用して、Get-Randomするオブジェクトをパイプ処理せずに使用できるようになりました。 次の例では、10 未満の 3 つの乱数を取得します。

Get-Random -Count 3 -Maximum 10

9
0
8

この例では、InputObject パラメーターは、空の文字列 ('') と $nullを含む配列を指定します。

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を参照してください。

任意のオブジェクトをこのコマンドレットにパイプできます。 パイプされたオブジェクトからランダムに値を選択します。

このコマンドレットは、整数または浮動小数点数、または送信されたコレクションからランダムに選択されたオブジェクトを返します。

Get-Random は、常に入力値と同じデータ型を返すわけではありません。 次の表に、各数値入力の種類の出力の種類を示します。

Windows PowerShell 3.0 以降、Get-Random では 64 ビット整数がサポートされています。 Windows PowerShell 2.0 では、すべての値が System.Int32にキャストされます。

PowerShell 7 以降、RandomListItemParameterSet パラメーター セットの InputObject パラメーターは、空の文字列または $nullを含む配列を受け入れます。 以前のバージョンの PowerShell では、RandomNumberParameterSet パラメーター セットの Maximum パラメーターのみが空の文字列または $nullを受け取りました。