Get-Random
乱数を取得するか、コレクションからオブジェクトをランダムに選択します。
構文
RandomNumberParameterSet (既定)
Get-Random
[[-Maximum] <Object>]
[-SetSeed <Int32>]
[-Minimum <Object>]
[-Count <Int32>]
[<CommonParameters>]
RandomListItemParameterSet
Get-Random
[-InputObject] <Object[]>
[-SetSeed <Int32>]
[-Count <Int32>]
[<CommonParameters>]
ShuffleParameterSet
Get-Random
[-InputObject] <Object[]>
[-SetSeed <Int32>]
[-Shuffle]
[<CommonParameters>]
説明
Get-Random コマンドレットは、ランダムに選択された番号を取得します。
Get-Randomにオブジェクトのコレクションを送信すると、そのコレクションからランダムに選択された 1 つ以上のオブジェクトが取得されます。
パラメーターまたは入力がない場合、 Get-Random コマンドは 0 (ゼロ) から Int32.MaxValue (0x7FFFFFFF, 2,147,483,647) までのランダムに選択された 32 ビット符号なし整数を返します。
既定では、 Get-Random は RandomNumberGenerator クラスを使用して暗号的に安全なランダム性を生成します。
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.92 未満のランダムな浮動小数点数を取得します。
Get-Random -Minimum 10.7 -Maximum 20.93
18.08467273887
例 5: 配列からランダムな整数を取得する
このコマンドは、指定した配列からランダムに選択された数値を取得します。
1, 2, 3, 5, 8, 13 | Get-Random
8
例 6: 配列から複数のランダムな整数を取得する
このコマンドは、配列からランダムに選択された 3 つの数値をランダムに取得します。
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
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 回ロールし、結果をカウントします。 最初のコマンド 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 未満の 3 つの乱数を取得します。
Get-Random -Count 3 -Maximum 10
9
0
8
例 13: 空の文字列または$nullで InputObject パラメーターを使用する
この例では、InputObject パラメーターは、空の文字列 ('') と $nullを含む配列を指定します。
Get-Random -InputObject @('a','',$null)
Get-Random は、 a、空の文字列、または $nullのいずれかを返します。 空のスティングは空白行として表示され、$null は PowerShell プロンプトに戻ります。
パラメーター
-Count
返すランダムなオブジェクトまたは数値の数を指定します。 既定値は 1 です。
InputObject と共に使用すると、Count の値がコレクション内のオブジェクトの数を超えると、Get-Random はすべてのオブジェクトをランダムな順序で返します。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
RandomNumberParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
RandomListItemParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-InputObject
オブジェクトのコレクションを指定します。
Get-Random は、Countで指定された数まで、ランダムに選択されたオブジェクトをコレクションからランダムに取得します。 オブジェクト、オブジェクトを含む変数、またはオブジェクトを取得するコマンドまたは式を入力します。 オブジェクトのコレクションをパイプ処理して Get-Randomすることもできます。
PowerShell 7 以降では、InputObject パラメーターは、空の文字列または $nullを含むことができる配列を受け入れます。 配列は、パイプラインに送信することも、InputObject パラメーター値として送信することもできます。
パラメーターのプロパティ
| 型: | Object[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
RandomListItemParameterSet
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
ShuffleParameterSet
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Maximum
乱数の最大値を指定します。
Get-Random 最大値より小さい (等しくない) 値を返します。 整数、倍精度浮動小数点数、または数値文字列 ("100") などの整数または double に変換できるオブジェクトを入力します。
Maximum の値は、Minimumの値より大きくする必要があります。
Maximum または Minimum の値が浮動小数点数の場合、Get-Random はランダムに選択された浮動小数点数を返します。
64 ビット コンピューターでは、Minimum の値が 32 ビット整数の場合、Maximum の既定値は Int32.MaxValue です。
Minimum の値が double (浮動小数点数) の場合、既定値の Maximum は Double.MaxValue です。 それ以外の場合、既定値は Int32.MaxValue です。
パラメーターのプロパティ
| 型: | Object |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
RandomNumberParameterSet
| 配置: | 0 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Minimum
乱数の最小値を指定します。 整数、倍精度浮動小数点数、または数値文字列 ("100") などの整数または double に変換できるオブジェクトを入力します。 既定値は 0 (ゼロ) です。
Minimum の値は、Maximumの値より小さくする必要があります。
Maximum または Minimum の値が浮動小数点数の場合、Get-Random はランダムに選択された浮動小数点数を返します。
パラメーターのプロパティ
| 型: | Object |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
RandomNumberParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SetSeed
乱数ジェネレーターのシード値を指定します。 SetSeed を使用すると、コマンドレットは System.Random メソッドを使用して擬似乱数を生成しますが、これは暗号的にセキュリティで保護されていません。
注意事項
シードを設定すると、ランダムでない動作になります。
Get-Random コマンドを含むスクリプトのデバッグや分析など、動作を再現する場合にのみ使用してください。
このシード値は、SetSeed をもう一度使用するか、セッションを閉じるまで、現在のコマンドと、現在のセッション内の後続のすべての Get-Random コマンド 使用されます。 シードを既定値にリセットすることはできません。
パラメーターのプロパティ
| 型: | |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Shuffle
ランダム化された順序でコレクション全体を返します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ShuffleParameterSet
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
入力
Object
1 つ以上のオブジェクトをパイプ処理できます。
Get-Random パイプされたオブジェクトからランダムに値を選択します。
出力
System.Int32, System.Int64, System.Double
Get-Random 整数または浮動小数点数、または送信されたコレクションからランダムに選択されたオブジェクトを返します。
メモ
既定では、 Get-Random は RandomNumberGenerator クラスを使用して暗号的に安全なランダム性を生成します。
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を受け取りました。