Get-SecureRandom

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

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

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

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.

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

Get-SecureRandom

3951433

Get-SecureRandom -Maximum 100

47

Get-SecureRandom -Minimum -100 -Maximum 100

56

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

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

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

8

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

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

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

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

yellow

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

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

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

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 tekenreeks wordt weergegeven als een lege regel en $null keert terug naar een PowerShell-prompt.

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

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

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

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