Get-SecureRandom

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

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

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

L’applet de commande Get-SecureRandom obtient un nombre sélectionné de manière aléatoire. Si vous envoyez une collection d’objets à Get-SecureRandom, 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-SecureRandom retourne un entier non signé 32 bits sélectionné de façon aléatoire comprise entre 0 (zéro) et [int32]::MaxValue.

Vous pouvez utiliser les paramètres de Get-SecureRandom pour spécifier les valeurs minimales et maximales et le nombre d’objets retournés à partir d’une collection.

Get-SecureRandom génère un caractère aléatoire sécurisé par chiffrement à l’aide de la classe RandomNumberGenerator.

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

Get-SecureRandom

3951433

Get-SecureRandom -Maximum 100

47

Get-SecureRandom -Minimum -100 -Maximum 100

56

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

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

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

3
1
13

Vous pouvez utiliser le paramètre Shuffle pour retourner l’intégralité de la collection dans un ordre aléatoire.

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

2
3
5
1
8
13

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

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

yellow

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-SecureRandom -Count 50

Cet exemple montre comment déployer une mort équitable 1200 fois et compter les résultats. La première commande, ForEach-Object répète l’appel à Get-SecureRandom à 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-SecureRandom
} | Group-Object | Select-Object Name,Count

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

Vous pouvez utiliser le paramètre Count sans Get-SecureRandomd’objets piping. L’exemple suivant obtient trois nombres aléatoires inférieurs à 10.

Get-SecureRandom -Count 3 -Maximum 10

9
0
8

Dans cet exemple, le paramètre InputObject spécifie un tableau qui contient une chaîne vide ('') et $null.

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

Get-SecureRandom retourne a, chaîne vide ou $null. La chaîne vide s’affiche sous la forme d’une ligne vide et $null retourne à une invite PowerShell.

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 n’importe quel objet vers cette applet de commande. Il sélectionne les valeurs de manière aléatoire à partir des objets redirigés.

Cette applet de commande retourne un nombre entier ou à virgule flottante, ou un objet sélectionné de façon aléatoire à partir d’une collection envoyée.

Get-SecureRandom ne retourne pas toujours le même type de données que la valeur d’entrée. Le tableau suivant montre le type de sortie pour chacun des types d’entrée numériques.