다음을 통해 공유


New-Guid

GUID를 만듭니다.

구문

Default (기본값)

New-Guid
    [<CommonParameters>]

Empty

New-Guid
    [-Empty]
    [<CommonParameters>]

InputObject

New-Guid
    [-InputObject <String>]
    [<CommonParameters>]

Description

New-Guid cmdlet은 GUID(임의 전역 고유 식별자)를 만듭니다. 스크립트에 고유 ID가 필요한 경우 필요에 따라 GUID를 만들 수 있습니다.

예제

예제 1: 새 GUID 만들기

New-Guid

이 명령은 임의의 GUID를 만듭니다. 또는 이 cmdlet의 출력을 변수에 저장하여 스크립트의 다른 곳에서 사용할 수 있습니다.

예제 2: 빈 GUID 만들기

New-Guid -Empty
Guid
----
00000000-0000-0000-0000-000000000000

예제 3: 문자열에서 GUID 만들기

다음은 GUID가 포함된 문자열을 GUID 개체로 변환하는 예제입니다.

New-Guid -InputObject "d61bbeca-0186-48fa-90e1-ff7aa5d33e2d"
Guid
----
d61bbeca-0186-48fa-90e1-ff7aa5d33e2d

예제 4: 파이프라인에서 GUID로 문자열 변환

이 예제에서는 파이프라인에서 GUID 개체로 문자열을 변환합니다.

$guidStrings = (
'11c43ee8-b9d3-4e51-b73f-bd9dda66e29c',
'0f8fad5bd9cb469fa16570867728950e',
'{0x01234567, 0x89ab, 0xcdef,{0x01,0x23,0x45,0x67,0x89,0xab,0xcd,0xef}}'
)
$guidStrings | New-Guid
Guid
----
11c43ee8-b9d3-4e51-b73f-bd9dda66e29c
0f8fad5b-d9cb-469f-a165-70867728950e
01234567-89ab-cdef-0123-456789abcdef

매개 변수

-Empty

이 cmdlet은 빈 GUID를 만듭니다. 빈 GUID의 문자열에는 모두 0이 있습니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Empty
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-InputObject

이 매개 변수는 GUID를 나타내는 문자열을 허용하고 GUID 개체로 변환합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

InputObject
Position:Named
필수:False
파이프라인의 값:True
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

출력

Guid

이 cmdlet은 GUID를 반환합니다.

참고

cmdlet은 문자열 입력을 System.Guid 클래스의 생성자에 전달합니다. 생성자는 여러 형식의 문자열을 지원합니다. 자세한 내용은 System.Guid(String)참조하세요.

문자열 입력 또는 Empty 매개 변수 없이 사용하는 경우 cmdlet은 버전 4 UUID(Universally Unique Identifier)를 만듭니다. 자세한 내용은 System.Guid.NewGuid참조하세요.