Get-SecureRandom

乱数を取得するか、コレクションからオブジェクトをランダムに選択します。

構文

RandomNumberParameterSet (既定)

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

RandomListItemParameterSet

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

ShuffleParameterSet

Get-SecureRandom
    [-InputObject] <Object[]>
    [-Shuffle]
    [<CommonParameters>]

説明

Get-SecureRandom コマンドレットは、ランダムに選択された番号を取得します。 Get-SecureRandomにオブジェクトのコレクションを送信すると、そのコレクションからランダムに選択された 1 つ以上のオブジェクトが取得されます。

パラメーターまたは入力がない場合、 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: 配列から複数のランダムな整数を取得する

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

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 未満の 3 つの乱数を取得します。

Get-SecureRandom -Count 3 -Maximum 10
9
0
8

例 12: 空の文字列または$nullで InputObject パラメーターを使用する

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

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

Get-SecureRandom は、 a、空の文字列、または $nullを返します。 空の文字列は空白行として表示され、 $null は PowerShell プロンプトに戻ります。

パラメーター

-Count

返すランダム オブジェクトの数を指定します。 既定値は 1 です。

コレクションを含む InputObject で使用する場合:

  • ランダムに選択された各項目は 1 回だけ返されます。
  • Count の値がコレクション内のオブジェクトの数を超えると、コレクション内のすべてのオブジェクトがランダムな順序で返されます。

パラメーターのプロパティ

型:Int32
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

RandomNumberParameterSet
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
RandomListItemParameterSet
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-InputObject

オブジェクトのコレクションを指定します。 Get-SecureRandom は、 コレクションから Count で指定された数までのランダムに選択されたオブジェクトをランダムに取得します。 オブジェクト、オブジェクトを含む変数、またはオブジェクトを取得するコマンドまたは式を入力します。 オブジェクトのコレクションをパイプ処理して Get-SecureRandomすることもできます。

InputObject パラメーターは、空の文字列または$nullを含むことができる配列を受け入れます。 配列は、パイプラインまたは InputObject パラメーター値として送信できます。

パラメーターのプロパティ

型:

Object[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

RandomListItemParameterSet
配置:0
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ShuffleParameterSet
配置:0
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Maximum

乱数の最大値を指定します。 Get-SecureRandom は、最大値 (等しくない) より小さい値を返します。 整数、倍精度浮動小数点数、または数値文字列 ("100") などの整数または double に変換できるオブジェクトを入力します。

Maximum の値は、Minimum の値より大きい (等しくない) 必要があります。 Maximum または Minimum の値が浮動小数点数の場合、Get-SecureRandomはランダムに選択された浮動小数点数を返します。

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-SecureRandomはランダムに選択された浮動小数点数を返します。

パラメーターのプロパティ

型:Object
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

RandomNumberParameterSet
配置: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

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

出力

Int32

Int64

Double

PSObject

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

メモ

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

入力の種類 出力の種類
SByte Double
Byte Double
Int16 Double
UInt16 Double
Int32 Int32
UInt32 Double
Int64 Int64
UInt64 Double
Double Double
Single Double