Get-Random

  • Başvuru
Modül:
Microsoft.PowerShell.Utility

Rastgele bir sayı alır veya bir koleksiyondan nesneleri rastgele seçer.

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

Get-Random Cmdlet rastgele seçilen bir sayı alır. öğesine bir nesne Get-Randomkoleksiyonu gönderirseniz, koleksiyondan rastgele seçilen bir veya daha fazla nesne alır.

Parametreler veya giriş olmadan, komut Get-Random 0 (sıfır) ile [int32]::MaxValuearasında rastgele seçilen 32 bit işaretsiz bir tamsayı döndürür.

en düşük ve en yüksek değerleri, bir koleksiyondan döndürülen nesne sayısını veya bir tohum sayısını belirtmek için parametresini Get-Random kullanabilirsiniz.

Dikkat

Get-Random şifreleme açısından rastgeleliğin güvenliğini sağlamaz. Seed değeri, siz SetSeed'i yeniden kullanana veya oturumu kapatana kadar geçerli komut ve geçerli oturumdaki sonraki Get-Random tüm komutlar için kullanılır. Tohumu varsayılan değerine sıfırlayamazsınız.

Tohumu kasıtlı olarak ayarlamak rastgele olmayan, tekrarlanabilir davranışla sonuçlanıyor. Yalnızca komutları içeren Get-Random bir betikte hata ayıklama veya analiz etme gibi davranışları yeniden oluşturmaya çalışırken kullanılmalıdır. Tohum değerinin içeri aktarılan modül gibi aynı oturumdaki diğer kodlar tarafından ayarlanabileceğini unutmayın.

PowerShell 7.4, şifreleme açısından rastgele güvenliği sağlayan Get-SecureRandom'ı içerir.

Örnekler

Örnek 1: Rastgele tamsayı alma

Bu komut 0 (sıfır) ile Int32.MaxValue arasında rastgele bir tamsayı alır.

Get-Random

3951433

Örnek 2: 0 ile 99 arasında rastgele bir tamsayı alma

Get-Random -Maximum 100

47

Örnek 3: -100 ile 99 arasında rastgele bir tamsayı alma

Get-Random -Minimum -100 -Maximum 100

56

Örnek 4: Rastgele kayan noktalı sayı alma

Bu komut, 10,7'den büyük veya buna eşit ve 20,93'ten küçük rastgele bir kayan nokta sayısı alır.

Get-Random -Minimum 10.7 -Maximum 20.93

18.08467273887

Örnek 5: Diziden rastgele bir tamsayı alma

Bu komut, belirtilen diziden rastgele seçilen bir sayı alır.

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

8

Örnek 6: Bir diziden birkaç rastgele tamsayı alma

Bu komut, bir diziden rastgele seçilen üç sayıyı alır.

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

3
1
13

Örnek 7: Koleksiyonun tamamını rastgele rastgele belirleme

PowerShell 7.1'den başlayarak, tüm koleksiyonu rastgele bir sırada döndürmek için Karıştırma parametresini kullanabilirsiniz.

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

2
3
5
1
8
13

Örnek 8: Rastgele sayısal olmayan bir değer alma

Bu komut, sayısal olmayan bir koleksiyondan rastgele bir değer döndürür.

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

yellow

Örnek 9: SetSeed parametresini kullanma

Bu örnekte SetSeed parametresini kullanmanın etkisi gösterilmektedir.

SetSeed rastgele olmayan davranışlar ürettiği için, genellikle yalnızca bir betiğin hata ayıklaması veya analiz edilmesi gibi sonuçları yeniden oluşturmak için kullanılır.

# 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

32
25
93
95

# 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

32
25
93
95

Örnek 10: Rastgele dosyaları alma

Bu komutlar, yerel bilgisayarın sürücüsünden C: rastgele seçilen 50 dosya örneğini alır.

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

Örnek 11: Adil zar atma

Bu örnek, 1200 kez bir fair die döndürür ve sonuçları sayar. İlk komut, ForEach-Object kanallı numaralardan (1-6) çağrısı Get-Random yineler. Sonuçlar ile Group-Object değerlerine göre gruplandırılır ve ile Select-Objecttablo olarak biçimlendirilir.

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

Örnek 12: Count parametresini kullanma

Artık count parametresini nesneleri ile Get-Randombağlantı oluşturmadan kullanabilirsiniz. Aşağıdaki örnek 10'dan küçük üç rastgele sayı alır.

Get-Random -Count 3 -Maximum 10

9
0
8

Örnek 13: InputObject parametresini boş bir dize veya $null ile kullanma

Bu örnekte, InputObject parametresi boş dize ('') ve $nulliçeren bir dizi belirtir.

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

Get-Randoma, boş dize veya $nulldöndürür. Boş sokma boş bir satır olarak görüntülenir ve $null bir PowerShell istemine döner.

