Get-Random

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

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

L’applet de commande Get-Random obtient un nombre sélectionné de manière aléatoire. Si vous envoyez une collection d’objets à Get-Random, elle obtient un ou plusieurs objets sélectionnés de manière aléatoire à partir de la collection.

Sans paramètres ni entrée, une commande Get-Random retourne un entier non signé 32 bits sélectionné de manière aléatoire entre 0 (zéro) et Int32.MaxValue (0x7FFFFFFF, 2,147,483,647).

Vous pouvez utiliser les paramètres de Get-Random pour spécifier un nombre de départs, des valeurs minimales et maximales, ainsi que le nombre d’objets retournés à partir d’une collection envoyée.

Cette commande obtient un entier aléatoire compris entre 0 (zéro) et Int32.MaxValue.

Get-Random

3951433

Get-Random -Maximum 100

47

Get-Random -Minimum -100 -Maximum 100

56

Cette commande obtient un nombre à virgule flottante aléatoire supérieur ou égal à 10,7 et inférieur à 20,92.

Get-Random -Minimum 10.7 -Maximum 20.93

18.08467273887

Cette commande obtient un nombre sélectionné de manière aléatoire dans le tableau spécifié.

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

8

Cette commande obtient trois nombres sélectionnés de façon aléatoire dans un ordre aléatoire à partir d’un tableau.

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

3
1
13

Cette commande retourne l’intégralité de la collection dans l’ordre aléatoire.

La valeur du paramètre Count est la propriété statique MaxValue des entiers.

Pour renvoyer une collection entière dans un ordre aléatoire, entrez un nombre supérieur ou égal au nombre d’objets de la collection.

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

2
3
5
1
8
13

Cette commande retourne une valeur aléatoire d’une collection non numérique.

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

yellow

Cet exemple montre l’effet de l’utilisation du paramètre de SetSeed.

Étant donné que SetSeed produit un comportement non aléatoire, il est généralement utilisé uniquement pour reproduire les résultats, comme lors du débogage ou de l’analyse d’un script.

# 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

74
56
84
46

# Commands with the same seed are not random
Get-Random -Maximum 100 -SetSeed 23
Get-Random -Maximum 100 -SetSeed 23
Get-Random -Maximum 100 -SetSeed 23

74
74
74

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

74
56
84
46

Ces commandes obtiennent un échantillon aléatoire de 50 fichiers à partir du lecteur C: de l’ordinateur local.

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

Cet exemple montre comment déployer une mort équitable 1200 fois et compter les résultats. La première commande, For-EachObject répète l’appel à Get-Random à partir du canal en nombres (1 à 6). Les résultats sont regroupés par leur valeur avec Group-Object et mis en forme sous forme de tableau avec 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

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Vous pouvez diriger un ou plusieurs objets. Get-Random sélectionne des valeurs de manière aléatoire à partir des objets redirigés.

Get-Random retourne un nombre entier ou à virgule flottante, ou un objet sélectionné de façon aléatoire à partir d’une collection soumise.

Get-Random définit une valeur initiale par défaut pour chaque session en fonction de l’horloge de temps système au démarrage de la session.

À compter de Windows PowerShell 3.0, Get-Random prend en charge les entiers 64 bits. Dans Windows PowerShell 2.0, toutes les valeurs sont converties en System.Int32.