New-Guid
Erstellt eine GUID.
Syntax
Default (Standard)
New-Guid
[<CommonParameters>]
Empty
New-Guid
[-Empty]
[<CommonParameters>]
InputObject
New-Guid
[-InputObject <String>]
[<CommonParameters>]
Beschreibung
Mit dem New-Guid Cmdlet wird eine GUID (Globally Unique Identifier) der Version 7 erstellt. UUIDs der Version 7 enthalten einen Millisekunden-Zeitstempel und können sortiert werden. Wenn Sie eine eindeutige ID in einem Skript benötigen, können Sie bei Bedarf eine GUID erstellen.
Note
In PowerShell 7.6 und früher erstellte New-Guid Version 4 (zufällige) UUIDs. Ab PowerShell 7.7 wurde die Standardeinstellung in Version 7 geändert. Wenn Sie eine Version 4 UUID benötigen, verwenden Sie [guid]::NewGuid() diese direkt.
Beispiele
Beispiel 1: Erstellen einer neuen GUID
New-Guid
Mit diesem Befehl wird eine GUID erstellt. Alternativ können Sie die Ausgabe dieses Cmdlets in einer Variablen speichern, die an anderer Stelle in einem Skript verwendet werden soll.
Beispiel 2: Erstellen einer leeren GUID
New-Guid -Empty
Guid
----
00000000-0000-0000-0000-000000000000
Beispiel 3: Erstellen einer GUID aus einer Zeichenfolge
In diesem Beispiel wird eine Zeichenfolge konvertiert, die eine GUID enthält, in ein GUID-Objekt.
New-Guid -InputObject "d61bbeca-0186-48fa-90e1-ff7aa5d33e2d"
Guid
----
d61bbeca-0186-48fa-90e1-ff7aa5d33e2d
Beispiel 4: Konvertieren von Zeichenfolgen aus der Pipeline in GUIDs
In diesem Beispiel werden Zeichenfolgen aus der Pipeline in GUID-Objekte konvertiert.
$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
Beispiel 5: Erstellen BESTIMMTER UUID-Versionen mithilfe von .NET APIs
In diesem Beispiel wird gezeigt, wie Sie bestimmte UUID-Versionen mithilfe von .NET APIs direkt erstellen.
[guid]::CreateVersion7()
[guid]::NewGuid()
Guid
----
019588a4-dbe2-7f30-8b9f-4a1c0e5d3a28
d61bbeca-0186-48fa-90e1-ff7aa5d33e2d
Die Versionsnummer wird in der dritten Gruppe der GUID-Zeichenfolge angezeigt. Version 7-UUIDs beginnen mit einer 7 in dieser Position (7f30), während Version 4 UUIDs eine 4 (48fa) anzeigen.
Parameter
-Empty
Gibt an, dass dieses Cmdlet eine leere GUID erstellt. Eine leere GUID weist alle Nullen in der Zeichenfolge auf.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Empty
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-InputObject
Dieser Parameter akzeptiert eine Zeichenfolge, die eine GUID darstellt, und konvertiert sie in ein GUID-Objekt.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
InputObject
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Ausgaben
Guid
Dieses Cmdlet gibt eine GUID zurück.
Hinweise
Das Cmdlet übergibt Zeichenfolgeneingaben an den Konstruktor der System.Guid-Klasse . Der Konstruktor unterstützt Zeichenfolgen in mehreren Formaten. Weitere Informationen finden Sie unter "System.Guid(String)".
Wenn es ohne Zeichenfolgeneingabe oder den Parameter Empty verwendet wird, erstellt das Cmdlet eine Version 7 Universally Unique Identifier (UUID), wie in RFC 9562 definiert.
In PowerShell 7.6 und früheren Versionen hat das Cmdlet eine Version 4 (zufällig) UUID erstellt. Wenn Sie eine Version 4 UUID benötigen, verwenden Sie [guid]::NewGuid(). Verwenden Sie [guid]::CreateVersion7()zum expliziten Erstellen einer Version 7 UUID .
Weitere Informationen finden Sie unter System.Guid.CreateVersion7.
