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.