New-Guid
Crée un GUID.
Syntaxe
Default (Par défaut)
New-Guid
[<CommonParameters>]
Empty
New-Guid
[-Empty]
[<CommonParameters>]
InputObject
New-Guid
[-InputObject <String>]
[<CommonParameters>]
Description
L’applet New-Guid de commande crée un identificateur global unique (GUID) version 7. Les UUID de version 7 contiennent un horodatage de précision en millisecondes et sont triables. Si vous avez besoin d’un ID unique dans un script, vous pouvez créer un GUID, si nécessaire.
Note
Dans PowerShell 7.6 et versions antérieures, New-Guid créez des UUID version 4 (aléatoires). À compter de PowerShell 7.7, la valeur par défaut est passée à la version 7. Si vous avez besoin d’un UUID version 4, utilisez [guid]::NewGuid() directement.
Exemples
Exemple 1 : Créer un GUID
New-Guid
Cette commande crée un GUID. 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
Exemple 5 : Créer des versions UUID spécifiques à l’aide d’API .NET
Cet exemple montre comment créer des versions UUID spécifiques à l’aide de .NET API directement.
[guid]::CreateVersion7()
[guid]::NewGuid()
Guid
----
019588a4-dbe2-7f30-8b9f-4a1c0e5d3a28
d61bbeca-0186-48fa-90e1-ff7aa5d33e2d
Le numéro de version apparaît dans le troisième groupe de la chaîne GUID. Les UUID de la version 7 commencent par une 7 position (7f30), tandis que les UUID de la version 4 affichent un 4 (48fa).
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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Empty
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-InputObject
Ce paramètre accepte une chaîne représentant un GUID et la convertit en objet GUID.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
InputObject
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
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 Empty , l’applet de commande crée un identificateur UUID (Universally Unique Identifier) version 7 tel que défini dans RFC 9562.
Dans PowerShell 7.6 et versions antérieures, l’applet de commande a créé un UUID version 4 (aléatoire). Si vous avez besoin d’un UUID version 4, utilisez [guid]::NewGuid(). Pour créer explicitement un UUID version 7, utilisez [guid]::CreateVersion7().
Pour plus d’informations, consultez System.Guid.CreateVersion7.