Parametreler

-Count

Döndürülecek rastgele nesne sayısını belirtir. Varsayılan değer 1'dir.

Bir koleksiyon içeren ile InputObject kullanıldığında:

  • Rastgele seçilen her öğe yalnızca bir kez döndürülür.
  • Count değeri koleksiyondaki nesne sayısını aşarsa, koleksiyondaki tüm nesneler rastgele sırayla döndürülür.
Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Nesne koleksiyonunu belirtir. Get-Randomkoleksiyondan Count tarafından belirtilen sayıya kadar rastgele seçilen nesneleri rastgele sırada alır. Nesneleri, nesneleri içeren bir değişkeni veya nesneleri alan bir komut veya ifade girin. Ayrıca, bir nesne koleksiyonunu öğesine de yöneltebilirsiniz Get-Random.

PowerShell 7'de başlayarak, InputObject parametresi boş bir dize veya $nulliçerebilen dizileri kabul eder. Dizi, işlem hattına veya InputObject parametre değeri olarak gönderilebilir.

Type:Object[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Maximum

Rastgele sayı için en yüksek değeri belirtir. Get-Random en büyük değerden (eşit olmayan) küçük bir değer döndürür. Bir tamsayı, çift duyarlıklı kayan noktalı sayı veya sayısal dize ("100") gibi bir tamsayıya veya çifte dönüştürülebilen bir nesne girin.

Maksimum değeri, Minimum değerinden büyük (eşit değildir) olmalıdır. Maksimum veya Minimum değeri kayan noktalı bir sayıysa, Get-Random rastgele seçilen kayan noktalı bir sayı döndürür.

64 bit bir bilgisayarda, Minimum değeri 32 bitlik bir tamsayıysa, Varsayılan Maksimum değeri Int32.MaxValue'dır.

Minimum değeri bir çift (kayan noktalı sayı) ise, Varsayılan Maksimum değeri Double.MaxValue'dır. Aksi takdirde, varsayılan değer Int32.MaxValue'dir.

Type:Object
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Minimum

Rastgele sayı için en düşük değeri belirtir. Bir tamsayı, çift duyarlıklı kayan noktalı sayı veya sayısal dize ("100") gibi bir tamsayıya veya çifte dönüştürülebilen bir nesne girin. Varsayılan değer 0 (sıfır)'dır.

Minimum değeri, En Büyük değerinden küçük (eşit değildir) olmalıdır. Maksimum veya Minimum değeri kayan noktalı bir sayıysa, Get-Random rastgele seçilen kayan noktalı bir sayı döndürür.

Type:Object
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SetSeed

Rastgele sayı oluşturucu için bir tohum değeri belirtir. SetSeed kullandığınızda, cmdlet şifreleme açısından güvenli olmayan sahte sayılar oluşturur.

Dikkat

Tohumu ayarlamak rastgele olmayan davranışlarla sonuçlanıyor. Yalnızca komutları içeren Get-Random bir betikte hata ayıklama veya analiz etme gibi davranışları yeniden oluşturmaya çalışırken kullanılmalıdır.

Bu tohum değeri, siz SetSeed'i yeniden kullanana veya oturumu kapatana kadar geçerli komut ve geçerli oturumdaki sonraki Get-Random tüm komutlar için kullanılır. Tohumu varsayılan değerine sıfırlayamazsınız.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Shuffle

Koleksiyonun tamamını rastgele bir sırada döndürür.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Girişler

Object

Herhangi bir nesneyi bu cmdlet'e yöneltebilirsiniz. Kanallı nesnelerden değerleri rastgele seçer.

Çıkışlar

Int32

Int64

Double

PSObject

Bu cmdlet, gönderilen bir koleksiyondan rastgele seçilen bir tamsayı veya kayan noktalı sayı ya da nesne döndürür.

Notlar

Get-Random her zaman giriş değeriyle aynı veri türünü döndürmez. Aşağıdaki tabloda, sayısal giriş türlerinin her biri için çıkış türü gösterilmektedir.

Giriş Türü Çıkış Türü
SByte Çift
Bayt Çift
Int16 Çift
UInt16 Çift
Int32 Int32
UInt32 Çift
Int64 Int64
UInt64 Çift
Çift Çift
Tekli Çift

Windows PowerShell 3.0'da Get-Random başlayarak 64 bit tamsayıları destekler. Windows PowerShell 2.0'da tüm değerler System.Int32'ye aktarılır.

PowerShell 7'de başlayarak, RandomListItemParameterSet parametre kümesindeki InputObject parametresi boş dize veya $nulliçeren dizileri kabul eder. Önceki PowerShell sürümlerinde, yalnızca RandomNumberParameterSet parametre kümesindeki Maximum parametresi boş bir dize veya $nullkabul etti.