New-Guid

Hiermee maakt u een GUID.

Syntax

Default (Standaard)

New-Guid
    [<CommonParameters>]

Empty

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

InputObject

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

Description

De New-Guid cmdlet maakt een GUID (Globally Unique Identifier) van versie 7. Versie 7 UUID's bevatten een tijdstempel van milliseconden en kunnen worden gesorteerd. Als u een unieke id in een script nodig hebt, kunt u indien nodig een GUID maken.

Opmerking

In PowerShell 7.6 en eerder hebt New-Guid u versie 4 (willekeurige) UUID's gemaakt. Vanaf PowerShell 7.7 is de standaardinstelling gewijzigd in versie 7. Als u een UUID van versie 4 nodig hebt, gebruikt [guid]::NewGuid() u deze rechtstreeks.

Voorbeelden

Voorbeeld 1: Een nieuwe GUID maken

New-Guid

Met deze opdracht maakt u een GUID. U kunt ook de uitvoer van deze cmdlet opslaan in een variabele voor gebruik elders in een script.

Voorbeeld 2: Een lege GUID maken

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

Voorbeeld 3: Een GUID maken op basis van een tekenreeks

In dit voorbeeld wordt een tekenreeks met een GUID geconverteerd naar een GUID-object.

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

Voorbeeld 4: tekenreeksen van de pijplijn converteren naar GUID's

In deze voorbeelden worden tekenreeksen van de pijplijn geconverteerd naar GUID-objecten.

$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

Voorbeeld 5: Specifieke UUID-versies maken met behulp van .NET API's

In dit voorbeeld ziet u hoe u specifieke UUID-versies maakt met behulp van .NET API's rechtstreeks.

[guid]::CreateVersion7()
[guid]::NewGuid()
Guid
----
019588a4-dbe2-7f30-8b9f-4a1c0e5d3a28
d61bbeca-0186-48fa-90e1-ff7aa5d33e2d

Het versienummer wordt weergegeven in de derde groep van de GUID-tekenreeks. Versie 7 UUID's beginnen met een 7 in die positie (7f30), terwijl versie 4 UUID's een 4 (48fa) weergeven.

Parameters

-Empty

Geeft aan dat deze cmdlet een lege GUID maakt. Een lege GUID bevat alle nullen in de tekenreeks.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Empty
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-InputObject

Deze parameter accepteert een tekenreeks die een GUID vertegenwoordigt en converteert deze naar een GUID-object.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

InputObject
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Uitvoerwaarden

Guid

Deze cmdlet retourneert een GUID.

Notities

De cmdlet geeft tekenreeksinvoer door aan de constructor van de klasse System.Guid . De constructor ondersteunt tekenreeksen in verschillende indelingen. Zie System.Guid(String) voor meer informatie.

Bij gebruik zonder tekenreeksinvoer of de parameter Empty maakt de cmdlet een UUID (Universally Unique Identifier) van versie 7, zoals gedefinieerd in RFC 9562.

In PowerShell 7.6 en eerder heeft de cmdlet een UUID van versie 4 (random) gemaakt. Als u een UUID van versie 4 nodig hebt, gebruikt u [guid]::NewGuid(). Als u expliciet een UUID van versie 7 wilt maken, gebruikt u [guid]::CreateVersion7().

Zie System.Guid.CreateVersion7 voor meer informatie.