New-Guid
Erstellt eine GUID.
Syntax
Default (Standardwert)
New-Guid
[<CommonParameters>]
Empty
New-Guid
[-Empty]
[<CommonParameters>]
InputObject
New-Guid
[-InputObject <String>]
[<CommonParameters>]
Beschreibung
Das Cmdlet New-Guid 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.
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 das Cmdlet ohne Zeichenfolgeneingabe oder den parameter Empty verwendet wird, erstellt das Cmdlet eine Version 4 Universally Unique Identifier (UUID). Weitere Informationen finden Sie unter System.Guid.NewGuid.
