Get-SecureRandom

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

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

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

Cmdleten Get-SecureRandom hämtar ett slumpmässigt valt tal. Om du skickar en samling objekt till Get-SecureRandomhämtar den ett eller flera slumpmässigt markerade objekt från samlingen.

Utan parametrar eller indata returnerar ett Get-SecureRandom-kommando ett slumpmässigt valt 32-bitars osignerat heltal mellan 0 (noll) och [int32]::MaxValue.

Du kan använda parametrarna för Get-SecureRandom för att ange lägsta och högsta värden och antalet objekt som returneras från en samling.

Get-SecureRandom genererar kryptografiskt säker slumpmässighet med hjälp av klassen RandomNumberGenerator.

Det här kommandot hämtar ett slumpmässigt heltal mellan 0 (noll) och Int32.MaxValue.

Get-SecureRandom

3951433

Get-SecureRandom -Maximum 100

47

Get-SecureRandom -Minimum -100 -Maximum 100

56

Det här kommandot hämtar ett slumpmässigt flyttalsnummer som är större än eller lika med 10,7 och mindre än 20,93.

Get-SecureRandom -Minimum 10.7 -Maximum 20.93

18.08467273887

Det här kommandot hämtar ett slumpmässigt valt tal från den angivna matrisen.

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

8

Det här kommandot hämtar tre slumpmässigt valda tal i slumpmässig ordning från en matris.

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

3
1
13

Du kan använda parametern Shuffle för att returnera hela samlingen i slumpmässig ordning.

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

2
3
5
1
8
13

Det här kommandot returnerar ett slumpmässigt värde från en icke-numerisk samling.

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

yellow

Dessa kommandon får ett slumpmässigt valt exempel på 50 filer från den C: enheten på den lokala datorn.

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

Det här exemplet rullar en rättvis tärning 1200 gånger och räknar resultatet. Det första kommandot, ForEach-Object upprepar anropet till Get-SecureRandom från piped i tal (1-6). Resultaten grupperas efter deras värde med Group-Object och formateras som en tabell med 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

Du kan använda parametern Count utan att skicka rörobjekt till att Get-SecureRandom. I följande exempel hämtas tre slumpmässiga tal som är mindre än 10.

Get-SecureRandom -Count 3 -Maximum 10

9
0
8

I det här exemplet anger parametern InputObject en matris som innehåller en tom sträng ('') och $null.

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

Get-SecureRandom returnerar antingen a, tom sträng eller $null. Den tomma strängen visas som en tom rad och $null återgår till en PowerShell-prompt.

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Du kan skicka valfritt objekt till den här cmdleten. Den väljer värden slumpmässigt från piped-objekten.

Den här cmdleten returnerar ett heltal eller flyttalsnummer, eller ett objekt som valts slumpmässigt från en skickad samling.

Get-SecureRandom returnerar inte alltid samma datatyp som indatavärdet. I följande tabell visas utdatatypen för var och en av de numeriska indatatyperna.