Get-Random
Obtém um número aleatório ou seleciona objetos aleatoriamente de uma coleção.
Syntax
Get-Random
[-SetSeed <Int32>]
[[-Maximum] <Object>]
[-Minimum <Object>]
[-Count <Int32>]
[<CommonParameters>]
Get-Random
[-SetSeed <Int32>]
[-InputObject] <Object[]>
[-Count <Int32>]
[<CommonParameters>]
Get-Random
[-SetSeed <Int32>]
[-InputObject] <Object[]>
[-Shuffle]
[<CommonParameters>]
Description
O Get-Random
cmdlet obtém um número selecionado aleatoriamente. Se você enviar uma coleção de objetos para Get-Random
, ele obterá um ou mais objetos selecionados aleatoriamente da coleção.
Sem parâmetros ou entrada, um Get-Random
comando retorna um inteiro sem sinal de 32 bits selecionado aleatoriamente entre 0 (zero) e Int32.MaxValue (0x7FFFFFFF
, 2,147,483,647
).
Por padrão, Get-Random
gera aleatoriedade criptograficamente segura usando a classe RandomNumberGenerator .
Você pode usar os parâmetros de Get-Random
para especificar os valores mínimo e máximo, o número de objetos retornados de uma coleção ou um número de semente.
Cuidado
Definir a semente deliberadamente resulta em um comportamento não aleatório e repetível. Ele só deve ser usado ao tentar reproduzir o comportamento, como ao depurar ou analisar um script que inclua Get-Random
comandos.
Esse valor de semente é usado para o comando atual e para todos os comandos subsequentes Get-Random
na sessão atual até que você use SetSeed novamente ou feche a sessão. Você não pode redefinir a semente para seu valor padrão.
Exemplos
Exemplo 1: Obter um inteiro aleatório
Esse comando obtém um inteiro aleatório entre 0 (zero) e Int32.MaxValue.
Get-Random
3951433
Exemplo 2: Obter um inteiro aleatório entre 0 e 99
Get-Random -Maximum 100
47
Exemplo 3: Obter um inteiro aleatório entre -100 e 99
Get-Random -Minimum -100 -Maximum 100
56
Exemplo 4: Obter um número de ponto flutuante aleatório
Esse comando obtém um número de ponto flutuante aleatório maior ou igual a 10.7 e menor que 20.92.
Get-Random -Minimum 10.7 -Maximum 20.93
18.08467273887
Exemplo 5: Obter um inteiro aleatório de uma matriz
Esse comando obtém um número selecionado aleatoriamente da matriz especificada.
1, 2, 3, 5, 8, 13 | Get-Random
8
Exemplo 6: Obter vários inteiros aleatórios de uma matriz
Esse comando obtém três números selecionados aleatoriamente em ordem aleatória de uma matriz.
1, 2, 3, 5, 8, 13 | Get-Random -Count 3
3
1
13
Exemplo 7: Randomizar uma coleção inteira
A partir do PowerShell 7.1, você pode usar o parâmetro Shuffle para retornar toda a coleção em uma ordem aleatória.
1, 2, 3, 5, 8, 13 | Get-Random -Shuffle
2
3
5
1
8
13
Exemplo 8: Obter um valor não numérico aleatório
Esse comando retorna um valor aleatório de uma coleção não numérica.
"red", "yellow", "blue" | Get-Random
yellow
Exemplo 9: usar o parâmetro SetSeed
Este exemplo mostra o efeito do uso do parâmetro SetSeed.
Como o SetSeed produz um comportamento não aleatório, normalmente é usado apenas para reproduzir resultados, como ao depurar ou analisar um 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
Exemplo 10: Obter arquivos aleatórios
Esses comandos obtêm um exemplo selecionado aleatoriamente de 50 arquivos da C:
unidade do computador local.
$Files = Get-ChildItem -Path C:\* -Recurse
$Sample = $Files | Get-Random -Count 50
Exemplo 11: Rolar dados justos
Este exemplo acumula uma morte justa 1200 vezes e conta os resultados. O primeiro comando ForEach-Object
repete a chamada para Get-Random
do canalizado em números (1-6). Os resultados são agrupados por seu valor com Group-Object
e formatados como uma tabela com 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
Exemplo 12: usar o parâmetro Count
Agora você pode usar o parâmetro Count sem canalizar objetos para Get-Random
.
O exemplo a seguir obtém três números aleatórios menores que 10.
Get-Random -Count 3 -Maximum 10
9
0
8
Exemplo 13: usar o parâmetro InputObject com uma cadeia de caracteres vazia ou $null
Neste exemplo, o parâmetro InputObject especifica uma matriz que contém uma cadeia de caracteres vazia (''
) e $null
.
Get-Random -InputObject @('a','',$null)
Get-Random
retornará a
, cadeia de caracteres vazia ou $null
. A picada vazia é exibida como uma linha em branco e $null
retorna a um prompt do PowerShell.
Parâmetros
-Count
Especifica o número de objetos ou números aleatórios a serem retornados. O padrão é 1.
Quando usado com InputObject
, se o valor de Count exceder o número de objetos na coleção, Get-Random
retornará todos os objetos em ordem aleatória.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Especifica uma coleção de objetos. Get-Random
obtém objetos selecionados aleatoriamente em ordem aleatória da coleção até o número especificado por Count. Insira os objetos, uma variável que contenha os objetos ou um comando ou expressão que os obtenha. Você também pode canalizar uma coleção de objetos para Get-Random
.
A partir do PowerShell 7, o parâmetro InputObject aceita matrizes que podem conter uma cadeia de caracteres vazia ou $null
. A matriz pode ser enviada pelo pipeline ou como um valor de parâmetro InputObject .
Type: | Object[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Maximum
Especifica um valor máximo para o número aleatório. Get-Random
retorna um valor menor que o máximo (não igual). Insira um inteiro, um número de ponto flutuante de precisão dupla ou um objeto que pode ser convertido em um inteiro ou duplo, como uma cadeia de caracteres numérica ("100").
O valor de Maximum deve ser maior que (diferente de) o valor de Minimum. Se o valor de Máximo ou Mínimo for um número de ponto flutuante, Get-Random
retornará um número de ponto flutuante selecionado aleatoriamente.
Em um computador de 64 bits, se o valor de Mínimo for um inteiro de 32 bits, o valor padrão de Maximum será Int32.MaxValue.
Se o valor de Mínimo for um duplo (um número de ponto flutuante), o valor padrão de Maximum será Double.MaxValue. Caso contrário, o valor padrão é Int32.MaxValue.
Type: | Object |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Minimum
Especifica um valor mínimo para o número aleatório. Insira um inteiro, um número de ponto flutuante de precisão dupla ou um objeto que pode ser convertido em um inteiro ou duplo, como uma cadeia de caracteres numérica ("100"). O valor padrão é 0 (zero).
O valor de Minimum deve ser menor que (diferente de) o valor de Maximum. Se o valor de Máximo ou Mínimo for um número de ponto flutuante, Get-Random
retornará um número de ponto flutuante selecionado aleatoriamente.
Type: | Object |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SetSeed
Especifica um valor de semente para o número aleatório. Quando você usa SetSeed, o cmdlet usa o método System.Random para gerar números pseudorandom, o que não é criptograficamente seguro.
Cuidado
Definir a semente resulta em um comportamento não aleatório. Ele só deve ser usado ao tentar reproduzir o comportamento, como ao depurar ou analisar um script que inclui Get-Random
comandos.
Esse valor de semente é usado para o comando atual e para todos os comandos subsequentes Get-Random
na sessão atual até que você use SetSeed novamente ou feche a sessão. Você não pode redefinir a semente para seu valor padrão.
Type: | Nullable<T>[Int32] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Shuffle
Retorna toda a coleção em uma ordem aleatória.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Você pode canalizar um ou mais objetos. Get-Random
seleciona valores aleatoriamente dos objetos canalizados.
Saídas
System.Int32, System.Int64, System.Double
Get-Random
retorna um número inteiro ou de ponto flutuante ou um objeto selecionado aleatoriamente de uma coleção enviada.
Observações
Por padrão, Get-Random
gera aleatoriedade criptograficamente segura usando a classe RandomNumberGenerator .
Get-Random
nem sempre retorna o mesmo tipo de dados que o valor de entrada. A tabela a seguir mostra o tipo de saída para cada um dos tipos de entrada numéricos.
Tipo de entrada | Tipo de saída |
---|---|
SByte | Double |
Byte | Double |
Int16 | Double |
UInt16 | Double |
Int32 | Int32 |
UInt32 | Double |
Int64 | Int64 |
UInt64 | Double |
Double | Double |
Single | Double |
A partir do Windows PowerShell 3.0, Get-Random
dá suporte a inteiros de 64 bits. No Windows PowerShell 2.0, todos os valores são convertidos em System.Int32.
A partir do PowerShell 7, o parâmetro InputObject no conjunto de parâmetros RandomListItemParameterSet aceita matrizes que contêm uma cadeia de caracteres vazia ou $null
. Em versões anteriores do PowerShell, somente o parâmetro Maximum no conjunto de parâmetros RandomNumberParameterSet aceitava uma cadeia de caracteres vazia ou $null
.