Ruft eine Zufallszahl ab oder wählt Objekte nach dem Zufallsprinzip aus einer Auflistung aus.

Syntax

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

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

Beschreibung

Mit dem Cmdlet "Get-Random" wird eine nach dem Zufallsprinzip ausgewählte Zahl abgerufen. Wenn Sie eine Auflistung von Objekten an Get-Random senden, werden ein oder mehrere nach dem Zufallsprinzip ausgewählte Objekte aus der Auflistung abgerufen.

Ohne Parameter oder Eingabe gibt ein Befehl "Get-Random" eine nach dem Zufallsprinzip ausgewählte 32-Bit-Ganzzahl ohne Vorzeichen zwischen 0 (null) und Int32.MaxValue (0x7FFFFFFF, 2.147.483.647) zurück.

Sie können mithilfe der Parameter von Get-Random einen numerischen Ausgangswert, den Mindest- und Höchstwert sowie die Anzahl der von einer gesendeten Auflistung zurückgegebenen Objekte angeben.

Parameter

-Count <int>

Bestimmt die Anzahl der zurückgegebenen Objekte. Der Standardwert ist 1. Wenn der Wert von Count die Anzahl der Objekte in der Auflistung überschreitet, gibt Get-Random alle Objekte in zufälliger Reihenfolge zurück.

Erforderlich?

false

Position?

named

Standardwert

1

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-InputObject <Object[]>

Gibt eine Auflistung von Objekten an. Mit Get-Random werden nach dem Zufallsprinzip ausgewählte Objekte in zufälliger Reihenfolge aus der Auflistung abgerufen. Geben Sie die Objekte, eine Variable, die die Objekte enthält, oder einen Befehl oder Ausdruck ein, mit dem die Objekte abgerufen werden. Sie können auch eine Auflistung von Objekten über die Pipeline an Get-Random übergeben.

Erforderlich?

true

Position?

1

Standardwert

Pipelineeingaben akzeptieren?

true (ByValue)

Platzhalterzeichen akzeptieren?

false

-Maximum <Object>

Gibt einen Höchstwert für die Zufallszahl an. Get-Random gibt einen Wert zurück, der kleiner als der Höchstwert (nicht gleich) ist. Geben Sie eine 32-Bit-Ganzzahl, eine Gleitkommazahl mit doppelter Genauigkeit oder ein Objekt ein, das in eine ganze Zahl oder eine Gleitkommazahl mit doppelter Genauigkeit konvertiert werden kann, z. B. eine numerische Zeichenfolge ("100"). Der Wert von Maximum muss größer als der Wert von Minimum (nicht gleich) sein.

Wenn der Wert von Maximum oder Minimum eine Gleitkommazahl ist, gibt Get-Random eine nach dem Zufallsprinzip ausgewählte Gleitkommazahl zurück.

Wenn der Wert von Minimum vom Typ "Double" (eine Gleitkommazahl) ist, lautet der Standardwert von Maximum "Double.MaxValue". Andernfalls ist der Standardwert "Int32.MaxValue" (2.147.483.647 oder 0x7FFFFFFF).

Erforderlich?

false

Position?

1

Standardwert

Int32.MaxValue

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-Minimum <Object>

Gibt einen Mindestwert für die Zufallszahl an. Geben Sie eine 32-Bit-Ganzzahl, eine Gleitkommazahl mit doppelter Genauigkeit oder ein Objekt ein, das in eine ganze Zahl oder eine Gleitkommazahl mit doppelter Genauigkeit konvertiert werden kann, z. B. eine numerische Zeichenfolge ("100"). Der Standardwert ist 0 (null).

Der Wert von Minimum muss kleiner als der Wert von Maximum (nicht gleich) sein. Wenn der Wert von Maximum oder Minimum eine Gleitkommazahl ist, gibt Get-Random eine nach dem Zufallsprinzip ausgewählte Gleitkommazahl zurück.

Erforderlich?

false

Position?

named

Standardwert

0

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-SetSeed

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

<CommonParameters>

Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.

Eingaben und Ausgaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.

Eingaben

System.Object

Sie können ein oder mehrere Objekte über die Pipeline an Get-Random übergeben. Get-Random wählt nach dem Zufallsprinzip Werte aus den über die Pipeline übergebenen Objekten aus.

Ausgaben

System.Object

Get-Random gibt eine ganze Zahl, eine Gleitkommazahl oder ein nach dem Zufallsprinzip aus einer gesendeten Auflistung ausgewähltes Objekt zurück.

Hinweise

Get-Random legt einen numerischen Standardausgangswert für jede Sitzung fest, der auf der Systemuhr zu Beginn der Sitzung basiert.

Beispiel 1

C:\PS>get-random

3951433

Beschreibung
-----------
Mit diesem Befehl wird eine nach dem Zufallsprinzip ausgewählte ganze Zahl zwischen 0 (null) und Int32.MaxValue abgerufen.






Beispiel 2

C:\PS>get-random -maximum 100

47

