Get-SecureRandom

Składnia

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

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

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

Opis

Polecenie Get-SecureRandom cmdlet pobiera losowo wybraną liczbę. W przypadku przesyłania kolekcji obiektów do Get-SecureRandomobiektu zostanie ona pobierana co najmniej jeden losowo wybrany obiekt z kolekcji.

Bez parametrów lub danych wejściowych Get-SecureRandom polecenie zwraca losowo wybraną 32-bitową liczbę całkowitą bez znaku z zakresu od 0 (zero) do [int32]::MaxValue.

Możesz użyć parametrów , Get-SecureRandom aby określić minimalne i maksymalne wartości oraz liczbę obiektów zwracanych z kolekcji.

Get-SecureRandom generuje kryptograficznie bezpieczną losowość przy użyciu klasy RandomNumberGenerator .

Przykłady

Przykład 1. Pobieranie losowej liczby całkowitej

To polecenie pobiera losową liczbę całkowitą z zakresu od 0 (zero) do Int32.MaxValue.

Get-SecureRandom

3951433

Przykład 2: Pobieranie losowej liczby całkowitej z zakresu od 0 do 99

Get-SecureRandom -Maximum 100

47

Przykład 3. Pobieranie losowej liczby całkowitej z zakresu od -100 do 99

Get-SecureRandom -Minimum -100 -Maximum 100

56

Przykład 4. Pobieranie losowej liczby zmiennoprzecinkowej

To polecenie pobiera losową liczbę zmiennoprzecinkową większą lub równą 10,7 i mniejszą niż 20,93.

Get-SecureRandom -Minimum 10.7 -Maximum 20.93

18.08467273887

Przykład 5. Pobieranie losowej liczby całkowitej z tablicy

To polecenie pobiera losowo wybraną liczbę z określonej tablicy.

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

8

Przykład 6. Pobieranie kilku losowych liczb całkowitych z tablicy

To polecenie pobiera trzy losowo wybrane liczby w kolejności losowej z tablicy.

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

3
1
13

Przykład 7. Losowe określanie całej kolekcji

Możesz użyć parametru Shuffle , aby zwrócić całą kolekcję w kolejności losowej.

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

2
3
5
1
8
13

Przykład 8. Pobieranie losowej wartości nieliczbowej

To polecenie zwraca losową wartość z kolekcji nieliczbowej.

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

yellow

Przykład 9. Pobieranie losowych plików

Te polecenia pobierają losowo wybraną próbkę 50 plików z C: dysku komputera lokalnego.

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

Przykład 10: rzutowania kostką

W tym przykładzie rzutuje uczciwą kostkę 1200 razy i zlicza wyniki. Pierwsze polecenie ForEach-Object powtarza wywołanie Get-SecureRandom z potoku w liczbach (1–6). Wyniki są grupowane według ich wartości Group-Object i sformatowane jako tabela z wartością 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

Przykład 11. Użyj parametru Count

Możesz użyć parametru Count bez obiektów potokowych do Get-SecureRandom. Poniższy przykład pobiera trzy losowe liczby mniejsze niż 10.

Get-SecureRandom -Count 3 -Maximum 10

9
0
8

Przykład 12: Użyj parametru InputObject z pustym ciągiem lub $null

W tym przykładzie parametr InputObject określa tablicę zawierającą pusty ciąg ('') i $null.

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

Get-SecureRandom Zwraca wartość a, ciąg pusty lub $null. Pusta sting jest wyświetlana jako pusty wiersz i $null wraca do wiersza programu PowerShell.

Parametry

-Count

-InputObject

-Maximum

-Minimum

-Shuffle

Dane wejściowe

Object

Do tego polecenia cmdlet można przekazać dowolny obiekt. Wybiera wartości losowo z obiektów potokowych.

Dane wyjściowe

Int32

Int64

Double

PSObject

To polecenie cmdlet zwraca liczbę całkowitą lub zmiennoprzecinkową albo obiekt wybrany losowo z przesłanej kolekcji.

Uwagi

Get-SecureRandom Nie zawsze zwraca ten sam typ danych co wartość wejściowa. W poniższej tabeli przedstawiono typ danych wyjściowych dla każdego z typów danych wejściowych liczbowych.

Typ danych wejściowych	Typ danych wyjściowych
SByte	Liczba rzeczywista
Byte	Liczba rzeczywista
Int16	Liczba rzeczywista
UInt16	Liczba rzeczywista
Int32	Int32
UInt32	Liczba rzeczywista
Int64	Int64
UInt64	Liczba rzeczywista
Liczba rzeczywista	Liczba rzeczywista
Pojedynczy	Liczba rzeczywista

Linki powiązane

• Get-Random