Get-Random

Modul:: Microsoft.PowerShell.Utility Module

Získá náhodné číslo nebo vybere objekty náhodně z kolekce.

Syntax

RandomNumberParameterSet (Výchozí)

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

RandomListItemParameterSet

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

Description

Rutina Get-Random získá náhodně vybrané číslo. Pokud odešlete kolekci objektů do Get-Random, získá jeden nebo více náhodně vybraných objektů z kolekce.

Bez parametrů nebo vstupu vrátí příkaz Get-Random náhodně vybrané 32bitové celé číslo bez znaménka mezi 0 (nula) a [int32]::MaxValue.

Parametry Get-Random můžete použít k určení minimálních a maximálních hodnot, počtu objektů vrácených z kolekce nebo počátečního čísla.

Upozornění

Get-Random nezajistí kryptograficky zabezpečenou náhodnost. Počáteční hodnota se používá pro aktuální příkaz a pro všechny následné příkazy Get-Random v aktuální relaci, dokud nepoužijete SetSeed znovu nebo relaci zavřete. Počáteční hodnotu nemůžete obnovit na výchozí hodnotu.

Záměrně nastavení počátečních hodnot vede k nenáhodným a opakovatelným chováním. Mělo by se použít pouze při pokusu o reprodukci chování, například při ladění nebo analýze skriptu, který obsahuje příkazy Get-Random. Mějte na paměti, že počáteční hodnotu může nastavit jiný kód ve stejné relaci, například importovaný modul.

PowerShell 7.4 obsahuje Get-SecureRandom, což zajišťuje kryptograficky bezpečnou náhodnost.

Příklady

Příklad 1: Získání náhodného celého čísla

Tento příkaz získá náhodné celé číslo mezi 0 (nula) a Int32.MaxValue.

Get-Random

Příklad 2: Získání náhodného celého čísla mezi 0 a 99

Get-Random -Maximum 100

Příklad 3: Získání náhodného celého čísla mezi -100 a 99

Get-Random -Minimum -100 -Maximum 100

Příklad 4: Získání náhodného čísla s plovoucí desetinou čárkou

Tento příkaz získá náhodné číslo s plovoucí desetinou čárkou větší nebo rovno 10,7 a menší než 20,93.

Get-Random -Minimum 10.7 -Maximum 20.93

18.08467273887

Příklad 5: Získání náhodného celého čísla z pole

Tento příkaz získá náhodně vybrané číslo ze zadaného pole.

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

Příklad 6: Získání několika náhodných celých čísel z pole

Tento příkaz získá ze pole tři náhodně vybraná čísla v náhodném pořadí.

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

3
1
13

Příklad 7: Randomizace celé kolekce

Tento příkaz vrátí celou kolekci v náhodném pořadí.

Hodnota parametru Count je MaxValue statickou vlastnost celých čísel.

Pokud chcete vrátit celou kolekci v náhodném pořadí, zadejte libovolné číslo, které je větší nebo rovno počtu objektů v kolekci.

1, 2, 3, 5, 8, 13 | Get-Random -Count ([int]::MaxValue)

Příklad 8: Získání náhodné nečíselné hodnoty

Tento příkaz vrátí náhodnou hodnotu z nečíselné kolekce.

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

yellow

Příklad 9: Použití parametru SetSeed

Tento příklad ukazuje účinek použití parametru SetSeed.

Vzhledem k tomu, že SetSeed vytváří nenáhodné chování, obvykle se používá pouze k reprodukování výsledků, například při ladění nebo analýze skriptu.

# 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

# 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

Příklad 10: Získání náhodných souborů

Tyto příkazy z C: jednotky místního počítače získají náhodně vybraný vzorek 50 souborů.

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

Příklad 11: Roll fair kostka

V tomto příkladu se zobrazí spravedlivé kostky 1200krát a spočítá výsledky. První příkaz ForEach-Object opakuje volání Get-Random z předaných čísel (1–6). Výsledky jsou seskupené podle jejich hodnoty s Group-Object a formátovány jako tabulka s 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

Parametry

-Count

Určuje počet náhodných objektů, které se mají vrátit. Výchozí hodnota je 1.

Při použití s InputObject obsahující kolekci:

Každá náhodně vybraná položka se vrátí pouze jednou.
Pokud hodnota Count překročí počet objektů v kolekci, vrátí se všechny objekty v kolekci v náhodném pořadí.

Vlastnosti parametru

Typ:	Int32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

RandomListItemParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-InputObject

Určuje kolekci objektů. Get-Random získá náhodně vybrané objekty v náhodném pořadí z kolekce až do čísla určeného Počet. Zadejte objekty, proměnnou, která obsahuje objekty, nebo příkaz nebo výraz, který objekty získá. Kolekci objektů můžete také pipetovat do Get-Random.

