New-Guid

Référence

Module:: Microsoft.PowerShell.Utility

Crée un GUID.

Syntaxe

New-Guid []

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

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

Description

L’applet de commande New-Guid crée un identificateur global unique aléatoire (GUID). Si vous avez besoin d’un ID unique dans un script, vous pouvez créer un GUID, si nécessaire.

Exemples

Exemple 1 : Créer un GUID

New-Guid

Cette commande crée un GUID aléatoire. Vous pouvez également stocker la sortie de cette applet de commande dans une variable à utiliser ailleurs dans un script.

Exemple 2 : Créer un GUID vide

New-Guid -Empty

Guid
----
00000000-0000-0000-0000-000000000000

Exemple 3 : Créer un GUID à partir d’une chaîne

Cet exemple convertit une chaîne qui contient un GUID en objet GUID.

New-Guid -InputObject "d61bbeca-0186-48fa-90e1-ff7aa5d33e2d"

Guid
----
d61bbeca-0186-48fa-90e1-ff7aa5d33e2d

Exemple 4 : Convertir des chaînes du pipeline en GUID

Cet exemple convertit les chaînes du pipeline en objets GUID.

$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

Paramètres

-Empty

Indique que cette applet de commande crée un GUID vide. Un GUID vide comporte tous les zéros dans sa chaîne.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-InputObject

Ce paramètre accepte une chaîne représentant un GUID et la convertit en objet GUID.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

Sorties

Guid

Cette applet de commande retourne un GUID.

Notes

L’applet de commande transmet l’entrée de chaîne au constructeur de la classe System.Guid. Le constructeur prend en charge les chaînes dans plusieurs formats. Pour plus d’informations, consultez System.Guid(String).

Lorsqu’elle est utilisée sans entrée de chaîne ou le paramètre Vide, l’applet de commande crée un identificateur UUID (Universally Unique Identifier) version 4. Pour plus d’informations, consultez System.Guid.NewGuid.

Partager via