Section courante

A propos

Section administrative du site

setvar

Fixe la variable
UEFI Shell

Syntaxe

setvar variable-name [-guid guid][-bs][-rt][-nv] [=data [=data...]]

Paramètres

Nom Description
variable-name Ce paramètre permet d'indiquer le nom de la variable UEFI à afficher, créer, supprimer ou modifier.
-guid Ce paramètre permet d'indiquer le GUID de la variable UEFI à afficher, créer, supprimer ou modifier. S'il n'est pas présent, le EFI_GLOBAL_VARIABLE du GUID est défini par défaut, comme défini dans la spécification UEFI.
-bs Ce paramètre permet d'indiquer que la variable est une variable de service de démarrage (BS). Ce paramètre est valable uniquement pour les nouvelles variables, sinon il est ignoré.
-rt Ce paramètre permet d'indiquer que la variable est une variable d'exécution (RT). Ce paramètre est valable uniquement pour les nouvelles variables, sinon il est ignoré.
-nv Ce paramètre permet d'indiquer que la variable est non volatile (NV). S'il n'est pas présent, la variable est supposée être volatile. Ce paramètre est valable uniquement pour les nouvelles variables, sinon il est ignoré.
=data Ce paramètre permet d'indiquer les données. Si «=» n'est pas présent, la valeur actuelle de la variable est affichée sous forme d'octets hexadécimaux. S'il n'y a rien après le «=», la variable est supprimée. Plus d'un paramètre «=data» peut être fourni et les données de chaque paramètres sont concaténées. Voici les valeurs possibles. Sauf indication contraire, les délimiteurs «=» sont sensibles à la casse (Exemple : =L n'est pas =l) :
Format Description
=0xhexnumber ou =0Xhexnumber Ce format permet d'indiquer un nombre hexadécimal. Par exemple =0x1234567890abcdef entreposera ce nombre hexadécimal dans la variable UEFI. Les caractères hexadécimaux sont insensibles à la casse.
=Hhexbytearray ou =hexbytearrayxx[xx] Ce format permet d'indiquer un tableau d'octets hexadécimaux, où l'octet le plus à gauche est l'octet 0 et celui à droite, l'octet n. Par exemple, =H12345678 signifie que l'octet 0 est 0x12, l'octet 1 est 0x34, l'octet 2 est 0x56 et l'octet 3 est 0x78 lorsqu'il est entreposé dans la variable UEFI. Doit fournir deux chiffres hexadécimaux pour chaque octet. Par exemple =H01 n'est pas =H1. Les caractères hexadécimaux sont insensibles à la casse.
=S"ascii-string" ou ="ascii-string" Ce format permet d'indiquer une chaîne de caractères ASCII sans terminaison NULL par défaut. Ajoutez =0x00 sur la ligne de commande pour fournir une terminaison nulle. Par exemple, =S"ceci est un test" aura pour résultat que «ceci est un test» (à l'exclusion des guillemets doubles) étant entreposé dans la variable UEFI sans terminaison NULL. Pour entreposer la même chaîne de caractères avec une terminaison NULL, indiquez =S"ceci est un test" =0x00. Si ="chaîne-ASCII" ne contient que des caractères hexadécimaux (0 à 9, a à f, A à F), il sera traité comme un tableau d'octets hexadécimaux.
=L"UCS2-string" Ce format permet d'indiquer une chaîne de caractères codée UCS-2 sans terminaison nulle par défaut. Ajoutez =0x0000 sur la ligne de commande pour fournir une terminaison nulle. Par exemple, =L"ceci est un test" aura pour résultat que «ceci est un test» (à l'exclusion des guillemets doubles) étant entreposé dans la variable UEFI sans terminaison NULL. Pour entreposer la même chaîne de caractères avec un terminateur nul, indiquez =L"ceci est un test" =0x0000.
=P"devicepath" ou =--devicepath Ce format permet d'indiquer un format de texte du chemin de périphérique. EFI_DEVICE_PATH_FROM_TEXT_PROTOCOL est utilisé pour convertir du texte en représentation binaire du chemin d'accès au périphérique. Par exemple, =P"PciRoot(0)/Pci(31,2)/USB(0,0)" aura pour résultat que le tableau d'octets 02010C00D041030A0000... sera entreposé dans la variable UEFI. Si le texte du chemin d'accès au périphérique ne correspond pas à la casse exacte dans la spécification UEFI (Exemple : "pci" au lieu de "Pci"), le comportement n'est pas défini.

Description

Cette commande permet de changer la valeur de la variable UEFI.



Dernière mise à jour : Lundi, le 22 juillet 2019