다음을 통해 공유


Get-SecureRandom

난수를 가져오거나 컬렉션에서 임의로 개체를 선택합니다.

구문

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

Description

cmdlet은 Get-SecureRandom 임의로 선택된 숫자를 가져옵니다. 개체 Get-SecureRandom컬렉션을 제출하는 경우 컬렉션에서 하나 이상의 임의로 선택된 개체를 가져옵니다.

매개 변수나 입력 Get-SecureRandom 이 없으면 명령은 0에서 0 사이의 임의로 선택된 32비트 부호 없는 정수를 반환합니다 [int32]::MaxValue.

매개 변수 Get-SecureRandom 를 사용하여 컬렉션에서 반환된 개체의 수와 최소값 및 최대값을 지정할 수 있습니다.

Get-SecureRandom는 RandomNumberGenerator 클래스를 사용하여 암호화된 보안 임의성을 생성합니다.

예제

예제 1: 임의 정수 가져오기

이 명령은 0 과 Int32.MaxValue 사이의 임의 정수를 가져옵니다.

Get-SecureRandom

3951433

예제 2: 0에서 99 사이의 임의 정수 가져오기

Get-SecureRandom -Maximum 100

47

예제 3: -100에서 99 사이의 임의 정수 가져오기

Get-SecureRandom -Minimum -100 -Maximum 100

56

예제 4: 임의 부동 소수점 숫자 가져오기

이 명령은 10.7보다 크거나 같고 20.93보다 작은 임의 부동 소수점 숫자를 가져옵니다.

Get-SecureRandom -Minimum 10.7 -Maximum 20.93

18.08467273887

예제 5: 배열에서 임의 정수 가져오기

이 명령은 지정된 배열에서 임의로 선택된 숫자를 가져옵니다.

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

8

예제 6: 배열에서 여러 임의 정수 가져오기

이 명령은 배열에서 임의로 선택된 세 개의 숫자를 임의 순서로 가져옵니다.

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

3
1
13

예제 7: 전체 컬렉션 임의화

Shuffle 매개 변수를 사용하여 전체 컬렉션을 임의 순서로 반환할 수 있습니다.

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

2
3
5
1
8
13

예제 8: 숫자가 아닌 임의의 값 가져오기

이 명령은 숫자가 아닌 컬렉션에서 임의의 값을 반환합니다.

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

yellow

예제 9: 임의 파일 가져오기

이러한 명령은 로컬 컴퓨터의 드라이브에서 C: 임의로 선택된 50개의 파일 샘플을 가져옵니다.

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

예제 10: 공정한 주사위 출시

이 예제에서는 fair die를 1200번 롤아웃하고 결과를 계산합니다. 첫 번째 명령은 ForEach-Object 파이프된 번호(1-6)에서 호출 Get-SecureRandom 을 반복합니다. 결과는 값을 Group-Object 기준으로 그룹화되고 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

예제 11: Count 매개 변수 사용

개체Get-SecureRandom파이핑하지 않고 Count 매개 변수를 사용할 수 있습니다. 다음 예제에서는 10보다 작은 세 개의 난수를 가져옵니다.

Get-SecureRandom -Count 3 -Maximum 10

9
0
8

예제 12: 빈 문자열 또는 $null 함께 InputObject 매개 변수 사용

이 예제 에서 InputObject 매개 변수는 빈 문자열('')과 $null.

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

Get-SecureRandoma은 ,빈 문자열 또는 $null.를 반환합니다. 빈 따끔거림이 빈 줄로 표시되고 $null PowerShell 프롬프트로 돌아갑니다.

매개 변수

-Count

반환할 임의의 개체 수를 지정합니다. 기본값은 1입니다.

컬렉션을 포함하는 데 사용하는 InputObject 경우:

  • 임의로 선택한 각 항목은 한 번만 반환됩니다.
  • Count 값이 컬렉션의 개체 수를 초과하면 컬렉션의 모든 개체가 임의 순서로 반환됩니다.
형식:Int32
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InputObject

개체 컬렉션을 지정합니다. Get-SecureRandom는 임의로 선택한 개체를 컬렉션에서 Count로 지정된 숫자까지 임의 순서로 가져옵니다. 개체, 개체가 포함된 변수, 개체를 가져오는 명령 또는 식을 입력하세요. 개체 컬렉션을 으로 파이프할 Get-SecureRandom수도 있습니다.

InputObject 매개 변수는 빈 문자열 또는 $null. 배열을 파이프라인 아래로 보내거나 InputObject 매개 변수 값으로 보낼 수 있습니다.

형식:Object[]
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Maximum

난수의 최대값을 지정합니다. Get-SecureRandom 는 최대값(같지 않음)보다 작은 값을 반환합니다. 정수, 배정밀도 부동 소수점 숫자 또는 숫자 문자열("100")과 같이 정수 또는 double으로 변환할 수 있는 개체를 입력합니다.

최대값은 최소보다 커야 합니다(같지 않음). 최대값 또는 최소값이 부동 소수점 숫자 Get-SecureRandom 인 경우 임의로 선택한 부동 소수점 숫자를 반환합니다.

64비트 컴퓨터에서 최소값이 32비트 정수이면 기본값인 최대은 Int32.MaxValue입니다.

최소값이 double(부동 소수점 숫자)인 경우 최대값의 기본값은 Double.MaxValue입니다. 그렇지 않으면 기본값은 Int32.MaxValue입니다.

형식:Object
Position:0
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Minimum

난수의 최소값을 지정합니다. 정수, 배정밀도 부동 소수점 숫자 또는 숫자 문자열("100")과 같이 정수 또는 double으로 변환할 수 있는 개체를 입력합니다. 기본값은 0입니다.

최소값은 최대보다 작아야 합니다(같지 않음). 최대값 또는 최소값이 부동 소수점 숫자 Get-SecureRandom 인 경우 임의로 선택한 부동 소수점 숫자를 반환합니다.

형식:Object
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Shuffle

전체 컬렉션을 임의 순서로 반환합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

Object

모든 개체를 이 cmdlet으로 파이프할 수 있습니다. 파이프된 개체에서 임의로 값을 선택합니다.

출력

Int32

Int64

Double

PSObject

이 cmdlet은 정수 또는 부동 소수점 숫자 또는 제출된 컬렉션에서 임의로 선택된 개체를 반환합니다.

참고

Get-SecureRandom 는 항상 입력 값과 동일한 데이터 형식을 반환하지는 않습니다. 다음 표에서는 각 숫자 입력 형식에 대한 출력 형식을 보여줍니다.

입력 유형 출력 유형
SByte 두 배
Byte 두 배
Int16 두 배
UInt16 두 배
Int32 Int32
UInt32 두 배
Int64 Int64
UInt64 두 배
두 배 두 배
단일 두 배