Delen via

Get-SecureRandom

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee haalt u een willekeurig getal op of selecteert u objecten willekeurig uit een verzameling.

Syntaxis

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

Description

De cmdlet Get-SecureRandom haalt een willekeurig geselecteerd getal op. Als u een verzameling objecten naar Get-SecureRandomverzendt, worden een of meer willekeurig geselecteerde objecten uit de verzameling opgehaald.

Zonder parameters of invoer retourneert een Get-SecureRandom opdracht een willekeurig geselecteerd 32-bits geheel getal zonder teken tussen 0 (nul) en [int32]::MaxValue.

U kunt de parameters van Get-SecureRandom gebruiken om de minimum- en maximumwaarden en het aantal objecten op te geven dat wordt geretourneerd uit een verzameling.

Get-SecureRandom genereert cryptografisch veilige willekeurigheid met behulp van de klasse RandomNumberGenerator.

Voorbeelden

Voorbeeld 1: Een willekeurig geheel getal ophalen

Met deze opdracht wordt een willekeurig geheel getal tussen 0 (nul) en Int32.MaxValue.

Get-SecureRandom

3951433

Voorbeeld 2: Een willekeurig geheel getal tussen 0 en 99 ophalen

Get-SecureRandom -Maximum 100

47

Voorbeeld 3: Een willekeurig geheel getal ophalen tussen -100 en 99

Get-SecureRandom -Minimum -100 -Maximum 100

56

Voorbeeld 4: Een willekeurig drijvendekommagetal ophalen

Met deze opdracht wordt een willekeurig drijvendekommagetal groter dan of gelijk aan 10,7 en kleiner dan 20,93.

Get-SecureRandom -Minimum 10.7 -Maximum 20.93

18.08467273887

Voorbeeld 5: Een willekeurig geheel getal ophalen uit een matrix

Met deze opdracht wordt een willekeurig geselecteerd getal opgehaald uit de opgegeven matrix.

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

8

Voorbeeld 6: Verschillende willekeurige gehele getallen ophalen uit een matrix

Met deze opdracht worden drie willekeurig geselecteerde getallen in willekeurige volgorde uit een matrix opgehaald.

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

3
1
13

Voorbeeld 7: Een hele verzameling willekeurig maken

U kunt de parameter Shuffle gebruiken om de hele verzameling in een willekeurige volgorde te retourneren.

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

2
3
5
1
8
13

Voorbeeld 8: Een willekeurige niet-numerieke waarde ophalen

Met deze opdracht wordt een willekeurige waarde uit een niet-numerieke verzameling geretourneerd.

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

yellow

Voorbeeld 9: Willekeurige bestanden ophalen

Met deze opdrachten krijgt u een willekeurig geselecteerd voorbeeld van 50 bestanden van het C: station van de lokale computer.

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

Voorbeeld 10: Roll fair dice

In dit voorbeeld wordt een fair die 1200 keer meegeteld en worden de resultaten geteld. De eerste opdracht, ForEach-Object herhaalt de aanroep naar Get-SecureRandom van de doorgesluisde nummers (1-6). De resultaten worden gegroepeerd op hun waarde met Group-Object en opgemaakt als een tabel met 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

Voorbeeld 11: De parameter Aantal gebruiken

U kunt de parameter Count gebruiken zonder dat u objecten hoeft te Get-SecureRandom. In het volgende voorbeeld worden drie willekeurige getallen kleiner dan 10 weergegeven.

Get-SecureRandom -Count 3 -Maximum 10

9
0
8

Voorbeeld 12: gebruik de parameter InputObject met een lege tekenreeks of $null

In dit voorbeeld geeft de parameter InputObject een matrix op die een lege tekenreeks ('') en $nullbevat.

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

Get-SecureRandom retourneert a, lege tekenreeks of $null. De lege sting wordt weergegeven als een lege regel en $null terugkeert naar een PowerShell-prompt.

Parameters

-Count

Hiermee geeft u het aantal willekeurige objecten dat moet worden geretourneerd. De standaardwaarde is 1.

Bij gebruik met InputObject met een verzameling:

  • Elk willekeurig geselecteerd item wordt slechts één keer geretourneerd.
  • Als de waarde van Count het aantal objecten in de verzameling overschrijdt, worden alle objecten in de verzameling in willekeurige volgorde geretourneerd.
Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InputObject

Hiermee geeft u een verzameling objecten op. Get-SecureRandom willekeurig geselecteerde objecten in willekeurige volgorde uit de verzameling ophaalt tot het getal dat is opgegeven door Count. Voer de objecten, een variabele in die de objecten bevat, of een opdracht of expressie waarmee de objecten worden opgehaald. U kunt ook een verzameling objecten doorsluisen naar Get-SecureRandom.

De parameter InputObject accepteert matrices die een lege tekenreeks of $nullkunnen bevatten. De matrix kan worden verzonden naar de pijplijn of als een InputObject parameterwaarde.

Type:Object[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Maximum

Hiermee geeft u een maximumwaarde voor het willekeurige getal. Get-SecureRandom retourneert een waarde die kleiner is dan het maximum (niet gelijk aan). Voer een geheel getal, een drijvendekommagetal met dubbele precisie of een object in dat kan worden geconverteerd naar een geheel getal of dubbel, zoals een numerieke tekenreeks ('100').

De waarde van Maximum moet groter zijn dan (niet gelijk aan) de waarde van Minimum. Als de waarde van Maximum of Minimum een drijvendekommagetal is, geeft Get-SecureRandom een willekeurig geselecteerd drijvendekommagetal als resultaat.

Als op een 64-bits computer de waarde van Minimum een 32-bits geheel getal is, is de standaardwaarde van MaximumInt32.MaxValue.

Als de waarde van Minimum een dubbele waarde is (een drijvendekommagetal), is de standaardwaarde van MaximumDouble.MaxValue. Anders wordt de standaardwaarde Int32.MaxValue.

Type:Object
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Minimum

Hiermee geeft u een minimumwaarde voor het willekeurige getal. Voer een geheel getal, een drijvendekommagetal met dubbele precisie of een object in dat kan worden geconverteerd naar een geheel getal of dubbel, zoals een numerieke tekenreeks ('100'). De standaardwaarde is 0 (nul).

De waarde van Minimum moet kleiner zijn dan (niet gelijk aan) de waarde van Maximum. Als de waarde van Maximum of Minimum een drijvendekommagetal is, geeft Get-SecureRandom een willekeurig geselecteerd drijvendekommagetal als resultaat.

Type:Object
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Shuffle

Retourneert de volledige verzameling in een gerandomiseerde volgorde.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

Object

U kunt elk object doorsluisen naar deze cmdlet. Er worden willekeurig waarden uit de gesluisde objecten geselecteerd.

Uitvoerwaarden

Int32

Int64

Double

PSObject

Met deze cmdlet wordt een geheel getal of een drijvendekommagetal geretourneerd, of een object dat willekeurig is geselecteerd uit een ingediende verzameling.

Notities

Get-SecureRandom retourneert niet altijd hetzelfde gegevenstype als de invoerwaarde. In de volgende tabel ziet u het uitvoertype voor elk van de numerieke invoertypen.

Invoertype Uitvoertype
SByte Dubbel
Byte Dubbel
Int16 Dubbel
UInt16 Dubbel
Int32 Int32
UInt32 Dubbel
Int64 Int64
UInt64 Dubbel
Dubbel Dubbel
Ongetrouwd Dubbel