Get-Random
乱数を取得するか、オブジェクトをコレクションからランダムに選択します。
構文
Get-Random
[-SetSeed <Int32>]
[[-Maximum] <Object>]
[-Minimum <Object>]
[-Count <Int32>]
[<CommonParameters>]
Get-Random
[-SetSeed <Int32>]
[-InputObject] <Object[]>
[-Count <Int32>]
[<CommonParameters>]
説明
Get-Random
コマンドレットは、ランダムに選択された番号を取得します。 Get-Random
にオブジェクトのコレクションを送信すると、そのコレクションからランダムに選択された 1 つ以上のオブジェクトが取得されます。
パラメーターまたは入力がない場合、 Get-Random
コマンドは、ランダムに選択された 0 (ゼロ) から [int32]::MaxValue
までの 32 ビット符号なし整数を返します。
Get-Random
のパラメーターを使用して、最小値と最大値、コレクションから返されるオブジェクトの数、またはシード番号を指定できます。
注意事項
Get-Random
では、暗号で安全なランダム性は保証されません。 シード値は、SetSeedを再度使用するか、セッションを閉じるまで、現在のコマンドと現在のセッション内の後続のすべてのGet-Random
コマンドに使用されます。 シードを既定値にリセットすることはできません。
シードを意図的に設定すると、ランダムでない反復可能な動作になります。 Get-Random
コマンドを含むスクリプトをデバッグまたは分析する場合など、動作を再現する場合にのみ使用する必要があります。 シード値は、インポートされたモジュールなど、同じセッション内の他のコードによって設定される可能性があることに注意してください。
PowerShell 7.4 には、暗号化によって安全なランダム性を保証する Get-SecureRandom
が含まれています。
例
例 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.93 未満のランダムな浮動小数点数を取得します。
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: コレクション全体をランダム化する
このコマンドは、ランダムな順序でコレクション全体を返します。
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
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
例 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
パラメーター
-Count
返すランダム オブジェクトの数を指定します。 既定値は 1 です。
コレクションを含む InputObject
で使用する場合:
- ランダムに選択された各項目は 1 回だけ返されます。
- Countの値がコレクション内のオブジェクトの数を超えると、コレクション内のすべてのオブジェクトがランダムな順序で返されます。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InputObject
オブジェクトのコレクションを指定します。 Get-Random
は、コレクションからランダムに選択されたオブジェクトを、 Count で指定された数までランダムに取得します。 オブジェクト、オブジェクトを含む変数、またはオブジェクトを取得するコマンドまたは式を入力します。 オブジェクトのコレクションをパイプ処理して Get-Random
することもできます。
型: | Object[] |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | 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 |
配置: | 0 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Minimum
乱数の最小値を指定します。 整数、倍精度浮動小数点数、または数値文字列 ("100") などの整数または double に変換できるオブジェクトを入力します。 既定値は 0 (ゼロ) です。
Minimumの値は、Maximumの値より小さくする必要があります。 Maximum または Minimum の値が浮動小数点数の場合、Get-Random
はランダムに選択された浮動小数点数を返します。
型: | Object |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SetSeed
乱数ジェネレーターのシード値を指定します。 SetSeed を使用すると、コマンドレットによって擬似乱数が生成されます。これは暗号化によって安全ではありません。
注意事項
シードを設定すると、ランダムでない動作になります。 Get-Random
コマンドを含むスクリプトをデバッグまたは分析する場合など、動作を再現する場合にのみ使用する必要があります。
このシード値は、SetSeedをもう一度使用するか、セッションを閉じるまで、現在のセッション内の現在のコマンドと後続のすべてのGet-Random
コマンドに使用されます。 シードを既定値にリセットすることはできません。
型: | Nullable<T>[Int32] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
任意のオブジェクトをこのコマンドレットにパイプできます。 パイプされたオブジェクトからランダムに値を選択します。
出力
このコマンドレットは、整数または浮動小数点数、または送信されたコレクションからランダムに選択されたオブジェクトを返します。
メモ
Get-Random
は、常に入力値と同じデータ型を返すわけではありません。 次の表に、各数値入力の種類の出力の種類を示します。
入力タイプ | 出力の種類 |
---|---|
SByte | 倍精度浮動小数点型 |
Byte | 倍精度浮動小数点型 |
Int16 | 倍精度浮動小数点型 |
UInt16 | 倍精度浮動小数点型 |
Int32 | Int32 |
UInt32 | 倍精度浮動小数点型 |
Int64 | Int64 |
UInt64 | 倍精度浮動小数点型 |
Double | Double |
Single | 倍精度浮動小数点型 |
Windows PowerShell 3.0 以降、 Get-Random
では 64 ビット整数がサポートされています。
PowerShell
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示