Delen via

New-Guid

Module:
Microsoft.PowerShell.Utility Module

Hiermee maakt u een GUID.

Syntaxis

Default (Standaard) 

New-Guid
    [<CommonParameters>]

Empty 

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

InputObject 

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

Description

Met de cmdlet New-Guid wordt een willekeurige GUID (Globally Unique Identifier) gemaakt. Als u een unieke id in een script nodig hebt, kunt u indien nodig een GUID maken.

Voorbeelden

Voorbeeld 1: Een nieuwe GUID maken

New-Guid

Met deze opdracht maakt u een willekeurige 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

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.

Wanneer de cmdlet wordt gebruikt zonder tekenreeksinvoer of de lege parameter , maakt de cmdlet een UUID (Universally Unique Identifier) van versie 4. Zie System.Guid.NewGuidvoor meer informatie.