Get-Random

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

Get-Random
    [-InputObject] <Object[]>
    [-SetSeed <Int32>]
    [-Count <Int32>]
    [<CommonParameters>]

Get-Random
    [-InputObject] <Object[]>
    [-SetSeed <Int32>]
    [-Shuffle]
    [<CommonParameters>]

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

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

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

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

Get-Random

3951433

Get-Random -Maximum 100

47

Get-Random -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-Random -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-Random

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-Random -Count 3

3
1
13

Från och med PowerShell 7.1 kan du använda parametern Shuffle för att returnera hela samlingen i slumpmässig ordning.

1, 2, 3, 5, 8, 13 | Get-Random -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-Random

yellow

Det här exemplet visar effekten av att använda parametern SetSeed.

Eftersom SetSeed genererar icke-slumpmässigt beteende används det vanligtvis bara för att återskapa resultat, till exempel vid felsökning eller analys av ett skript.

# Commands with the default seed are pseudorandom
Get-Random -Maximum 100 -SetSeed 23
Get-Random -Maximum 100
Get-Random -Maximum 100
Get-Random -Maximum 100

32
25
93
95

# Commands with the same seed aren't random
Get-Random -Maximum 100 -SetSeed 23
Get-Random -Maximum 100 -SetSeed 23
Get-Random -Maximum 100 -SetSeed 23

32
32
32

# SetSeed results in a repeatable series
Get-Random -Maximum 100 -SetSeed 23
Get-Random -Maximum 100
Get-Random -Maximum 100
Get-Random -Maximum 100

32
25
93
95

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-Random -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-Random 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-Random
} | Group-Object | Select-Object Name,Count

Name Count
---- -----
1      206
2      199
3      196
4      226
5      185
6      188

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

Get-Random -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-Random -InputObject @('a','',$null)

Get-Random 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-Random returnerar inte alltid samma datatyp som indatavärdet. I följande tabell visas utdatatypen för var och en av de numeriska indatatyperna.

Från och med Windows PowerShell 3.0 stöder Get-Random 64-bitars heltal. I Windows PowerShell 2.0 omvandlas alla värden till System.Int32.

Från och med PowerShell 7 accepterar parametern InputObject i parameteruppsättningen RandomListItemParameterSet matriser som innehåller en tom sträng eller $null. I tidigare PowerShell-versioner accepterade endast parametern Maximum i parameteruppsättningen RandomNumberParameterSet en tom sträng eller $null.