Edit

New-Guid

  • Reference
Module:
Microsoft.PowerShell.Utility

Creates a GUID.

Syntax

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

Description

The New-Guid cmdlet creates a random globally unique identifier (GUID). If you need a unique ID in a script, you can create a GUID, as needed.

Examples

Example 1: Create a new GUID

New-Guid

This command creates a random GUID. Alternatively, you could store the output of this cmdlet in a variable to use elsewhere in a script.

Example 2: Create an empty GUID

New-Guid -Empty

Guid
----
00000000-0000-0000-0000-000000000000

Example 3: Create a GUID from a string

This example converts a string that contains a GUID to a GUID object.

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

Guid
----
d61bbeca-0186-48fa-90e1-ff7aa5d33e2d

Example 4: Convert strings from the pipeline to GUIDs

This examples converts strings from the pipeline to GUID objects.

$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

Parameters

-Empty

Indicates that this cmdlet creates an empty GUID. An empty GUID has all zeros in its string.

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

-InputObject

This parameter accepts a string representing a GUID and converts it to a GUID object.

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

Outputs

Guid

This cmdlet returns a GUID.

Notes

The cmdlet passes string input to the constructor of the System.Guid class. The constructor support strings in several formats. For more information, see System.Guid(String).