New-Guid

Referenz

Modul:: Microsoft.PowerShell.Utility

Erstellt eine GUID.

Syntax

New-Guid []

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

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

Beschreibung

Das New-Guid Cmdlet erstellt einen zufälligen global eindeutigen Bezeichner (GUID). Wenn Sie eine eindeutige ID in einem Skript benötigen, können Sie bei Bedarf eine GUID erstellen.

Beispiele

Beispiel 1: Erstellen einer neuen GUID

New-Guid

Mit diesem Befehl wird eine zufällige 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

Parameter

-Empty

Gibt an, dass dieses Cmdlet eine leere GUID erstellt. Eine leere GUID weist alle Nullen in der Zeichenfolge auf.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-InputObject

Dieser Parameter akzeptiert eine Zeichenfolge, die eine GUID darstellt, und konvertiert sie in ein GUID-Objekt.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

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 das Cmdlet ohne Zeichenfolgeneingabe oder den Parameter Empty verwendet wird, wird vom Cmdlet eine Version 4 Universally Unique Identifier (UUID) erstellt. Weitere Informationen finden Sie unter System.Guid.NewGuid.

Freigeben über