Vlastnosti parametru

Typ:	Object[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

RandomListItemParameterSet

Position:	0
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Maximum

Určuje maximální hodnotu náhodného čísla. Get-Random vrátí hodnotu, která je menší než maximum (nerovná se). Zadejte celé číslo, číslo s plovoucí desetinnou čárkou s dvojitou přesností nebo objekt, který lze převést na celé číslo nebo dvojité číslo, například číselný řetězec ("100").

Hodnota Maximální musí být větší než (nerovná se) hodnota Minimální. Pokud je hodnota Maximum nebo Minimum číslo s plovoucí desetinou čárkou, Get-Random vrátí náhodně vybrané číslo s plovoucí desetinou čárkou.

Pokud je v 64bitovém počítači hodnota Minimální 32bitové celé číslo, výchozí hodnota Maximum je Int32.MaxValue.

Pokud je hodnota Minimální dvojitá (číslo s plovoucí desetinou čárkou), výchozí hodnota Maximum je Double.MaxValue. V opačném případě je výchozí hodnota Int32.MaxValue.

Vlastnosti parametru

Typ:	Object
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

RandomNumberParameterSet

Position:	0
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Minimum

Určuje minimální hodnotu náhodného čísla. Zadejte celé číslo, číslo s plovoucí desetinnou čárkou s dvojitou přesností nebo objekt, který lze převést na celé číslo nebo dvojité číslo, například číselný řetězec ("100"). Výchozí hodnota je 0 (nula).

Hodnota Minimální musí být menší než (nerovná se) hodnota Maximum. Pokud je hodnota Maximum nebo Minimum číslo s plovoucí desetinou čárkou, Get-Random vrátí náhodně vybrané číslo s plovoucí desetinou čárkou.

Vlastnosti parametru

Typ:	Object
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

RandomNumberParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-SetSeed

Určuje počáteční hodnotu generátoru náhodných čísel. Když použijete SetSeed, rutina vygeneruje pseudonáhodná čísla, která nejsou kryptograficky zabezpečená.

Upozornění

Nastavení počátečních hodnot vede k nenáhodným chováním. Mělo by se použít pouze při pokusu o reprodukci chování, například při ladění nebo analýze skriptu, který obsahuje příkazy Get-Random.

Tato počáteční hodnota se používá pro aktuální příkaz a pro všechny následné příkazy Get-Random v aktuální relaci, dokud nepoužijete SetSeed znovu nebo relaci zavřete. Počáteční hodnotu nemůžete obnovit na výchozí hodnotu.

Vlastnosti parametru

Typ:	Nullable<T>[Int32]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

Object

K tomuto cmdletu můžete přesměrovat libovolný objekt. Vybere hodnoty náhodně z svislých objektů.

Poznámky

Get-Random nevrací vždy stejný datový typ jako vstupní hodnota. Následující tabulka uvádí výstupní typ pro každý z číselných typů vstupu.

Typ vstupu	Typ výstupu
SByte	Dvojitý
byte	Dvojitý
Int16	Dvojitý
UInt16	Dvojitý
Int32	Int32
UInt32	Dvojitý
Int64	Int64
UInt64	Dvojitý
Dvojitý	Dvojitý
Jediný	Dvojitý

Počínaje windows PowerShellem 3.0 Get-Random podporuje 64bitové celá čísla.

Váš názor

Byla tato stránka užitečná?

Sdílet prostřednictvím

Get-Random

Syntax

RandomNumberParameterSet (Výchozí)

RandomListItemParameterSet

Description

Příklady

Příklad 1: Získání náhodného celého čísla

Příklad 2: Získání náhodného celého čísla mezi 0 a 99

Příklad 3: Získání náhodného celého čísla mezi -100 a 99

Příklad 4: Získání náhodného čísla s plovoucí desetinou čárkou

Příklad 5: Získání náhodného celého čísla z pole

Příklad 6: Získání několika náhodných celých čísel z pole

Příklad 7: Randomizace celé kolekce

Příklad 8: Získání náhodné nečíselné hodnoty

Příklad 9: Použití parametru SetSeed

Příklad 10: Získání náhodných souborů

Příklad 11: Roll fair kostka

Parametry

-Count

Vlastnosti parametru

Sady parametrů

-InputObject

Vlastnosti parametru

Sady parametrů

-Maximum

Vlastnosti parametru

Sady parametrů

-Minimum

Vlastnosti parametru

Sady parametrů

-SetSeed

Vlastnosti parametru

Sady parametrů

CommonParameters

Vstupy

Object

Výstupy

Int32

Int64

Double

PSObject

Poznámky

Váš názor