Beschreibung
-----------
Mit diesem Befehl wird eine nach dem Zufallsprinzip ausgewählte ganze Zahl zwischen 0 (null) und 99 abgerufen.






Beispiel 3

C:\PS>get-random -minimum -100 -maximum 100

-56

Beschreibung
-----------
Mit diesem Befehl wird eine nach dem Zufallsprinzip ausgewählte ganze Zahl zwischen -100 und 99 abgerufen.






Beispiel 4

C:\PS>get-random -min 10.7 -max 20.93

18.08467273887

Beschreibung
-----------
Mit diesem Befehl wird eine nach dem Zufallsprinzip ausgewählte Gleitkommazahl abgerufen, die größer oder gleich 10,7 und kleiner als 20,92 ist.






Beispiel 5

C:\PS>get-random -input 1, 2, 3, 5, 8, 13

8

Beschreibung
-----------
Mit diesem Befehl wird eine nach dem Zufallsprinzip ausgewählte Zahl aus dem angegebenen Array abgerufen.






Beispiel 6

C:\PS>get-random -input 1, 2, 3, 5, 8, 13 -count 3

3
1
13

Beschreibung
-----------
Mit diesem Befehl werden drei Zufallszahlen in zufälliger Reihenfolge aus dem Array abgerufen.






Beispiel 7

C:\PS>get-random -input 1, 2, 3, 5, 8, 13 -count ([int]::MaxValue)

2
3
5
1
8
13

Beschreibung
-----------
Mit diesem Befehl wird die gesamte Auflistung in zufälliger Reihenfolge zurückgegeben. Der Wert des Count-Parameters ist die statische MaxValue-Eigenschaft von ganzen Zahlen. 

Um eine gesamte Auflistung in zufälliger Reihenfolge zurückzugeben, geben Sie eine beliebige Zahl ein, die größer oder gleich der Anzahl der Objekte in der Auflistung ist.






Beispiel 8

C:\PS>get-random -input "red", "yellow", "blue"

yellow

Beschreibung
-----------
Dieser Befehl gibt einen Zufallswert aus einer nicht numerischen Auflistung zurück.






Beispiel 9

C:\PS>get-process | get-random

Handles  NPM(K)    PM(K)      WS(K) VM(M)   CPU(s)     Id ProcessName
-------  ------    -----      ----- -----   ------     -- -----------
    144       4     2080        488    36     0.48   3164 wmiprvse

Beschreibung
-----------
Mit diesem Befehl wird ein nach dem Zufallsprinzip ausgewählter Prozess aus der Auflistung von Prozessen auf dem Computer abgerufen.






Beispiel 10

C:\PS>get-content servers.txt | get-random -count (get-content servers.txt).count | foreach {invoke-expression -computer $_ -command 'get-process powershell'}

Beschreibung
-----------
Mit diesem Befehl wird auf einer Reihe von Remotecomputern ein Befehl in zufälliger Reihenfolge ausgeführt.






Beispiel 11

C:\PS>get-random -max 100 -setseed 23


# Commands with the default seed are pseudorandom
PS C:\ps-test> get-random -max 100
59
PS C:\ps-test> get-random -max 100
65
PS C:\ps-test> get-random -max 100
21

# Commands with the same seed are not random
PS C:\ps-test> get-random -max 100 -setseed 23
74
PS C:\ps-test> get-random -max 100 -setseed 23
74
PS C:\ps-test> get-random -max 100 -setseed 23
74

# SetSeed results in a repeatable series
PS C:\ps-test> get-random -max 100 -setseed 23
74
PS C:\ps-test> get-random -max 100
56
PS C:\ps-test> get-random -max 100
84
PS C:\ps-test> get-random -max 100
46
PS C:\ps-test> get-random -max 100 -setseed 23
74
PS C:\ps-test> get-random -max 100
56
PS C:\ps-test> get-random -max 100
84
PS C:\ps-test> get-random -max 100
46

Beschreibung
-----------
In diesem Beispiel werden die Auswirkungen der Verwendung des SetSeed-Parameters veranschaulicht. Da SetSeed nicht zufälliges Verhalten erzeugt, wird dieser Parameter i. d. R. nur verwendet, um Ergebnisse zu reproduzieren, z. B. beim Debuggen oder Analysieren eines Skripts.






Beispiel 12

C:\PS>$files = dir -path c:\* -recurse

C:\PS> $sample = $files | get-random -count 50

Beschreibung
-----------
Mit diesen Befehlen wird eine Zufallsstichprobe von 50 Dateien vom Laufwerk "C:" des lokalen Computers abgerufen.






Beispiel 13

C:\PS>get-random 10001

7600

Beschreibung
-----------
Mit diesem Befehl wird eine nach dem Zufallsprinzip ausgewählte ganze Zahl abgerufen, die kleiner als 10001 ist. Da sich der Maximum-Parameter an der ersten Position befindet, können Sie den Parameternamen weglassen, wenn der Wert der erste oder einzige unbenannte Parameter in dem Befehl ist.









Inhaltsverzeichnis