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 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 nouveau 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.
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 une entrée de chaîne au constructeur de la classe System.Guid. Le constructeur prend en charge des chaînes dans plusieurs formats. Pour plus d’informations, consultez System.Guid(String).
Lorsqu'on utilise l'applet de commande sans entrée de chaîne ou sans le paramètre Vide, elle crée un identifiant unique universel (UUID) version 4. Pour plus d’informations, consultez System.Guid.NewGuid.
