Guía de usuario de HPE UEFI Shell para servidores HPE ProLiant

Transcripción

Guía de usuario de HPE UEFI Shell para servidores HPE ProLiant
Guía de usuario de HPE UEFI Shell
para servidores HPE ProLiant Gen9
Resumen
Este documento detalla cómo acceder al shell de Unified Extensible Firmware Interface (Interfaz de firmware extensible
unificada, UEFI) integrado en la ROM del sistema de todos los servidores ProLiant Gen9 basados en UEFI y utilizarlo. Este
documento está dirigido a la persona encargada de la instalación, administración y solución de problemas de los servidores y
sistemas de almacenamiento.
Nº de referencia: 794198-075
Publicado: Abril de 2016
Edición: 1
© Copyright 2014, 2016 Hewlett Packard Enterprise Development LP
La información que incluye este documento está sujeta a cambios sin previo aviso. Las únicas garantías de los productos y servicios de
Hewlett Packard Enterprise están establecidas en las declaraciones expresas de garantía que acompañan a dichos productos y servicios. No
se podrá interpretar nada de lo aquí incluido como parte de una garantía adicional. Hewlett Packard Enterprise no se hace responsable de los
errores u omisiones de carácter técnico o editorial que puedan figurar en este documento.
Software confidencial. Para la posesión, uso o copia de su software es necesaria una licencia válida de Hewlett Packard Enterprise. Cumpliendo
con la normativa FAR 12.211 y 12.212, la licencia del software informático comercial, la documentación del software informático y los datos
técnicos sobre elementos comerciales se han concedido al gobierno de EE. UU. bajo la licencia comercial estándar del proveedor.
Los enlaces a páginas web de otros fabricantes le llevan fuera de la página web de Hewlett Packard Enterprise. Hewlett Packard Enterprise no
tiene ningún control sobre la información ajena a la página web de Hewlett Packard Enterprise y no se hace responsable de ella.
Reconocimientos
Linux® es una marca registrada de Linus Torvalds en EE. UU.
Intel®, Itanium®, Pentium®, Intel Inside® y el logotipo de Intel Inside son marcas comerciales de Intel Corporation en los Estados Unidos y en
otros países.
Microsoft® y Windows® son marcas comerciales o registradas de Microsoft Corporation en los Estados Unidos y/o en otros países.
UNIX® es una marca registrada de The Open Group.
® es una marca registrada de UEFI Forum, Inc.
Contenido
1 Introducción.........................................................................................................6
Comandos y capacidades....................................................................................................................6
Acceso a Embedded UEFI Shell..........................................................................................................6
Acceso a UEFI Shell desde una conexión de consola serie...........................................................7
2 Referencia de comandos de UEFI Shell.............................................................8
Comandos personalizados del shell de Hewlett Packard Enterprise...................................................8
Ejemplos de la sintaxis de la línea de comandos.................................................................................8
Autocompletado de línea de comandos..........................................................................................8
Introducción a UEFI Shell.....................................................................................................................9
Control del resultado de los comandos...........................................................................................9
Limitación de los resultados a una sola pantalla a la vez..........................................................9
Activación o desactivación de saltos de página globales........................................................10
Visualización de resultados detallados....................................................................................10
Visualización de un resumen de los resultados.......................................................................11
Eliminación de la solicitud de confirmación al usuario.............................................................11
Visualización de la ayuda de los comandos..................................................................................12
Visualización de la ayuda de todos los comandos...................................................................12
Visualización de la ayuda de un comando específico..............................................................13
Visualización de todo el contenido de ayuda para los comandos que empiezan por un carácter
específico.................................................................................................................................14
Conmutación a un sistema de archivos desde el shell.................................................................16
Uso de comandos de instalación y configuración.........................................................................17
Actualización del comando fwupdate.................................................................................................17
Comandos de UEFI Shell...................................................................................................................18
ahsdownload.................................................................................................................................18
alias...............................................................................................................................................19
attrib...............................................................................................................................................20
boot................................................................................................................................................21
cd...................................................................................................................................................22
cls..................................................................................................................................................23
comp..............................................................................................................................................24
compress.......................................................................................................................................25
connect..........................................................................................................................................26
cp...................................................................................................................................................27
date................................................................................................................................................28
dblk................................................................................................................................................29
devices..........................................................................................................................................30
devtree...........................................................................................................................................31
dh...................................................................................................................................................32
disconnect.....................................................................................................................................34
dmem.............................................................................................................................................35
drivers............................................................................................................................................35
echo...............................................................................................................................................36
edit.................................................................................................................................................37
eficompress...................................................................................................................................38
efidecompress...............................................................................................................................38
exit.................................................................................................................................................38
ftp...................................................................................................................................................39
fwupdate........................................................................................................................................40
getmtc............................................................................................................................................41
goto................................................................................................................................................41
Contenido
3
help................................................................................................................................................41
ifconfig...........................................................................................................................................42
imlview...........................................................................................................................................43
load................................................................................................................................................44
ls/dir...............................................................................................................................................44
map................................................................................................................................................47
memmap........................................................................................................................................49
mkdir..............................................................................................................................................50
mode..............................................................................................................................................51
mv..................................................................................................................................................52
openinfo.........................................................................................................................................52
parse..............................................................................................................................................53
partitions........................................................................................................................................53
pause.............................................................................................................................................54
pci..................................................................................................................................................55
ping................................................................................................................................................55
ramdisk..........................................................................................................................................56
reset...............................................................................................................................................57
restclient........................................................................................................................................57
rm/del.............................................................................................................................................59
secboot..........................................................................................................................................60
set..................................................................................................................................................61
setsize...........................................................................................................................................62
shift................................................................................................................................................63
smbiosview....................................................................................................................................63
stall................................................................................................................................................64
sysconfig........................................................................................................................................64
Atributos de sysconfig..............................................................................................................66
sysinfo...........................................................................................................................................67
time................................................................................................................................................68
timezone........................................................................................................................................69
touch..............................................................................................................................................69
type................................................................................................................................................70
unload............................................................................................................................................70
ver..................................................................................................................................................71
vol..................................................................................................................................................71
webclient........................................................................................................................................72
3 Ejecución y edición de secuencias de comandos de UEFI Shell......................74
Métodos para la invocación de secuencias de comandos.................................................................74
Configuración del inicio automático de la secuencia de comandos de UEFI Shell en las utilidades
del sistema....................................................................................................................................74
Llamada manual a una secuencia de comandos del shell............................................................74
Exportación e importación de configuraciones a archivos.................................................................74
Edición de secuencias de comandos del shell...................................................................................74
Ejemplos de secuencias de comandos de UEFI Shell.......................................................................75
Secuencia de comandos con el código fuente de una aplicación.................................................75
Secuencia de comandos de inicio.................................................................................................76
4 Modelo de programación UEFI.........................................................................79
5 Códigos de estado de comandos de UEFI Shell...............................................82
6 Asistencia y otros recursos................................................................................83
Acceso al soprte de Hewlett Packard Enterprise...............................................................................83
Acceso a las actualizaciones..............................................................................................................83
Información relacionada.....................................................................................................................84
4
Contenido
Páginas web.......................................................................................................................................84
Reparaciones del propio cliente.........................................................................................................84
Remote Support..................................................................................................................................84
Comentarios sobre la documentación................................................................................................85
Glosario................................................................................................................86
Índice....................................................................................................................87
Contenido
5
1 Introducción
El BIOS del sistema de todos los servidores ProLiant Gen9 incluye Embedded UEFI Shell en la
ROM. El entorno del shell está basado en la UEFI Shell Specification (Especificación de UEFI
Shell) y proporciona una API y una CLI que permiten ejecutar secuencias de comandos, manipular
archivos y obtener información del sistema. El shell ejecuta también otras aplicaciones UEFI.
Estas características mejoran las capacidades de las utilidades del sistema UEFI. El acceso a
Embedded UEFI Shell está activado de forma predeterminada.
Comandos y capacidades
A continuación se detallan los comandos y las capacidades que están disponibles en UEFI Shell:
•
•
•
Comandos de configuración:
◦
Configuración del BIOS (sysconfig)
◦
Actualizaciones de firmware de memoria ROM, almacenamiento y adaptador de NIC
(fwupdate)
Creación de secuencias de comandos:
◦
Archivos nsh con estructuras habituales de secuencias de comandos, como if, else,
endif, shift o for/endfor
◦
Comando echo
◦
Archivo de inicio de automático startup.nsh similar al archivo Autoexec.bat
◦
Una opción de resultados en formato estándar (-sfo) para varios comandos que
permite analizar los datos de salida separados por comas mediante un comando de
análisis
Manipulación de archivos:
◦
Capacidad para leer cualquier archivo FAT16 y FAT32
◦
Comandos de operaciones de archivo estándar como, por ejemplo, md, cd, cp/copy,
del, dir/ls, atrib, alias y touch
◦
Edición (edit) y visualización (type) de archivos
◦
Redireccionamiento de la entrada y la salida desde y hacia las consolas, así como a
archivos
Acceso a Embedded UEFI Shell
Requisitos previos
1.
2.
3.
4.
Asegúrese de que esté activado Embedded UEFI Shell. De forma predeterminada está
activado.
Opcional: agregue Embedded UEFI Shell a la lista UEFI Boot Order (Orden de
arranque UEFI).
Opcional: active la ejecución automática de secuencias de comandos de UEFI Shell.
Cambie la entrada Embedded UEFI Shell en la lista UEFI Boot Order (Orden de
arranque UEFI).
Para obtener más información, consulte “Opciones de Embedded UEFI Shell” en la Guía de
usuario de las utilidades del sistema HPE UEFI para servidores HPE ProLiant Gen9.
6
Introducción
Para obtener acceso al shell:
Use uno de los métodos siguientes:
•
Durante el proceso POST del servidor, pulse F11 (menú de arranque) en la pantalla POST
de ProLiant.
•
En la pantalla System Utilities (Utilidades del sistema), seleccione Embedded
Applications (Aplicaciones integradas)→Embedded UEFI Shell y pulse la tecla Intro.
Consulte "Uso de las aplicaciones integradas" en la Guía de usuario de las utilidades del
sistema HPE UEFI para servidores HPE ProLiant Gen9.
•
Mediante una conexión de consola serie. Consulte Acceso a UEFI Shell desde una conexión
de consola serie.
•
Mediante un puerto serie del servidor. Consulte “Opciones de puerto serie” en la Guía de
usuario de las utilidades del sistema HPE UEFI para servidores HPE ProLiant Gen9.
Acceso a UEFI Shell desde una conexión de consola serie
Requisito previo
El software de terminal debe utilizar un juego de caracteres Unicode (por ejemplo: UTF-8).
NOTA: Cuando se accede al shell desde una consola serie, el inglés es el único idioma
disponible para las entradas y salidas.
Para obtener acceso al shell:
1.
2.
3.
4.
Arranque el servidor.
Abra una conexión en una aplicación cliente SSH con la dirección IP del servidor.
Deje el puerto SSH con el valor 22.
En el símbolo del sistema de inicio de sesión, escriba su nombre de usuario y su contraseña.
Aparecerá el símbolo del sistema hpiLO->.
5.
Escriba el comando vsp y, a continuación, pulse la tecla Intro para abrir el puerto serie
virtual.
Aparecerá el símbolo del sistema Shell>.
6.
7.
Escriba los comandos necesarios para completar la tarea. Para obtener más información
sobre los comandos que se utilizan en UEFI Shell, consulte Referencia de comandos de
UEFI Shell.
Escriba el comando exit para salir del shell.
Ejemplo 1 Inicio de sesión desde una conexión de consola serie
login as: nombre de usuario
@<dirección ip>'s password: contraseña
User: logged-in to <ruta del servidor> / <dirección MAC del servidor>
iLO 4 Standard 1.30 at January 16 2014
Server Name:
Server Power: On
hpiLO-> vsp
Virtual Serial Port Active: COM2
Starting virtual serial port.
Press 'ESC (' to return to the CLI Session.
Shell>
Acceso a Embedded UEFI Shell
7
2 Referencia de comandos de UEFI Shell
La siguiente información proporciona una vista general de los comandos de UEFI Shell, así
como una descripción de cada comando, su sintaxis y ejemplos de cómo utilizarlos.
Comandos personalizados del shell de Hewlett Packard Enterprise
Este símbolo indica que un comando es una adición personalizada de Hewlett Packard
Enterprise a los comandos proporcionados por la UEFI Shell Specification (Especificación de
UEFI Shell).
Ejemplos de la sintaxis de la línea de comandos
A continuación se muestran ejemplos de cómo se debe interpretar la sintaxis de los comandos.
exit
Escriba exit.
date[mm/dd/{yy|yyyy}][-sfo]
Realice una de las acciones siguientes para mostrar la fecha actual:
•
Escriba el comando date sin parámetros opcionales.
•
Escriba el comando date seguido de -sfo para obtener los resultados en formato
estándar.
Para establecer una fecha específica en el sistema, escriba el comando date seguido
de los parámetros de fecha en uno de los formatos siguientes:
◦
mm/dd/aa
◦
mm/dd/aaaa
Esta sintaxis indica que los parámetros de mes (mm) y día (dd) son opcionales, pero que
se necesita el parámetro de año de dos dígitos (aa) o de cuatro dígitos (aaaa) para
configurar una fecha.
eficompress archivo-de-entrada archivo-resultante
Escriba eficompress seguido del nombre del archivo de entrada sin comprimir como
parámetro archivo-de-entrada y especifique el archivo resultante comprimido como
parámetro archivo-resultante.
Autocompletado de línea de comandos
Las siguientes teclas de completado de la línea de comandos simplifican la especificación y
reutilización de comandos.
8
•
Flecha arriba: Permite retroceder por la lista de comandos especificados anteriormente.
•
Fecha abajo: Permite avanzar por la lista de comandos especificados anteriormente.
•
TAB: Permite completar los nombres de archivo en la línea de comandos. Escriba al menos
un carácter y, a continuación, pulse la tecla TAB para completar el nombre de archivo. Si
existe más de una posibilidad, vuelva a pulsar la tecla TAB para ver todas las posibilidades.
•
Re pág: Permite desplazarse a una página anterior.
•
Av Pág: Permite desplazarse a una página posterior.
Referencia de comandos de UEFI Shell
Introducción a UEFI Shell
A continuación se describe cómo utilizar los comandos básicos de UEFI Shell para realizar las
siguientes tareas:
•
Control del resultado de los comandos
•
Visualización de la ayuda de los comandos
•
Conmutación a un sistema de archivos desde el shell
•
Uso de comandos de instalación y configuración
Control del resultado de los comandos
Muchos comandos de UEFI Shell admiten parámetros opcionales para controlar el modo en que
se muestran los resultados en la pantalla. En las secciones siguientes se explican estas opciones
y se muestran ejemplos de su uso.
•
Limitación de los resultados a una sola pantalla a la vez
•
Visualización de resultados detallados
•
Eliminación de la solicitud de confirmación al usuario
Limitación de los resultados a una sola pantalla a la vez
El siguiente ejemplo muestra cómo utilizar la opción –b para limitar el resultado a una sola
pantalla a la vez. Cuando se muestre la primera pantalla, el shell solicitará que realice una de
las acciones siguientes:
•
Pulse Intro para continuar con la pantalla siguiente.
•
Pulse la tecla Q para salir de la pantalla.
Introducción a UEFI Shell
9
Ejemplo 2 Uso del comando -b para mostrar los resultados en una pantalla a la vez
Shell> devtree -b
Ctrl[03] Fv(6522280D-28F9-4131-ADC4-F40EBFA45864)
Ctrl[04] Fv(770BF9B6-8AFE-4F4C-85E5-893FC3D2606C)
Ctrl[05] Fv(27A72E80-3118-4C0C-8673-AA5B4EFA9613)
Ctrl[06] MemoryMapped(0xB,0xFFD40000,0xFFD6FFFF)
Ctrl[07] Fv(5A515240-D1F1-4C58-9590-27B1F0E86827)
Ctrl[08] Fv(5E2363B4-3E9E-4203-B873-BB40DF46C8E6)
Ctrl[09] Fv(CDBB7B35-6833-4ED6-9AB2-57D2ACDDF6F0)
Ctrl[5F] PciRoot(0x0)
Ctrl[195] PciRoot(0x0)/Pci(0x0,0x0)
Ctrl[196] PciRoot(0x0)/Pci(0x2,0x0)
Ctrl[197] PciRoot(0x0)/Pci(0x2,0x0)/Pci(0x0,0x0)
Ctrl[198] PciRoot(0x0)/Pci(0x2,0x1)
Ctrl[199] PciRoot(0x0)/Pci(0x2,0x2)
Ctrl[19A] PciRoot(0x0)/Pci(0x2,0x3)
Ctrl[19B] PciRoot(0x0)/Pci(0x3,0x0)
Ctrl[19C] PciRoot(0x0)/Pci(0x3,0x1)
Ctrl[19D] PciRoot(0x0)/Pci(0x3,0x2)
Ctrl[19E] PciRoot(0x0)/Pci(0x3,0x3)
Ctrl[19F] PciRoot(0x0)/Pci(0x4,0x0)
Ctrl[1A0] PciRoot(0x0)/Pci(0x4,0x1)
Ctrl[1A1] PciRoot(0x0)/Pci(0x4,0x2)
Ctrl[1A2] PciRoot(0x0)/Pci(0x4,0x3)
Ctrl[1A3] PciRoot(0x0)/Pci(0x4,0x4)
Ctrl[1A4] PciRoot(0x0)/Pci(0x4,0x5)
Ctrl[1A5] PciRoot(0x0)/Pci(0x4,0x6)
Ctrl[1A6] PciRoot(0x0)/Pci(0x4,0x7)
Ctrl[1A7] PciRoot(0x0)/Pci(0x5,0x0)
Ctrl[1A8] PciRoot(0x0)/Pci(0x5,0x1)
Ctrl[1A9] PciRoot(0x0)/Pci(0x5,0x2)
Ctrl[1AA] PciRoot(0x0)/Pci(0x5,0x4)
Press ENTER to continue or 'Q' break:
Para ver un ejemplo de uso de esta opción con el comando help, consulte el Ejemplo 6
(página 13).
Activación o desactivación de saltos de página globales
Utilice el comando pagebreak para activar o desactivar la paginación de los resultados de
forma global Este comando crea una variable de entorno UEFI que se retiene hasta el siguiente
reinicio del servidor.
Ejemplos
Para habilitar los saltos de página globales, haga lo siguiente:
fs0:\> set -v pagebreak 1
Para deshabilitar los saltos de página globales, haga lo siguiente:
fs0:\> set -v pagebreak 0
Visualización de resultados detallados
Utilice la opción –v para mostrar los resultados detallados (modo detallado) de determinados
comandos. Entre los comandos del shell que admiten esta opción se incluyen los siguientes:
10
•
dh
•
help
•
map
Referencia de comandos de UEFI Shell
A continuación se ofrece un ejemplo de cómo mostrar los resultados detallados del comando
dh (identificador de dispositivo) en una sola pantalla a la vez.
Ejemplo 3 Uso del comando -v para mostrar resultados detallados
Shell> dh -v -b
01: LoadedImage
02: Decompress
03: UnknownDevice DevicePath Fv(6522280D-28F9-4131-ADC4-F40EBFA45864) UnknownDevice
04: UnknownDevice DevicePath Fv(770BF9B6-8AFE-4F4C-85E5-893FC3D2606C) UnknownDevice
05: UnknownDevice DevicePath Fv(27A72E80-3118-4C0C-8673-AA5B4EFA9613) UnknownDevice
06: UnknownDevice DevicePath Fv(29A72E80-7BFE-4101-8459-AB5B3EFA4271) UnknownDevice
07: UnknownDevice DevicePath Fv(5A515240-D1F1-4C58-9590-27B1F0E86827) UnknownDevice
08: UnknownDevice DevicePath Fv(5E2363B4-3E9E-4203-B873-BB40DF46C8E6) UnknownDevice
09: UnknownDevice DevicePath Fv(CDBB7B35-6833-4ED6-9AB2-57D2ACDDF6F0) UnknownDevice
0A: UnknownDevice UnknownDevice
0B: ImageDevicePath LoadedImage
0C: UnknownDevice Pcd
0D: ImageDevicePath LoadedImage
0E: UnknownDevice UnknownDevice
0F: ImageDevicePath LoadedImage
10: UnknownDevice ImageDevicePath LoadedImage
11: UnknownDevice UnknownDevice UnknownDevice ImageDevicePath LoadedImage
12: ImageDevicePath LoadedImage
13: UnknownDevice
14: UnknownDevice ImageDevicePath LoadedImage
15: UnknownDevice
16: UnknownDevice
17: ImageDevicePath LoadedImage
18: ImageDevicePath LoadedImage
19: UnknownDevice ImageDevicePath LoadedImage
1A: ImageDevicePath LoadedImage
1B: UnknownDevice
1C: ImageDevicePath LoadedImage
1D: UnknownDevice
Press ENTER to continue or 'Q' break:
Visualización de un resumen de los resultados
Utilice la opción –t para mostrar un resumen de los resultados (modo simplificado) de
determinados comandos. Entre los comandos del shell que admiten esta opción se incluyen los
siguientes:
•
ver
El ejemplo siguiente muestra cómo utilizar el comando ver para mostrar información detallada
de la versión de UEFI y cómo utilizar la opción -t para mostrar un resumen.
Ejemplo 4 Uso de la opción -t para mostrar un resumen de los resultados
Shell> ver
HP Embedded UEFI Shell v2.1
(C) Copyright 1982 — 2015 Hewlett Packard Enterprise Development L.P.
UEFI v2.40 (HP, 0x00010000)
HP ProLiant System BIOS - P79 (01/14/2014)
Shell> ver -t
HP Embedded UEFI Shell v2.1
Eliminación de la solicitud de confirmación al usuario
Utilice la opción –q para ejecutar determinados comandos en modo silencioso sin que se muestren
solicitudes de confirmación. Entre los comandos del shell que admiten esta opción se incluyen
los siguientes:
•
cp
Introducción a UEFI Shell
11
•
rm/del
El ejemplo siguiente muestra cómo utilizar esta opción con el comando rm para eliminar todos
los directorios temp sin que se muestren solicitudes de confirmación.
Ejemplo 5 Uso de la opción -q para eliminar las solicitudes de confirmación
fs0:\> rm -q test\temp*
removing fs0:\test\temp1\temp1.txt
- [ok]
removing fs0:\test\temp1\boot\nshell.efi
- [ok]
removing fs0:\test\temp1\boot
- [ok]
removing fs0:\test\temp1
- [ok]
removing fs0:\test\temp2\temp2.txt
- [ok]
removing fs0:\test\temp2
- [ok]
Visualización de la ayuda de los comandos
Existen varias opciones de comandos con las que se puede mostrar la ayuda detallada y resumida
de uno o varios comandos.
•
Visualización de la ayuda de todos los comandos
•
Visualización de la ayuda de un comando específico
•
Visualización de todo el contenido de ayuda para los comandos que empiezan por un
carácter específico
Visualización de la ayuda de todos los comandos
A continuación se ofrece un ejemplo de cómo mostrar la ayuda de todos los comandos en una
pantalla a la vez:
12
Referencia de comandos de UEFI Shell
Ejemplo 6 Visualización de la ayuda de todos los comandos en una pantalla a la vez
Shell> help –b
ahsdownload
- Downloads the Active Heath System (AHS).
alias
- Displays, creates, or deletes UEFI Shell aliases.
attrib
- Displays or changes the attributes of files or directories.
boot
- Boots or displays boot options.
cd
- Displays or changes the current directory.
cls
- Clears standard output and optionally changes background color.
comp
- Compares the contents of two files on a byte for byte basis.
compress
- Compresses and decompresses files to and from zip files using MiniZip.
connect
- Binds a driver to a specific device and starts the driver.
cp
- Copies one or more files or directories to another location.
date
- Displays and sets the current date for the system.
devices
- Displays the list of devices managed by UEFI drivers.
devtree
- Displays the UEFI Driver Model compliant device tree.
dh
- Displays the device handles in the UEFI environment.
dmem
- Displays the contents of system or device memory.
drivers
- Displays the UEFI driver list.
echo
- Controls script file command echoing or displays a message.
edit
- Displays a full screen editor for ASCII or UCS-2 files.
eficompress
- Compresses a file using UEFI Compression Algorithm.
efidecompress - Decompresses a file using UEFI Decompression Algorithm.
else
- Identifies the code executed when 'if' is FALSE.
endfor
- Ends a 'for' loop.
endif
- Ends the block of a script controlled by an 'if' statement.
exit
- Exits the UEFI Shell or the current script.
for
- Starts a loop based on 'for' syntax.
fwupdate
- Updates BIOS or device firmware.
Press ENTER to continue or 'Q' break:
Visualización de la ayuda de un comando específico
Utilice cualquiera de las siguientes opciones de sintaxis para mostrar la ayuda de un comando
específico:
•
help nombre-del-comando
•
? nombre-del-comando
•
nombre-del-comando-?
A continuación se ofrece un ejemplo de cómo mostrar la ayuda del comando ls (una pantalla
a la vez).
Introducción a UEFI Shell
13
Ejemplo 7 Visualización de la ayuda del comando ls
Shell> help ls -b
Lists a directory's contents or file information.
LS [-r] [-a[attrib]][-sfo][file]format:
-r
- Displays recursively (including subdirectories)
-a
- Display only those files with the attributes of type attrib. If no
attributes are listed, all files will be listed. If -a is not
specified, all non-system and non-hidden files will be listed.
-sfo
- Display information in Standard-Format Output.
attrib - File attribute list:
a - Archive
s - System
h - Hidden
r - Read-only
d - Directory
file
- Name of file or directory (wildcards are permitted)
NOTES:
1. This command lists directory contents or file information. If no file
name or directory name is specified, the current working directory
is assumed.
2. The contents of a directory are listed if all of the following are true:
- If option -r is not specified
- If no wildcard characters are specified in the file parameter
- If file represents an existing directory
3. In all other cases, the command functions as follows:
- All files/directories that match the specified name are displayed.
- The -r flag determines whether a recursive search is performed.
- The option flag -a[attrib] tells the command to display only those
files with the attributes that are specified by [attrib].
Para obtener más detalles sobre la utilización del comando help, consulte «help» (página 41).
Visualización de todo el contenido de ayuda para los comandos que empiezan por un carácter
específico
Utilice un carácter comodín (*) para mostrar la ayuda de todos los comandos que empiecen por
un carácter específico. En el ejemplo siguiente se indica cómo mostrar la ayuda de todos los
comandos que empiezan por el carácter a.
14
Referencia de comandos de UEFI Shell
Ejemplo 8 Visualización de la ayuda de los comandos que empiezan por la letra a
Shell> help a*
Downloads the Active Health System (AHS).
AHSDOWNLOAD [-n <file name> | -u <serial number>]
[-s <start date> -e <end date>]
[-case <case number>] [-name ,contact name>]
[-phone <phone number>] [-email email address>]
[-company <company name>] [-a] [-l] [-q]
-n
-u
-s
-e
-a
-l
-q
-case
-name
-phone
-email
-company
-file name
-serial number
-start date
-end date
-case number
-contact name
-phone number
-email address
-company name
–Overrides the default AHS file name.
–Overrides the serial number field in the default AHS
file name.
–Specifies a start date.
–Specifies an end date.
–Downloads all data from the AHS log.
–Displays AHS available download date range information.
–Performs the download in quiet mode without user prompts.
–Specifies a support case number.
–Specifies a customer name.
–Specifies a customer phone number.
–Specifies a customer email address.
–Specifies a customer company name.
–Specifies a destination file name.
–Specifies a system serial number.
–Specifies a the start date (in YYYY-MM-DD format) on which the data from the AHS
log is to be retrieved.
–Specifies the last date (in YYYY-MM-DD format) on which the data from the AHS
log is to be retrieved.
–Adds a support case number to the customer information file.
–Adds a customer name to the customer information file.
–Adds a customer phone number to the customer information file.
–Adds a customer email address to the customer information file.
–Adds a customer company name to the customer information file.
NOTES:
1. The Active Health System monitors and records changes in the server
hardware and system configuration. The Active Health System assists in
diagnosing problems and delivering rapid resolution when system failures occur.
2. The Active Health System does not collect information about your
operations, finances, customer, employees, partners, or data center
(for example, IP addresses, host names, user names, and passwords
are not collected). By downloading and sending the Active Health System
data, you agree to have support personnel use the data for analysis,
technical resolution, and quality improvements.
3. This command mounts an AHS partition and downloads AHS log files
and bundles into an .ahs package file.
4. If the start date (-s) and end date (-e) are not specified, by default AHS
data related to the last 7 days is downloaded.
5. If a start date (-s) without an end date (-e) is specified, AHS
uses the current date as and end date to download.
6. If a start date (-s) and end date (-e) are specified, only AHS data in that
date range, including start and end dates, is downloaded.
7. If a file name is not specified using the —n option, a default file name is
generated. For instance, AHS_xxxxxxxxxxx_20140821.ahs.
8. This command does not support downloading an Active Health file (.ahs)
to the internal SD card.
EXAMPLES:
* To display available AHS download date range information:
fs0:\> ahsdownload —1
* To download an AHS file to the default location with a log spanning 7 days (the default range):
fs0:\> ahsdownload
* To download an AHS file to the default location with a complete log available:
fs0:\> ahsdownload —a
* To download an AHS file with a specific date range:
fs0:\> ahsdownload —n ahstestfile.ahs —s 2014–04–02 —e 2014–04–07
* To download an AHS file to the default location with a complete og and customer
information:
fs0:\> ahsdownload —a —case 1234 —name Joe —phone 123–456–7890
–email [email protected] —company MyCompany
Displays, creates, or deletes UEFI Shell aliases.
ALIAS [-d|-v] [alias-name] [command-name]m all files with extension '.inf':
fs0:\> attrib -r *.inf
-d
- Delete an alias. command-name must not be specified.
-v
- Make the alias volatile.
alias-name
- Alias name
command-name - Original command's name or path.
NOTES:
1. This command displays, creates, or deletes aliases in the UEFI Shell
environment.
2. An alias provides a new name for an existing UEFI Shell
command or UEFI application. Once the alias is created, it can be used
Introducción a UEFI Shell
15
to run the command or launch the UEFI application.
3. There are some aliases that are predefined in the UEFI Shell environment.
These aliases provide the MS-DOS and UNIX equivalent names for the file
manipulation commands.
4. Aliases will be retained even after exiting the shell unless the -v option
is specified. If -v is specified the alias will not be valid after
leaving the shell.
EXAMPLES:
* To display all aliases in the UEFI Shell environment:
Shell> alias
* To create an alias in the UEFI Shell environment:
Shell> alias shutdown "reset -s"
* To delete an alias in the UEFI Shell environment:
Shell> alias -d shutdown
* To add a volatile alias in the current UEFI environment, which has a star *
at the line head. This volatile alias will disappear at next boot.
Shell> alias -v fs0 floppy
Displays or changes the attributes of files or directories.
ATTRIB [+a|-a] [+s|-s] [+h|-h] [+r|-r] [file...] [directory...]
+a|-a
+s|-s
+h|-h
+r|-r
file
directory
-
Set or clear the 'archive' attribute
Set or clear the 'system' attribute
Set or clear the 'hidden' attribute
Set or clear the 'read-only' attribute
File name (wildcards are permitted)
Directory name (wildcards are permitted)
NOTES:
1. Four attribute types are supported in the UEFI file system:
- Archive [A]
- System [S]
- Hidden [H]
- Read only [R]
2. If a file (in general meaning) is a directory, it is also shown
to have the attribute [D].
3. If any file in the file list that is specified in the command line
does not exist, attrib will continue processing the remaining files
while reporting the error.
4. If no attributes parameters are specified, the current attributes of
the specified files or directories will be displayed.
5. If no files or directories are specified, the command applies to
all files and sub-directories within the current directory.
EXAMPLES:
* To display the attributes of a directory:
Shell> :\> attrib fs0:\
* To display the attributes of all files and sub-directories in the current
directory:
fs0:\> attrib *
* To add the system attribute to all files with extension '.efi':
fs0:\> attrib +s *.efi
* To remove the read only attribute from all files with extension '.inf':
fs0:\> attrib -r *.inf
Conmutación a un sistema de archivos desde el shell
Para cambiar a un sistema de archivos desde el shell antes de ejecutar comandos que requieran
la entrada o salida de archivos:
1. Si utiliza una unidad de disco duro, una unidad USB o una unidad USB iLO virtual, conecte
un sistema de archivos con formato FAT16 o FAT32.
2. Utilice el comando map –r para actualizar las asignaciones del sistema de archivos.
Consulte map.
3. Escriba el comando de uno de los sistemas de archivos fsx disponibles como, por ejemplo,
fs0 o fs1 y, a continuación, pulse la tecla Intro.
El símbolo del sistema cambia a fsx>, donde la x representa el número del sistema de
archivos seleccionado.
De este modo, podrá tener acceso a los archivos de escritura del sistema de archivos especificado
y modificarlos.
El ejemplo siguiente muestra cómo tener acceso al sistema de archivos fs0 desde el shell.
16
Referencia de comandos de UEFI Shell
Ejemplo 9 Acceso al sistema de archivos fs0 desde el shell
Shell> map -r
Shell>fs0:
fs0:\>
NOTA: Los ejemplos de resultados de esta guía utilizan el símbolo del sistema fs0:\> para
mostrar la ubicación de acceso al sistema de archivos desde el shell.
Uso de comandos de instalación y configuración
1 ¿Cómo entro en Embedded UEFI Shell?
Consulte Acceso a Embedded UEFI Shell.
2 ¿Cómo actualizo el firmware o la memoria ROM del sistema?
Consulte fwupdate.
3 ¿Cómo determino si un servidor tiene opciones de arranque UEFI?
Consulte sysconfig.
4 ¿Cómo configuro la zona horaria?
Consulte timezone.
5 ¿Cómo creo un disco de RAM temporal desde Embedded UEFI Shell?
Consulte ramdisk.
6 ¿Cómo vuelco el registro de gestión integrado (IML) en un archivo determinado de un
disco de RAM desde Embedded UEFI Shell y confirmo que el archivo se encuentra en
el disco de RAM?
Consulte imlview.
7 ¿Cómo restablezco una o todas las asignaciones entre los nombres definidos por el
usuario y los identificadores de dispositivos?
Consulte map.
8 ¿Cómo puedo mostrar todos los dispositivos compatibles con el modelo de controlador
de UEFI?
Consulte devtree.
9 ¿Cómo salgo de Embedded UEFI Shell y vuelvo a las Utilidades del sistema?
Consulte exit.
Actualización del comando fwupdate
1.
2.
3.
4.
5.
6.
7.
8.
Obtenga el componente System ROM Flash Binary para el servidor en el Centro de soporte
de Hewlett Packard Enterprise (http://www.hpe.com/support/hpesc). Cuando busque el
componente, seleccione siempre Cross operating system (Distintos sistemas operativos)
para localizar el archivo binario.
Copie el archivo binario en un soporte USB o en iLO Virtual Media.
Conecte el soporte al servidor.
Arranque con UEFI Embedded Shell.
Para obtener el volumen del sistema de archivos asignado a la llave USB, escriba map –r.
Cambie al sistema de archivos que contiene el componente System ROM Flash Binary para
el servidor. Especifique uno de los sistemas de archivos fsx disponibles, como por ejemplo,
fs0 o fs1 y, a continuación, pulse Intro.
Utilice el comando cd para cambiar desde el directorio actual al directorio que contiene el
archivo binario.
Escriba fwupdate –d BIOS -f nombre-de-archivo para actualizar la ROM del
sistema.
Actualización del comando fwupdate
17
9.
Reinicie el servidor. Se requiere reiniciar después de actualizar el firmware para que las
actualizaciones tengan efecto y para poder mantener la estabilidad del hardware.
Comandos de UEFI Shell
A continuación se describen los componentes de cada lista de comandos y posteriormente se
enumeran los comandos de UEFI Shell por orden alfabético.
Requisito previo
Todos los comandos requieren autorización de administrador del BIOS. Para obtener información
sobre la configuración de la contraseña del administrador, consulte "Seguridad del servidor" en
la Guía de usuario de las utilidades del sistema HPE UEFI para servidores HPE ProLiant Gen9.
Todos los comandos requieren autorización de administrador del BIOS. Para obtener información
acerca de cómo establecer la contraseña del administrador, consulte sysconfig.
Sintaxis
Sintaxis del comando, incluidos los parámetros necesarios
y opcionales
Descripción
Breve descripción de cómo se utiliza el comando
Opciones
Descripción de los parámetros de sintaxis y las variables
Uso
Descripción detallada del uso del comando
Ejemplos
Uno o varios ejemplos del uso del comando.
NOTA: Los elementos que debe especificar el usuario
se muestran en negrita en los ejemplos de uso de los
comandos.
Detalles de los resultados
Descripciones de los campos mostrados por el comando,
si procede.
ahsdownload
Sintaxis
ahsdownload[-n filename]|[-u serialnumber][-s startdate][-e
enddate][-case casenumber][-name contactname][-email emailaddress][-phone
phonenumber][-company companyname][-email emailaddress][-a][-l][-q]
Descripción
Descarga los registros de Active Health System (AHS).
Opciones
18
-n nombre-de-archivo
Especifica el nombre del archivo de AHS.
-u número-de-serie
Especifica el número de serie del sistema.
-s fecha-de-inicio
Especifica la fecha de inicio (en formato AAAA-MM-DD)
de los datos que se van a recuperar.
-e fecha-de-finalización
Especifica la fecha de finalización (en formato
AAAA-MM-DD) de los datos que se van a recuperar.
-case número-de-caso
Añade un número de caso de soporte técnico al archivo
de información del cliente.
-name nombre-de-contacto
Añade un nombre de contacto al archivo de información
del cliente.
Referencia de comandos de UEFI Shell
-phone número-de-teléfono
Añade un número de teléfono al archivo de información
del cliente.
-email
Añade una dirección de correo electrónico al archivo de
dirección-de-correo-electrónico información del cliente.
-a
Descarga todos los datos del registro de AHS.
-l
Muestra información del intervalo de fechas de descarga
de AHS.
-q
Realiza la descarga en modo silencioso sin mostrar
preguntas al usuario.
Uso
AHS supervisa y registra los cambios efectuados en el hardware del servidor y la configuración
del sistema. Puede ayudarle a diagnosticar problemas y encontrar soluciones rápidamente.
AHS no recopila información acerca de operaciones, finanzas, clientes, empleados, socios ni
centros de datos (no se recuperan direcciones IP, nombres de host, nombres de usuario ni
contraseñas). La descarga y el envío de datos a Hewlett Packard Enterprise a través de AHS
implican el consentimiento del usuario respecto al uso de sus datos por parte de Hewlett Packard
Enterprise para su análisis y aplicación en resoluciones técnicas y mejoras en la calidad.
Este comando monta una partición de AHS, descarga los archivos de registro de AHS y los
incluye en un archivo de paquete .ahs.
Si no se especifican las fechas de inicio y de finalización, de manera predeterminada se descargan
los datos de AHS relacionados con los últimos 7 días. Si se especifica una fecha de inicio pero
no una fecha de finalización, AHS utiliza la fecha actual como fecha de finalización para la
descarga. Si se especifican las fechas de inicio y de finalización, únicamente se descargan los
datos de AHS de ese intervalo de fechas, incluidas las fechas de inicio y de finalización. Si no
se especifica un nombre de archivo, se genera uno predeterminado. Por ejemplo,
HPE_xxxxxxxxxx_20140821.ahs.
Ejemplos
Para mostrar información sobre el intervalo de fechas de descarga de AHS disponibles:
fs0:\> ahsdownload -l
Para descargar un archivo de AHS en la ubicación predeterminada con los datos registrados
durante los últimos 7 días (el intervalo predeterminado):
fs0:\> ahsdownload
Para descargar un archivo de AHS con un intervalo de fechas específico:
fs0:\> ahsdownload -n ahstestfile.ahs -s 2015-04-02 -e 2015-04-07
Para descargar un archivo de AHS en la ubicación predeterminada con el registro completo e
información sobre el cliente:
fs0:\> ahsdownload -a -case 1234 -name Joe -phone 123-456-7890
-email [email protected] -company MyCompany
alias
Sintaxis
alias[-d|-v][alias-name][command-name]
Descripción
Permite mostrar, crear o eliminar alias en el entorno de UEFI Shell.
Comandos de UEFI Shell
19
Uso
Los alias permiten proporcionar un nuevo nombre para una aplicación UEFI o un comando de
UEFI Shell existente. Una vez creado el alias, puede utilizarse para ejecutar el comando o iniciar
la aplicación UEFI.
El entorno de UEFI Shell cuenta con algunos alias predefinidos. Estos alias proporcionan nombres
equivalentes de MS-DOS y UNIX para los comandos de manipulación de archivos.
Los alias se conservan incluso después de salir del shell a menos que se especifique la opción
–v. Si se especifica la opción -v, el alias dejará de ser válido tras salir del shell.
Ejemplos
Para mostrar todos los alias en el entorno de UEFI Shell:
Shell> alias
md : mkdir
rd : rm
myguid : guid
Para crear un alias en el entorno de UEFI Shell:
Shell> alias myguid guid
Shell> alias
md : mkdir
rd : rm
myguid : guid
Para eliminar un alias del entorno de UEFI Shell:
Shell> alias -d myguid
Shell> alias
md : mkdir
rd : rm
Para agregar un alias volátil al entorno UEFI actual, identificado con un asterisco * al principio
de la línea. Este alias volátil desaparecerá en el siguiente arranque:
Shell> alias -v fs0 floppy
Shell> alias
md : mkdir
rd : rm
* fs0 : floppy
attrib
Sintaxis
attrib[+a|-a][+s|-s][+h|-h][+r|-r][file...][directory...]
Descripción
Permite mostrar, establecer o modificar los atributos de archivos o directorios.
Opciones
20
[+a|-a]
Establece o borra el atributo archivo.
[+s|-s]
Establece o borra el atributo system.
[+h|-h]
Establece o borra el atributo oculto.
[+r|-r]
Establece o borra el atributo solo-lectura.
archivo...
Especifica el nombre del archivo. Este comando admite el uso de caracteres
comodín.
directorio...
Especifica el nombre del directorio. Este comando admite el uso de
caracteres comodín.
Referencia de comandos de UEFI Shell
Uso
El sistema de archivos UEFI admite los cuatro tipos de atributos siguientes:
•
Archivo: A
•
Sistema: S
•
Oculto: H
•
Solo lectura: R
Si un archivo es un directorio también mostrará el atributo D.
Si no existe alguno de los archivos de la lista especificado en la línea de comandos, attrib
seguirá procesando los archivos restantes e informará del error detectado.
Si no se especifica ningún archivo o directorio, se mostrarán todos los archivos del directorio
actual.
Si no se especifica ningún atributo, se mostrarán los atributos de los archivos.
Ejemplos
Para mostrar los atributos de un directorio:
fs0:\> attrib fs0:\
attrib: D fs0:\
Para mostrar los atributos de todos los archivos y subdirectorios del directorio actual:
fs0:\> attrib *
\attrib: AS fs0:\serial.efi
attrib: DA fs0:\test1
attrib: A HR fs0:\bios.inf
attrib: A fs0:\VerboseHelp.txt
attrib: AS fs0:\IsaBus.efi
Para agregar el atributo system a todos los archivos que tengan la extensión .efi:
fs0:\> attrib +s *.efi
Para quitar el atributo read-only de todos los archivos que tengan la extensión .inf:
fs0:\> attrib -r *.inf
\attrib: A H fs0:\bios.inf
boot
Sintaxis
boot[[-d[-sfo]]|[-n num]|-all|-pxe][r]
Descripción
Arranca o muestra las opciones de arranque de UEFI.
Opciones
-d
Muestra las opciones de arranque de UEFI por orden.
-n
Arranca con una opción de arranque de UEFI específica.
núm
Especifica un número de opción para arrancar. Este es un valor hexadecimal de cuatro
dígitos para cada opción.
-all
Intenta arrancar con todas las opciones de arranque de UEFI por orden.
-pxe
Intenta arrancar con todas las opciones de arranque de UEFI PXE por orden.
-r
Actualiza las opciones de arranque de UEFI.
-sfo
Muestra la información de los resultados en formato estándar.
Comandos de UEFI Shell
21
Uso
Este comando no puede mostrar ni arrancar con las opciones de arranque del BIOS heredado.
Puede utilizarlo para configurar una transición sin problemas desde un destino de arranque UEFI
a otro (por ejemplo, una imagen de sistema operativo descargada) sin necesidad de reiniciar el
sistema.
Ejemplos
Para que se muestren las opciones de arranque de UEFI por orden:
Shell> boot -d
Para actualizar las opciones de arranque en la lista Boot Order (Orden de arranque) y permitir
la activación de los dispositivos agregados o quitados recientemente:
Shell> boot -r
Para actualizar las opciones de arranque y, a continuación, mostrar todas las opciones de
arranque de UEFI por orden:
Shell> boot -r –d
Para arrancar con las opciones de arranque de UEFI por orden:
Shell> boot -all
Para arrancar con las opciones de arranque de UEFI PXE por orden:
Shell> boot -pxe
Para arrancar desde la opción de arranque de UEFI con el número 0004:
Shell> boot -n 0004
cd
Sintaxis
cd[path]
Descripción
Permite mostrar o modificar el directorio actual.
Opciones
ruta
Especifica la ruta del directorio relativa o absoluta.
Uso
Si se especifica una asignación de sistema de archivos, se cambiará el directorio de trabajo
actual para dicho dispositivo. En caso contrario, se cambiará el directorio de trabajo actual para
el dispositivo actual.
Si no se indica la ruta, el directorio de trabajo actual (incluida la asignación de sistema de
archivos) se mostrará como resultado estándar.
En la tabla siguiente se describen las convenciones que se utilizan para hacer referencia a un
directorio, a su directorio principal y al directorio raíz en el entorno de UEFI Shell.
Tabla 1 Convenciones de nombre de directorio
22
Convención
Descripción
.
Directorio actual.
. .
Directorio principal del directorio actual.
\
Directorio raíz del sistema de archivos actual.
Referencia de comandos de UEFI Shell
El directorio de trabajo actual se mantiene en la variable de entorno %cwd%.
Ejemplos
Para cambiar el sistema de archivos actual al sistema de archivos fs0 asignado:
Shell> fs0:
Para cambiar del directorio actual al subdirectorio efi:
fs0:\> cd efi
Para cambiar del directorio actual al directorio principal (fs0:\):
fs0:\efi\> cd ..
Para cambiar del directorio actual a fs0:\efi\tools:
fs0:\> cd efi\tools
Para cambiar del directorio actual a la raíz del sistema fs actual (fs0):
fs0:\efi\tools\> cd \
fs0:\>
NOTA:
No es posible cambiar de volumen con el comando cd. Por ejemplo:
fs0:\efi\tools\> cd fs1:\
En primer lugar escriba fs1: y, a continuación, utilice el comando cd para ir al directorio
que desee.
Para desplazarse entre volúmenes y mantener la ruta actual:
fs0:\> cd \efi\tools
fs0:\efi\tools\> fs1:
fs1:\> cd tmp
fs1:\tmp> cp fs0:*.* .
Este comando copia todos los archivos de fs0:\efi\tools en el directorio fs1:\tmp.
cls
Sintaxis
cls[color]
Descripción
Permite borrar el resultado estándar y cambiar el color de fondo.
Opciones
color
Especifica un nuevo color de fondo mediante las opciones siguientes:
0: negro
1: azul
2: verde
3: cian
4: rojo
5: magenta
6: amarillo
7: gris claro
Comandos de UEFI Shell
23
Uso
Si no se especifica el color, el color de fondo no cambiará.
Ejemplos
Para borrar la pantalla de resultados estándar sin cambiar el color de fondo:
fs0:\> cls
Para borrar la pantalla de resultados estándar y cambiar el color de fondo a cian:
fs0:\> cls 3
Para borrar la pantalla de resultados estándar y cambiar el color de fondo al color predeterminado:
fs0:\> cls 0
comp
Sintaxis
comp[-b] file1 file2
Descripción
Permite comparar el contenido de dos archivos byte por byte.
Opciones
-b
Muestra una pantalla a la vez.
archivo1
Especifica el nombre del primer archivo. No es posible especificar nombres de
directorio ni caracteres comodín.
archivo2
Especifica el nombre del segundo archivo. No es posible especificar nombres de
directorio ni caracteres comodín.
Uso
Este comando muestra hasta 10 diferencias entre los dos archivos. Para cada diferencia, se
volcarán hasta 32 bytes desde la ubicación en la que se inicia la diferencia. UEFI Shell se cerrará
de inmediato si las longitudes de los archivos comparados son distintas.
Ejemplos
Para comparar dos archivos con longitudes diferentes:
fs0:\> comp bios.inf legacy.inf
Compare fs0:\bios.inf to fs0:\legacy.inf
Difference #1: File sizes mismatch
[difference(s) encountered]
Para comparar dos archivos con el mismo contenido:
fs0:\> comp bios.inf rafter.inf
Compare fs0:\bios.inf to fs0:\rafter.inf
[no difference encountered]
Para comparar dos archivos con la misma longitud pero cuyo contenido es diferente:
fs0:\> comp bios.inf bios2.inf
Compare fs0:\bios.inf to fs0:\bios2.inf
Difference #1:
File1: fs0:\bios.inf
00000000: 5F
*_*
File2: fs0:\bios2.inf
00000000: 33
*3*
Difference #2:
File1: fs0:\bios.inf
0000000C: 00 00 00 00
*....*
24
Referencia de comandos de UEFI Shell
File2: fs0:\bios2.inf
0000000C: 25 32 03 03
*%2..*
[difference(s) encountered]
compress
Sintaxis
compress[-z][-s][-ex][-cl 0-9][-o output_file][file...][-sfo]
compress[-u][-s][-ex][-p password][-od output_directory][-i
input_file][-sfo]
Descripción
Comprime y descomprime archivos hacia y desde archivos zip mediante MiniZip, lo que
reduce los datos que se transfieren a través de la red.
Opciones
-z
Comprime los archivos especificados en un archivo zip.
-u
Descomprime los archivos que contiene el archivo zip de
entrada.
-s
Muestra información de modo silencioso, sin mensajes de
resultado.
-ex
Excluye la ruta del nombre de archivo al añadir archivos
o extraerlos desde el archivo zip.
-cl 0-9
Selecciona un nivel de compresión: 0 comprime con mayor
rapidez; 9 (valor predeterminado) comprime mejor.
-o archivo-de-resultado
Especifica un archivo resultante.
archivo...
Especifica uno o varios archivos para comprimirlos.
-p contraseña
Especifica una contraseña para el archivo zip.
-od directorio-de-resultado Especifica el directorio donde se van a extraer los archivos
desde el archivo zip.
-i archivo-de-entrada
Especifica un archivo de entrada.
-sfo
Muestra la información de los resultados en formato
estándar.
Uso
Este comando es útil para reducir la carga de la red. Le permite transferir varios archivos
comprimidos al mismo tiempo que mantiene un rendimiento óptimo. Si no se especifica un
nombre de archivo-de-resultado para la operación de compresión, se utiliza el nombre
del primer archivo o directorio (sin la extensión) como nombre de archivo zip resultante. No se
admite el cifrado mediante contraseña para la operación de compresión. Sí se admite el descifrado
de un archivo zip protegido mediante contraseña. Los archivos existentes se sobrescriben para
las operaciones de compresión y descompresión.
Ejemplos
Para ejecutar una operación de compresión normal:
fs0:\> compress -z a.txt b.txt c.txt
Para crear un archivo zip y proporcionar el nombre del archivo zip resultante:
fs0:\> compress -z -o archivozip.zip a.txt b.txt c.txt
Para crear un archivo zip con una lógica de compresión más rápida:
Comandos de UEFI Shell
25
fs0:\> compress -z -cl 0 -o archivozip.zip a.txt b.txt c.txt
Para ejecutar una operación de descompresión normal:
fs0:\> compress -u -i archivozip.zip
Para descomprimir los archivos a un directorio específico:
fs0:\> compress -u -od nuevodir -i archivozip.zip
Para descomprimir un archivo zip protegido mediante contraseña a un directorio específico:
fs0:\> compress -u -p contraseña -od nuevodir -i archivozip.zip
Para descomprimir todos los archivos de un archivo zip a un directorio raíz:
fs0:\> compress -u -ex -i archivozip.zip
connect
Sintaxis
connect[[devicehandle][driverhandle]|[-c]|[-r]]
Descripción
Enlaza un controlador a un dispositivo específico e inicia el controlador.
Opciones
identificador-dispositivo
Especifica un identificador de dispositivo en formato
hexadecimal.
identificador-controlador
Especifica un identificador de controlador en formato
hexadecimal.
-c
Conecta solo los dispositivos de consola que se describen
en las variables de entorno de UEFI Shell y los dispositivos
relacionados.
-r
Se conectan los dispositivos de consola de forma recursiva.
Uso
Si no se especifica un identificador-dispositivo, todos los identificadores de dispositivos
del sistema actual tendrán los valores predeterminados.
Si no se especifica identificador-controlador, todos los controladores no coincidentes
se enlazan con el dispositivo especificado. Si se especifica identificador-controlador,
se le da la prioridad más alta a la conexión de los dispositivos especificados. Si se especifica la
opción –r, se analizan de forma recursiva todos los identificadores para ver si algún controlador
cargado o integrado coincide con el dispositivo especificado. Asimismo, si se crean más
identificadores de dispositivos durante el enlace, estos también se comprueban para ver si se
puede enlazar un controlador coincidente a los dispositivos especificados. Este proceso se repite
hasta que no queden controladores que se puedan conectar a ningún dispositivo.
Si no se especifica la opción –r, los identificadores de dispositivos recién creados dejan de estar
enlazados a los controladores. Si solo se especifica un identificador único y este tiene un valor
EFI_DRIVER_BINDING_PROTOCOL, se asume que el identificador es un identificador de
controlador. En caso contrario, se da por sentado que se trata de un identificador de dispositivo.
Si no se especifican parámetros, el comando intentará enlazar todos los controladores
correspondientes a todos los dispositivos sin recursión y se muestra el estado de cada conexión.
No se admite el redireccionamiento de salida cuando se usa connect –r.
Ejemplos
Para conectar todos los controladores a todos los dispositivos de forma recursiva:
Shell> connect -r
26
Referencia de comandos de UEFI Shell
Para que se muestren todas las conexiones:
Shell> connect
Para conectar los controladores con 0x17 con la máxima prioridad a todos los dispositivos que
pueden gestionar:
Shell> connect 17
Para conectar todos los controladores posibles al dispositivo 0x19:
Shell> connect 19
Para conectar los controladores con 0x17 con la máxima prioridad al dispositivo 0x19:
Shell> connect 19 17
Para conectar los dispositivos de consola descritos en las variables de entorno de UEFI Shell:
Shell> connect -c
cp
Sintaxis
cp[-r][-q]src src...[dst]
Descripción
Permite copiar uno o varios archivos de origen o directorios en un destino.
Opciones
-r
Crea una copia de forma recursiva.
-q
Crea una copia de forma silenciosa (sin mostrar solicitudes de confirmación).
orig orig...
Especifica un archivo de origen o nombre de directorio. Este comando admite
el uso de caracteres comodín.
dest
Especifica un nombre de archivo o directorio de destino. Este comando no
admite el uso de caracteres comodín. Si no se especifica, se asumirá que
el directorio de trabajo actual es el de destino. Si se especifica más de un
directorio, se asumirá que el último directorio es el de destino.
Uso
Si el origen es un directorio, deberá especificar el indicador -r. Si se especifica el indicador -r,
el directorio de origen se copiará de forma recursiva al destino (lo que significa que se copiarán
todos los subdirectorios). Si no se especifica ningún destino, se asumirá que el destino es el
directorio de trabajo actual.
Si ya existe alguno de los archivos de destino (no un directorio), se mostrará un mensaje para
confirmar la sustitución de los archivos. Se encuentran disponibles las siguientes opciones:
•
Yes (Sí): sustituye el archivo.
•
No: no sustituye el archivo.
•
All (Todos): sustituye todos los archivos existentes que encuentre.
•
Cancel (Cancelar): no sustituye ninguno de los archivos existentes que encuentre.
Si hay varios archivos o directorios de origen, el destino debe ser un directorio.
Si se produce un error, el proceso de copia se detendrá de inmediato.
Si la ejecución se realiza en una secuencia de comandos, el valor predeterminado es –q.
El directorio debe existir al copiar en otro directorio.
Comandos de UEFI Shell
27
Ejemplos
Para mostrar el contenido del directorio actual:
fs0:\> ls
Directory of: fs0:\
06/18/01 01:02p <DIR> 512
06/18/01 01:02p <DIR> 512
test1
06/18/01 01:02p <DIR> 512
test2
06/13/01 10:00a 28,739
IsaBus.efi
06/13/01 10:00a 32,838
IsaSerial.efi
06/18/01 08:04p 29
temp.txt
06/18/01 08:05p <DIR> 512
test
3 File(s) 61,606 bytes
4 Dir(s)
efi
Para copiar un archivo en el mismo directorio con otro nombre:
fs0:\> cp temp.txt readme.txt
copying fs0:\temp.txt -> fs0:\readme.txt
- [ok]
Para copiar varios archivos en otro directorio:
fs0:\> cp temp.txt isaBus.efi \test
copying fs0:\temp.txt -> fs0:\test\temp.txt
- [ok]
copying fs0:\isaBus.efi -> fs0:\test\IsaBus.efi
- [ok]
Para copiar varios directorios de forma recursiva en otro directorio:
fs0:\> cp -r test1 test2 boot \test
copying fs0:\test1 -> fs0:\test\test1
copying fs0:\test1\test1.txt -> fs0:\test\test1\test1.txt
- [ok]
copying fs0:\test2 -> fs0:\test\test2
copying fs0:\test2\test2.txt -> fs0:\test\test2\test2.txt
- [ok]
copying fs0:\boot -> fs0:\test\boot
copying fs0:\boot\shell.efi -> fs0:\test\boot\shell.efi
- [ok]
Para ver los resultados de las operaciones anteriores:
fs0:\> ls \test
Directory of: fs0:\test 06/18/01 01:01p <DIR>
06/18/01 01:01p <DIR>
0
..
01/28/01 08:21p <DIR>
512
test1
01/28/01 08:21p <DIR>
512
test2
01/28/01 08:21p <DIR>
512
boot
01/28/01 08:23p
29
temp.txt
01/28/01 08:23p
28,739
IsaBus.efi
2 File(s)
28,828 bytes
5 Dir(s)
Shell>
512
date
Sintaxis
date[mm/dd{yy|yyyy}][-sfo]
Descripción
Permite mostrar o establecer la fecha actual del sistema.
Opciones
mm
28
Especifica el mes de la fecha que se va a establecer (1-12).
Referencia de comandos de UEFI Shell
.
dd
Especifica el día de la fecha que se va a establecer (1-31).
aa
Especifica el año de la fecha con dos dígitos.
aaaa
Especifica el año de la fecha con cuatro dígitos.
-sfo
Especifica que los resultados se muestren en formato estándar.
Uso
Si no se especifican parámetros, se muestra la fecha actual. La fecha del sistema se actualizará
si se especifican valores válidos de día, mes y año. Las reglas son las siguientes:
•
A excepción de los caracteres numéricos y de la barra (/), todos los demás caracteres del
argumento no son válidos. El shell mostrará un error si el número se encuentra en el rango
incorrecto de mes/día/año.
•
No se pueden usar espacios antes o después del carácter numérico. No es posible insertar
espacios en el número.
•
El intervalo de años es mayor o igual a 1998. Dos caracteres numéricos indican el año. Los
números menores que 98 se considerarán como 20xx y los números iguales o mayores
que 98 se considerarán como 19xx. 00 equivale a 2000. Por ejemplo:
Shell> date 8/4/97
Shell> date
8/04/2097
Shell>
Shell> date 8/4/98
Shell> date
08/04/1998
Shell>
El intervalo de años válidos es de 1998 a 2099.
Ejemplos
Para mostrar la fecha actual en el sistema:
fs0:\> date
06/18/2001
Para establecer la fecha con formato largo de año y mostrarla:
fs0:\> date 01/01/2050
fs0:\> date
01/01/2050
Para establecer la fecha con formato corto de año y mostrarla:
fs0:\> date 06/18/01
fs0:\> date
06/18/2001
dblk
Sintaxis
dblk device[lba][blocks][-b]
Descripción
Permite mostrar uno o varios bloques desde un dispositivo de bloques.
Opciones
-b
Permite mostrar una pantalla a la vez.
dispositivo
Nombre del dispositivo de bloques.
Comandos de UEFI Shell
29
lba
Índice del primer bloque que se debe mostrar (número hexadecimal).
bloques
Número de bloques que se deben mostrar (número hexadecimal). El valor
predeterminado es 1. Si es mayor que 0x10, se mostrarán solo 0x10.
Ejemplos
Para mostrar un bloque de blk0 que comience desde el bloque 0:
fs0:\> dblk blk0
Para mostrar un bloque de fs0 que comience desde 0x2:
fs0:\> dblk fs0 2
Para mostrar 0x5 bloques de fs0, comenzando por el bloque 0x12:
fs0:\> dblk fs0 12 5
devices
Sintaxis
devices[-b][-lxxx][-sfo]
Descripción
Permite mostrar una lista de dispositivos gestionados mediante los controladores de UEFI.
Opciones
-b
Muestra una pantalla a la vez.
-lxxx
Muestra los dispositivos en un idioma específico. Para obtener una lista de las opciones
de código posibles, consulte la Especificación de UEFI.
-sfo
Muestra la información de los resultados en formato estándar.
Ejemplo
Para mostrar todos los dispositivos compatibles con el modelo de controlador de EFI:
Shell>
C
T
T
Y
R
P
L
E
== =
20 R
3D D
3E D
64 B
65 B
66 B
67 B
68 B
69 D
6E D
6F D
70 D
71 D
72 D
devices
D
C I
F A
G G #P
= = ==
- - - - 3
- - 3
- - 1
- - 1
- - 1
- - 1
- - 1
- - 1
- - 1
- - 1
- - 1
- - 1
- - 1
#D
==
1
6
6
1
1
4
-
#C
==
13
2
2
1
1
2
-
Device Name
=============================================================
VenHw(58C518B1-76F3-11D4-BCEA-0080C73C8881)
Primary Console Input Device
Primary Console Output Device
UGA Window 1
UGA Window 2"
EFI_WIN_NT_SERIAL_PORT=COM1
COM1
PC-ANSI Serial Console
EFI_WIN_NT_SERIAL_PORT=COM2
EFI_WIN_NT_PHYSICAL_DISKS=e:RW;262144;512
EFI_WIN_NT_CPU_MODEL=Intel(R) Processor Model
EFI_WIN_NT_CPU_SPEED=3000
EFI_MEMORY_SIZE=64
EFI_MEMORY_SIZE=64
Detalles de los resultados
En la tabla siguiente se describen los resultados que puede producir este comando.
30
Referencia de comandos de UEFI Shell
Tabla 2 Detalles de los resultados del comando devices
Columna
Descripción
CTRL
Número de identificador del dispositivo.
TYPE
Tipo de dispositivo. Las opciones disponibles son las siguientes:
• R: controladora raíz
• B: controladora de bus
• D: controladora de dispositivo
CFG
Estado de soporte del protocolo de configuración:
• Y: sí
• N: no
DIAG
Estado de soporte del protocolo de diagnóstico:
• Y: sí
• N: no
#P
Número de controladoras principales de este dispositivo.
#D
Número de dispositivos de este tipo.
#C
Número de controladoras secundarias generadas por este dispositivo.
Device Name
Nombre del dispositivo según el protocolo de nombres de componentes.
devtree
Sintaxis
devtree[-b][-d][-lxxx][devicehandle]
Descripción
Permite mostrar el árbol de dispositivos compatibles con el modelo del controlador de UEFI.
Opciones
-b
Muestra una pantalla a la vez.
-d
Muestra el árbol de dispositivos con las rutas de
dispositivo.
-lxxx
Muestra el árbol de dispositivos en un idioma específico.
Para obtener una lista de las opciones de código posibles,
consulte la Especificación de UEFI.
identificador-de-dispositivo Muestra el árbol de dispositivos pertenecientes a un
identificador especificado.
Uso
De forma predeterminada, los nombres de dispositivo se recuperan del protocolo de nombres
de componentes. Si se especifica la opción –d, en su lugar se muestran las rutas de los
dispositivos.
Ejemplo
Para mostrar el árbol de todos los dispositivos compatibles con el modelo de controlador de
UEFI en una pantalla a la vez:
Shell> devtree -b
devtree -b fs0:\
Comandos de UEFI Shell
31
Ctrl[04] Fv(770BF9B6-8AFE-4F4C-85E5-893FC3D2606C)
Ctrl[05] Fv(27A72E80-3118-4C0C-8673-AA5B4EFA9613)-directories in the current
Ctrl[06] MemoryMapped(0xB,0xFFD40000,0xFFD6FFFF)
Ctrl[07] Fv(5A515240-D1F1-4C58-9590-27B1F0E86827)
Ctrl[08] Fv(5E2363B4-3E9E-4203-B873-BB40DF46C8E6)
Ctrl[09] Fv(CDBB7B35-6833-4ED6-9AB2-57D2ACDDF6F0)extension '.efi':
Ctrl[5F] PciRoot(0x0).efi
Ctrl[195] PciRoot(0x0)/Pci(0x0,0x0)
Ctrl[196] PciRoot(0x0)/Pci(0x2,0x0)from all files with extension '.inf':
Ctrl[197] PciRoot(0x0)/Pci(0x2,0x0)/Pci(0x0,0x0)
Ctrl[198] PciRoot(0x0)/Pci(0x2,0x1)
Ctrl[199] PciRoot(0x0)/Pci(0x2,0x2)
Ctrl[19A] PciRoot(0x0)/Pci(0x2,0x3)
Ctrl[19B] PciRoot(0x0)/Pci(0x3,0x0)
Ctrl[19C] PciRoot(0x0)/Pci(0x3,0x1)
Ctrl[19D] PciRoot(0x0)/Pci(0x3,0x2)
Ctrl[19E] PciRoot(0x0)/Pci(0x3,0x3)
Ctrl[19F] PciRoot(0x0)/Pci(0x4,0x0)
Ctrl[1A0] PciRoot(0x0)/Pci(0x4,0x1)
Ctrl[1A1] PciRoot(0x0)/Pci(0x4,0x2)
Ctrl[1A2] PciRoot(0x0)/Pci(0x4,0x3)
Ctrl[1A3] PciRoot(0x0)/Pci(0x4,0x4)
Ctrl[1A4] PciRoot(0x0)/Pci(0x4,0x5)
Ctrl[1A5] PciRoot(0x0)/Pci(0x4,0x6)
Ctrl[1A6] PciRoot(0x0)/Pci(0x4,0x7)
Ctrl[1A7] PciRoot(0x0)/Pci(0x5,0x0)
Ctrl[1A8] PciRoot(0x0)/Pci(0x5,0x1)
Ctrl[1A9] PciRoot(0x0)/Pci(0x5,0x2)
Ctrl[1AA] PciRoot(0x0)/Pci(0x5,0x4)
Ctrl[1AB] PciRoot(0x0)/Pci(0x6,0x7)
Press ENTER to continue or 'Q' break:
dh
Sintaxis
dh[-lxxx][handle|-p prot_id][-d][-b][-v][-sfo]
Descripción
Muestra los identificadores de dispositivos del entorno UEFI.
Opciones
-lxxx
Muestra los identificadores de los dispositivos en un idioma específico. Para
obtener una lista de las opciones de código posibles, consulte la Especificación
de UEFI.
handle
Muestra el identificador de un dispositivo específico.
-p id-prot
Muestra la información del protocolo asociada a los identificadores. Si no se
especifica, se mostrarán todos los protocolos.
-d
Muestra la información relacionada con el modelo del controlador de UEFI.
-b
Muestra una pantalla a la vez.
-v
Muestra información detallada.
-sfo
Muestra la información de los resultados en formato estándar. Consulte Tabla 5
(página 46).
Uso
Si se especifica un número de identificador, se mostrarán los detalles de todos los protocolos
asociados a dicho identificador de dispositivo. En caso contrario, es posible utilizar la opción
-p para mostrar una lista de los identificadores de dispositivos que contengan un protocolo
específico. Si no se especifica la opción -p id-prot ni identificador, se mostrarán todos
los identificadores.
32
Referencia de comandos de UEFI Shell
Ejemplos
Para mostrar todos los identificadores en una sola pantalla:
Shell> dh -b
Handle dump
1: Image(DXE Core)
2: FwVol FwFileSys FwVolBlk DevPath(MemMap(11:1B500001D4FFC8))
3: Image(Ebc)
4: DevPath(MemMap(11:1CA0000-1CB0000))
5: Image(WinNtThunk)
6: WinNtThunk DevPath(..76F3-11D4-BCEA-0080C73C8881))
7: Image(WinNtBusDriver) DriverBinding
...
Para mostrar información detallada del identificador 0x30:
Shell> dh 30 -v
Handle 30 (01AF5308)
IsaIo
ROM Size......: 00000000
ROM Location..: 00000000
ISA Resource List :
IO : 000003F8-000003FF Attr : 00000000
INT : 00000004-00000000 Attr : 00000000
dpath
PNP Device Path for PnP
HID A0341D0, UID 0x0
Hardware Device Path for PCI
PNP Device Path for PnP
HID 50141D0, UID 0
AsStr: 'Acpi(PNP0A03,0)/Pci(1F|0)/Acpi(PNP0501,0)'
Para mostrar todos los identificadores asociados al protocolo diskio:
Shell> dh -p diskio
Handle dump by protocol 'Diskio'
15: DiskIo BlkIo DevPath(..i(3|1)/Ata(Secondary,Master))
16: DiskIo BlkIo DevPath(..,1)/PCI(0|0)/Scsi(Pun0,Lun0))
44: DiskIo BlkIo Fs DevPath(..ABD0-01C0-507B-9E5F8078F531)
ESP
45: DiskIo BlkIo Fs DevPath(..i(Pun0,Lun0)/HD(Part4,SigG0))
ESP
17: DiskIo BlkIo DevPath(..PCI(3|1)/Ata(Primary,Master))
Para mostrar todos los identificadores asociados al protocolo Image e insertar un salto cuando
la pantalla esté completa:
Shell> dh -p Image -b
Handle dump by protocol 'image'
1: Image(DXE Core)
5: Image(WinNtThunk)
7: Image(WinNtBusDriver) DriverBinding
8: Image(Metronome)
A: Image(IsaBus) DriverBinding
B: Image(WinNtConsole) DriverBinding
...
Detalles de los resultados
En la tabla siguiente se describen los resultados que puede producir este comando.
Comandos de UEFI Shell
33
Tabla 3 Detalles de los resultados del comando dh
Columna
Descripción
Driver Name
Nombre del controlador que genera el identificador.
Controller Name
Nombre de la controladora que genera el identificador.
Handle number
Número entero del identificador.
Device Path
Ruta del dispositivo asociado al identificador.
Protocol Identifiers
Lista de los identificadores de protocolo o GUID separada por signos de punto y
coma.
disconnect
Sintaxis
disconnect devicehandle [driverhandle][childhandle]][-r]
Descripción
Desconecta uno o más controladores de los dispositivos especificados.
Opciones
identificador-dispositivo
Especifica un identificador de dispositivo en formato
hexadecimal.
identificador-controlador
Especifica un identificador de controlador en formato
hexadecimal. Si no se especifica, el dispositivo
especificado por identificador-dispositivo se
desconecta.
identificador-secundario
Especifica un identificador secundario de un dispositivo
en formato hexadecimal. Si no se especifica, todos los
identificadores secundarios del dispositivo especificado
por identificador-dispositivo se desconectan.
-r
Desconecta todos los controladores de todos los
dispositivos.
Uso
Este comando no admite el redireccionamiento del resultado.
Ejemplos
Para desconectar todos los controladores de todos los dispositivos:
Shell> disconnect -r
Para desconectar todos los controladores del dispositivo 0x28:
Shell> disconnect 28
Para desconectar el controlador 0x17 del dispositivo 0x28:
Shell> disconnect 28 17
Para desconectar el controlador 0x17 del identificador secundario 0x32 del dispositivo 0x28:
Shell> disconnect 28 17 32
34
Referencia de comandos de UEFI Shell
dmem
Sintaxis
dmem[-b][address][size][-MMIO]
Descripción
Permite mostrar el contenido de la memoria del dispositivo o sistema.
Opciones
-b
Muestra una pantalla a la vez.
dirección
Muestra el contenido de la memoria desde una dirección de inicio específica (en
formato hexadecimal).
tamaño
Muestra la cantidad de bytes especificada del contenido de la memoria (en
formato hexadecimal).
-MMIO
Muestra el contenido asignado de la memoria mediante
EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
Uso
Si no se especifica la opción dirección, se mostrará el contenido de la tabla del sistema EFI.
De lo contrario, se mostrará el contenido de la memoria a partir de la dirección especificada.
Si no se especifica la opción tamaño, se mostrarán 512 bytes (el valor predeterminado). Si no
se especifica la opción -MMIO, se mostrará el contenido de la memoria del sistema principal.
De lo contrario, se mostrará el contenido de la memoria del dispositivo mediante
EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
Ejemplo
Para mostrar el contenido de la memoria desde 1af3088 con un tamaño de 16 bytes:
Shell> dmem 1af3088 16
Memory Address 0000000001AF3088 16 Bytes
01AF3088: 49 42 49 20 53 59 53 54-00 00 02 00 18 00 00 00 *IBI SYST........*
01AF3098: FF 9E D7 9B 00 00
*......*
drivers
Sintaxis
drivers[-lxxx][-sfo]
Descripción
Muestra una lista de información de los controladores que siguen el modelo de controlador de
UEFI.
Opciones
-lxxx
Muestra los controladores en un idioma específico. Para obtener una lista de las
opciones de código posibles, consulte la Especificación de UEFI.
-sfo
Muestra el contenido en una tabla de resultados en formato estándar. Consulte Tabla 4
(página 36).
Uso
Para obtener una descripción de los elementos mostrados, consulte la Tabla 4 (página 36).
Comandos de UEFI Shell
35
Ejemplo
Para mostrar la lista de controladores:
Shell> drivers
T
D
Y C
R
P F
V
VERSION E G
=== ======= = =
39 00000010 D 3A 00000010 D 3B 00000010 B 3C 00000010 ? 3D 00000010 B 3E 00000010 ? 42 00000010 D 43 00000010 ? 44 00000010 D 45 00000010 D 48 00000010 ? 49 00000010 ? 4C 00000010 B 55 00000010 D X
56 00000010 ? 57 00000010 ? 58 00000010 D 59 00000010 B 5F 00000010 D -
D
I
A
G
=
X
-
#D
==
1
1
1
1
1
1
1
1
1
1
1
1
#C
==
1
1
1
3
-
DRIVER NAME
=====================================
Platform Console Management Driver
Platform Console Management Driver
Console Splitter Driver
Console Splitter Driver
Console Splitter Driver
Console Splitter Driver
UGA Console Driver
Serial Terminal Driver
Generic Disk I/O Driver
FAT File System Driver
ISA Bus Driver
ISA Serial Driver
PCI Bus Driver
Windows Block I/O Driver
Windows Text Console Driver
Windows Serial I/O Driver
Windows Simple File System Driver
Windows Bus Driver
Windows Universal Graphics Adapter
IMAGE NAME
==========
ConPlatform
ConPlatform
ConSplitter
ConSplitter
ConSplitter
ConSplitter
GraphicsConsole
Terminal
DiskIo
Fat
IsaBus
IsaSerial
PciBus
WinNtBlockIo
WinNtConsole
WinNtSerialIo
WinNtSimpleFileSystem
WinNtBusDriver
WinNtUga
Detalles de los resultados
En la tabla siguiente se describen los resultados que puede producir este comando.
Tabla 4 Detalles de los resultados del comando drivers
Columna
Descripción
DRV
Identificador entero del controlador.
VERSION
Número de versión del controlador.
TYPE
Tipo de controlador. Los valores posibles son:
• B: controlador de bus
• D: controlador de dispositivo
CFG
Estado de soporte del protocolo de configuración:
• Y: sí
• N: no
DIAG
Estado de soporte del protocolo de controlador:
• Y: sí
• N: no
#D
Número de dispositivos que gestiona este controlador.
#C
Número de dispositivos secundarios que produjo este controlador.
DRIVER NAME
Nombre del controlador según el protocolo de nombres de componentes.
IMAGE NAME
Ruta de dispositivo desde la que se cargó el controlador.
echo
Sintaxis
echo[-on|-off]
36
Referencia de comandos de UEFI Shell
echo message
Descripción
Permite controlar si se muestran los comandos de las secuencias de comandos conforme se
van leyendo del archivo de la secuencia de comandos y muestra el mensaje especificado en la
pantalla.
Opciones
-on
Habilita la visualización al leer los comandos de los archivos de secuencias de
comandos.
-off
Deshabilita la visualización al leer los comandos de los archivos de secuencias de
comandos.
mensaje
Especifica el mensaje que se debe mostrar.
Uso
La primera forma de este comando controla si se muestran los comandos de las secuencias de
comandos conforme se leen de los archivos de secuencias de comandos. Si no se especifica
ningún argumento, se mostrará el estado actual on u off. La segunda forma del comando
imprime el mensaje especificado en la pantalla.
Este comando no modifica el valor de la variable de entorno lasterror.
Ejemplos
Para mostrar la cadena de mensaje Hello World:
fs0:\> echo Hello World
Hello World
Para activar el eco de los comandos:
fs0:\> echo -on
Para ejecutar el archivo HelloWorld.nsh y mostrar el contenido conforme se leen las líneas
del archivo de secuencia de comandos:
fs0:\> HelloWorld.nsh
+HelloWorld.nsh> echo Hello World
Hello World
Para desactivar el eco de los comandos:
fs0:\> echo -off
Para mostrar la configuración actual de eco:
fs0:\> echo
Echo is off
edit
Sintaxis
edit[file]
Descripción
Permite editar un archivo ASCII o UCS-2 en modo de pantalla completa.
Opciones
archivo
Especifica el nombre del archivo que se va a editar. Si no se especifica ninguno,
se creará un archivo vacío con un nombre de archivo predeterminado.
Comandos de UEFI Shell
37
Uso
Este comando admite los tipos de archivo UCS-2 y ASCII.
Ejemplo
Para editar el archivo shell.log:
fs0:\> edit shell.log
eficompress
Sintaxis
eficompress archivo-de-entrada archivo-resultante
Descripción
Comprime un archivo mediante el algoritmo de compresión EFI y escribe el formato comprimido
en un archivo nuevo.
Opciones
archivo-de-entrada
Especifica el nombre de archivo de entrada sin comprimir.
archivo-resultante
Especifica el nombre de archivo comprimido resultante.
Ejemplo
Para comprimir un archivo denominado sincomprimir a un archivo denominado comprimido:
fs0:\> eficompress sincomprimir comprimido
efidecompress
Sintaxis
efidecompress archivo-de-entrada archivo-resultante
Descripción
Descomprime un archivo mediante el algoritmo de descompresión EFI y escribe el formato
descomprimido en un archivo nuevo.
Opciones
archivo-de-entrada
Especifica el nombre del archivo de entrada comprimido.
archivo-resultante
Especifica el nombre del archivo resultante sin comprimir.
Ejemplo
Para descomprimir un archivo denominado comprimido a un archivo denominado
sincomprimir:
fs0:\> eficompress comprimido sincomprimir
exit
Sintaxis
exit[/b][exit-code]
Descripción
Permite salir de UEFI Shell o de la secuencia de comandos actual.
38
Referencia de comandos de UEFI Shell
Opciones
/b
Indica que solo debe finalizar la secuencia de comandos de UEFI Shell actual.
Esta opción se ignorará si no se utiliza en una secuencia de comandos.
exit-code
Si se va a salir de una secuencia de comandos de UEFI Shell, especifica el valor
que se asigna a la variable de entorno lasterror. Si se va a salir de una
instancia de UEFI Shell, especifica el valor devuelto al comando que hizo la
llamada. Si no se especifica, devuelve el valor 0.
Ejemplo
Para salir de UEFI Shell:
fs0:\> exit
ftp
Sintaxis
ftp host[port][-b]
Descripción
Se conecta con servidores FTP para realizar transferencias de archivos por la red.
Opciones
host
Especifica el nombre de host o la dirección IPv4 de un servidor.
puerto
Especifica el puerto FTP del servidor.
-b
Permite los saltos de página para los subcomandos.
Uso
Este comando inicia un shell interactivo para realizar operaciones de transferencia de archivos
por la red (FTP). Solamente se admiten direcciones IPv4. Pulse ESC o Ctrl-C para cancelar una
transferencia de archivos.
IMPORTANTE: No es necesario utilizar ifconfig en una interfaz de red si va a ejecutar
webclient o ftp sobre la misma interfaz debido a que la configuración de la dirección IP y de
la interfaz se selecciona automáticamente mediante la opción Pre-Boot Network Settings
(Configuración de red previa al arranque) que se configura en las utilidades del sistema.
Si la interfaz utilizada por ftp y webclient se ha configurado mediante ifconfig, dicha
configuración se borra y, en su lugar, cuando se ejecutan los comandos, se aplica a la interfaz
el menú Pre-Boot Network Settings (Configuración de red previa al arranque) de las utilidades
del sistema.
Ejemplos
Para conectar con un servidor FTP en una dirección IP determinada:
fs0:\> ftp 192.168.1.20
Para conectar con un servidor FTP usando un nombre de host:
fs0:\> ftp ftp.hpe.com
Para conectar con un servidor FTP utilizando una dirección IP, el nombre de usuario usuario
y la contraseña contr:
fs0:\> ftp 192.168.1.20
User (192.168.1.20):usuario
Password:contr
Login successful.
Comandos de UEFI Shell
39
Para conectar con un servidor FTP en una dirección IP específica y activar los saltos de página
para los subcomandos:
fs0:\> ftp 192.168.1.20 -b
fwupdate
Sintaxis
fwupdate -l[-sfo]
fwupdate -d device[i image]-f file[-q]
Descripción
Actualiza componentes de firmware, incluidos el BIOS del sistema, las NIC y las tarjetas
de almacenamiento.
Además del comando fwupdate, la opción Firmware Update (Actualización del firmware)
de las utilidades del sistema y la utilidad FWUPDATE, para actualizar el firmware del sistema
también existen las imágenes de los componentes Online Flash para los sistemas operativos
Windows, Linux y VMware.
Este comando comprueba el sistema y ofrece una serie de revisiones de firmware disponibles
(si existe más de una).
Opciones
—l
Muestra una lista de los dispositivos con capacidad de actualización de
firmware y sus revisiones.
-d dispositivo
Especifica un nombre de dispositivo.
—i imagen
Especifica la imagen que se va a actualizar.
-f archivo
Especifica un archivo de imagen de firmware que se va a actualizar.
-q
Muestra la información en modo silencioso, omitiendo todas las
confirmaciones.
-sfo
Muestra la información de los resultados en formato estándar.
Uso
Algunos dispositivos tienen más de una imagen de firmware. Por ejemplo, un adaptador de red
puede tener imágenes de firmware para código de arranque PXE y para firmware NCSI. En esos
casos, puede actualizar las imágenes por separado.
Ejemplos
Para que se muestren los dispositivos y sus revisiones de firmware:
fs0:\> fwupdate -l
* [BIOS] System ROM - P92 v1.00 (05/09/2014)
* [NIC.LOM.1.5] Embedded LOM 1 : HPE Ethernet 1Gb 4-port 331i Adapter - NIC
1. BOOT CODE - 5719-v1.38
2. MBA - 16.6.0\
3. ASF - N/A
4. NCSI - 1.2.43
5. UMP - N/A
6. VPD - N/A
7. CCM - 7.10.31
Para actualizar el firmware del BIOS del sistema:
fs0:\> fwupdate -d BIOS -f P92_1.00_03_22_2014.signed.full
40
Referencia de comandos de UEFI Shell
getmtc
Sintaxis
getmtc
Descripción
Obtiene el valor de MTC (contador monótono) de Boot Services y lo muestra.
Uso
Este comando muestra el valor actual del contador monotónico. El valor de 32 bits inferior
aumenta cada vez que se ejecuta este comando. Cada vez que se reinicia el sistema, aumenta
el valor superior de 32 bits y se restablece a 0 el valor inferior de 32 bits.
goto
Sintaxis
goto etiqueta
Descripción
Permite ir a una etiqueta de una secuencia de comandos.
help
Sintaxis
help[cmd|pattern|special][-usage][-v][-section sectionname][-b]
Descripción
Muestra la lista de comandos integrados en UEFI Shell.
Opciones
cmd
Especifica el comando para que se va a mostrar la ayuda.
patrón
Especifica el patrón que se va a utilizar para mostrar ayuda
sobre los comandos.
special
Muestra una lista de los caracteres especiales utilizados
en la línea de comandos del shell.
-usage
Muestra información relacionada con el uso del comando.
El resultado obtenido es el mismo que si se especifica
–section:NAME y –section:SYNOPSIS.
-v
Muestra información detallada.
-section nombre-de-sección Muestra la sección especificada de la información de
ayuda.
-b
Muestra el resultado de la ayuda en una única pantalla.
Uso
Si no se especifica ninguna opción, los comandos se mostrarán con una breve descripción de
su función. Si se especifica la opción –v, se mostrará toda la información de ayuda del comando
especificado. Si se especifica la opción –section, solo se mostrará la sección de ayuda
especificada (véase más adelante). Si se especifica la opción –usage, se mostrarán el comando,
una descripción breve e información sobre el uso del comando.
Comandos de UEFI Shell
41
El texto de ayuda se toma de los archivos de texto UCS-2 que se encuentran en el directorio en
el que se encuentra el shell o el archivo ejecutable del comando del shell. Los archivos tienen
el nombre nombre-del-comando.man donde nombre-del-comando representa el nombre
del comando del shell. Los archivos siguen un subconjunto del formato de página MAN, tal como
se describe a continuación.
Si no se especifica ninguna opción, solo se mostrará la sección NAME de la página.
Ejemplos
Para mostrar la lista de comandos de UEFI Shell e insertar un salto de página tras una pantalla:
Shell> help –b
alias
attrib
cd
cls
comp
-
Displays, creates, or deletes UEFI Shell aliases.
Displays or changes the attributes of files or directories.
Displays or changes the current directory.
Clears standard output and optionally changes background color.
Compares the contents of two files on a byte for byte basis.
Para mostrar información de ayuda sobre el comando del shell ls (puede utilizar cualquiera de
las siguientes opciones de sintaxis):
Shell> help ls
Shell> ? ls
Shell> ls -?
Para mostrar la lista de comandos que comiencen por el carácter p:
Shell> help p*
pause – Prints a message and suspends for keyboard input
ifconfig
Sintaxis
ifconfig[-c [name]][-l[name]]
ifconfig[-s name dhcp|[static IPaddress mask gateway]|permanent]
Descripción
Modifica la dirección IP predeterminada de la pila de red UEFI IPv4.
Opciones
42
-c
Borra la configuración.
-l
Muestra la configuración.
-s
Establece la configuración.
nombre
Especifica un nombre de adaptador. Por ejemplo, eth0.
dhcp
Especifica que DHCP4 solicitará dinámicamente direcciones
IPv4 para todas las interfaces o para una específica.
static dirección-IP
Especifica una dirección IPv4 estática en valores de cuatro
enteros, entre 0 y 255, separados por puntos.
máscara
Especifica una máscara de subred en valores de cuatro enteros,
entre 0 y 255, separados por puntos.
puerta-enlace
Especifica una puerta de enlace en valores de cuatro enteros,
entre 0 y 255, separados por puntos.
permanent
Especifica que la configuración es permanente (no se utiliza solo
una vez).
Referencia de comandos de UEFI Shell
Uso
IMPORTANTE: No es necesario utilizar ifconfig en una interfaz de red si va a ejecutar
webclient o ftp sobre la misma interfaz debido a que la configuración de la dirección IP y de
la interfaz se selecciona automáticamente mediante la opción Pre-Boot Network Settings
(Configuración de red previa al arranque) que se configura en las utilidades del sistema.
Si la interfaz utilizada por ftp y webclient se ha configurado mediante ifconfig, dicha
configuración se borra y, en su lugar, cuando se ejecutan los comandos, se aplica a la interfaz
el menú Pre-Boot Network Settings (Configuración de red previa al arranque) de las utilidades
del sistema.
Puede utilizar este comando para configurar redes host para el acceso de red previo al arranque
desde el shell. La opción –c borra la configuración de todas las interfaces o de una interfaz
especificada, lo que hace que la pila de red de las interfaces relacionadas recupere el valor
predeterminado, DHCP. Si no se especifica la opción permanent, la configuración será efectiva
solo una vez. Si se especifica la opción permanent, la configuración continuará siendo efectiva
cuando se vuelva a cargar la pila de red.
Ejemplos
Para obtener una lista de la configuración de la interfaz eth0:
fso:\>ifconfig -l eth0
Para utilizar DHCP4 para que solicite dinámicamente la configuración de la dirección IPv4 para
la interfaz eth0:
fso:\>ifconfig -s eth0 dhcp
Para utilizar la configuración de la dirección IPv4 estática para la interfaz eth0 y para definir
esta configuración de forma que persista al volver a cargar una red:
fso:\>ifconfig -s eth0 static 192.168.0.5 255.255.255.0 192.168.0.1 permanent
imlview
Sintaxis
imlview[-export filename][-sfo][-b][-c]
Descripción
Muestra y exporta el registro de gestión integrado (IML).
Opciones
-sfo
Muestra la información de los resultados en formato
estándar.
-b
Muestra las páginas del registro IML de una en una.
-c
Borra las entradas del registro IML.
-export nombre-de-archivo
Exporta el registro IML a un archivo especificado.
Uso
El registro de gestión integrado (IML) es un registro de eventos históricos que han tenido lugar
en el servidor. Las entradas del IML pueden ayudar al usuario a diagnosticar problemas o a
identificar posibles problemas.
Ejemplos
Para cambiar el sistema de archivos actual al sistema de archivos FS0 asignado:
Comandos de UEFI Shell
43
Shell> fs0:
Para mostrar el registro IML actual:
FS0:\>imlview
Para exportar el registro IML a un archivo llamado output.txt:
FS0:\>imlview -export output.txt
load
Sintaxis
load[-nc]file[file...]
Descripción
Carga un controlador UEFI en la memoria.
Opciones
-nc
Carga el controlador, pero no lo conecta.
archivo
Especifica el archivo de imagen que contiene el controlador UEFI que se va a cargar.
Este comando admite el uso de caracteres comodín.
Uso
Puede utilizar este comando para cargar varios archivos a la vez y utilizar caracteres comodín
para especificarlos. Si no se especifica -nc, el sistema intenta conectar el controlador a un
dispositivo adecuado. También puede hacer que los controladores cargados previamente se
conecten a los dispositivos correspondientes.
Ejemplos
Para cargar el controlador del archivo Isabus.efi:
FS0:\>load Isabus.efi
Para cargar los controladores de los archivos Isabus.efi y IsaSerial.efi:
FS0:\>load Isabus.efi IsaSerial.efi
Para cargar los controladores incluidos en varios archivos cuyo nombre contiene los caracteres
Isa:
FS0:\>load Isa*.efi
Para cargar el controlador del archivo Isabus.efi sin conectar:
FS0:\>load -nc Isabus.efi
ls/dir
Sintaxis
ls[-r][-a[attrib]][-sfo][file]
Descripción
Muestra el contenido de un directorio o la información de un archivo. El comando dir es un
alias interno de este comando.
Opciones
44
-r
Muestra el contenido de forma recursiva (incluidos los subdirectorios).
-a atrib
Muestra solo los archivos con los atributos especificados. Si no se especifica
ningún atributo, se mostrarán todos los archivos. Si no se especifica la opción –a,
Referencia de comandos de UEFI Shell
se mostrarán todos los archivos no ocultos y que no sean del sistema. Los atributos
(atrib) pueden ser uno o varios de los siguientes:
•
a: archivo
•
s: sistema
•
h: oculto
•
r: solo lectura
•
d: directorio
-sfo
Muestra los resultados en formato estándar. Consulte también Detalles de los
resultados del comando ls (información del volumen) y Detalles de los resultados
del comando ls (información de archivo).
archivo
Especifica el nombre de un archivo o directorio. Este comando admite el uso de
caracteres comodín.
Uso
Si no se especifica ningún nombre de archivo o de directorio, se tomará el directorio de trabajo
actual. El contenido de un directorio se mostrará si se cumplen todas las condiciones siguientes:
•
No se especifica la opción -r.
•
No se usan caracteres comodín en el parámetro archivo.
•
El valor del parámetro archivo especificado representa un directorio existente.
En todos los demás casos, el comando funcionará del modo siguiente:
◦
Se mostrarán todos los archivos o directorios cuyos nombres coincidan con el nombre
especificado.
◦
El indicador -r determina si se realizará una búsqueda recursiva.
◦
El indicador -a atrib muestra solo los archivos que tengan los atributos especificados.
Si se especifica más de un atributo, solo se mostrarán los archivos que tengan dichos
atributos. Si la opción -a no va seguida de ningún valor, se mostrarán todos los archivos
o directorios, sin tener en cuenta sus atributos. Si no se especifica la opción -a, se
mostrarán todos los archivos, salvo los archivos ocultos y del sistema.
Ejemplos
Para ocultar archivos añadiendo el atributo de archivo oculto o de sistema:
fs0:\> attrib +s +h *.efi
ASH fs0:\IsaBus.efi
ASH fs0:\IsaSerial.efi
Para mostrar todos los archivos y directorios, excepto los que tienen el atributo h o s:
fs0:\> ls
Directory of: fs0:\
06/18/01
09:32p
06/18/01
01:02p
06/18/01
01:02p
06/18/01
01:02p
06/18/01
08:04p
06/18/01
08:05p
01/28/01
08:24p
3 File(s)
4 Dir(s)
153 for.nsh
512 efi
512 test1
512 test2
29 temp.txt
<DIR>
512 test
r
29 readme.txt
211 bytes
<DIR>
<DIR>
<DIR>
Para mostrar los archivos con todos los atributos en el directorio actual:
Comandos de UEFI Shell
45
fs0:\> ls -a
Directory of: fs0:\
06/18/01
09:32p
06/18/01
01:02p
06/18/01
01:02p
06/18/01
01:02p
06/18/01
10:59p
06/18/01
10:59p
06/18/01
08:04p
06/18/01
08:05p
01/28/01
08:24p
5 File(s)
4 Dir(s)
153
for.nsh
512
efi
512
test1
512
test2
28,739
IsaBus.efi
32,838
IsaSerial.efi
29
temp.txt
<DIR>
512
test
r
29
readme.txt
61,788 bytes
<DIR>
<DIR>
<DIR>
Para mostrar los archivos con atributos de solo lectura en el directorio actual:
fs0:\> ls -ar
Directory of: fs0:\
06/18/01 11:14p
r 29
1 File(s)
29 bytes
0 Dir(s)
readme.txt
Para mostrar los archivos con el atributo s:
fs0:\> ls -as isabus.efi
Directory of: fs0:\
06/18/01 10:59p
1 File(s)
0 Dir(s)
28,739 IsaBus.efi
28,739 bytes
Para mostrar de forma recursiva todo el contenido del directorio fs0:\efi:
fs0:\> ls -r -a efi
Para buscar archivos del tipo especificado en el directorio actual de forma recursiva:
fs0:\> ls -r -a *.efi –b
Detalles de los resultados
En las tablas siguientes se describe la información de volumen (directorio) y archivo que puede
producir este comando.
Tabla 5 Detalles de los resultados del comando ls (información del volumen)
Columna
Descripción
Name
Etiqueta de volumen estándar.
Total Size
Número total de bytes en el volumen.
Read Only status
Estado de solo lectura:
• True
• False
Free Space
Cantidad total de bytes libres en el volumen.
Block Size
Tamaño de bloque nominal, en bytes, que suelen aumentar los archivos.
Tabla 6 Detalles de los resultados del comando ls (información de archivo)
46
Columna
Descripción
Name
Nombre de archivo completo y directorio, incluido el nombre asignado del sistema de
archivos.
Logical Size
Tamaño del archivo, en bytes.
Referencia de comandos de UEFI Shell
Tabla 6 Detalles de los resultados del comando ls (información de archivo) (continuación)
Columna
Descripción
Physical Size
Tamaño en bytes del archivo en el volumen, incluido el material de relleno.
Attributes
Lista de atributos del archivo. Los valores posibles son:
• a: archivo
• d: directorio
• h: oculto
• r: solo lectura
• s: sistema
File Creation Time
Hora a la que creó el archivo, con el formato hh:mm:ss.
File Creation Date
Fecha en la que se creó el archivo, con el formato dd:mm:aaaa.
File Access Time
Hora la que se tuvo acceso al archivo por última vez, con el formato hh:mm:ss.
File Access Date
Fecha en la que se tuvo acceso al archivo por última vez, con el formato dd:mm:aaaa.
File Modification Time Hora a la que se modificó el archivo, con el formato: hh:mm:ss.
File Modification Date Fecha en la que se modificó el archivo, con el formato: dd:mm:aaaa.
map
Sintaxis
map[-d mappedname]
map[-r|-v|-c|-f|-u|-t type[,type]|mappedname][-sfo]
map[mappedname|mapping]
Descripción
Permite mostrar o configurar una asignación entre un nombre definido por el usuario y un
identificador de dispositivo.
Opciones
-d
Elimina una asignación.
mappedname
Especifica un nombre de asignación.
-r
Restablece una asignación.
-v
Muestra información detallada sobre todas las asignaciones.
-c
Muestra la asignación coherente.
-f
Muestra la asignación normal.
-t
Muestra las asignaciones del dispositivo, filtradas según el tipo de dispositivo.
Los tipos admitidos son los siguientes:
•
fp: unidad de disquete
•
hd: disco duro
•
cd: CD-ROM
Los tipos se pueden combinar si se intercala una coma entre ellos. No es posible
intercalar espacios entre los tipos.
-sfo
Muestra los resultados en formato estándar. Consulte Tabla 7 (página 48).
Comandos de UEFI Shell
47
-u
Permite agregar asignaciones para los dispositivos recién instalados. Asimismo,
permite quitar las asignaciones de los dispositivos desinstalados, pero no
modifica las asignaciones de los dispositivos existentes. Mantiene las
asignaciones definidas por el usuario.
handle
Especifica el número del identificador.
asignación
Especifica un nuevo nombre asignado para un dispositivo. La asignación debe
terminar con el signo de dos puntos (:).
Uso
Este comando se utiliza con más frecuencia para crear un nombre asignado para los dispositivos
que admiten un protocolo de sistema de archivos. Una vez creadas estas asignaciones, los
nombres se pueden utilizar con todos los comandos de manipulación de archivos.
El entorno de UEFI Shell crea asignaciones predeterminadas para todos los dispositivos que
admiten un sistema de archivos reconocido.
Este comando puede utilizarse para crear asignaciones adicionales o para eliminar una asignación
existente con la opción -d. Si se utiliza el comando sin ningún parámetro, se mostrarán todas
las asignaciones actuales. Si se utiliza la opción - v, se mostrarán las asignaciones con
información adicional sobre cada dispositivo.
La opción - r restablece todas las asignaciones predeterminadas de un sistema. Esta opción
resulta útil si la configuración del sistema ha cambiado desde el último inicio.
La opción –u permite agregar asignaciones para los dispositivos recién instalados. Asimismo,
permite quitar las asignaciones de los dispositivos desinstalados, pero no modifica las
asignaciones de los dispositivos existentes. Esta opción también conserva las asignaciones
definidas por el usuario. Este comando también guarda un historial de asignaciones para que
se pueda usar el nombre de asignación original de un dispositivo con una ruta de dispositivo
específica en caso de que se utilice dicho nombre de asignación para la ruta del dispositivo por
última vez. El directorio actual también se mantendrá si no se modifica el dispositivo actual.
Cada dispositivo del sistema tiene una asignación coherente. Las asignaciones coherentes del
dispositivo no cambiarán si no se modifica la configuración de hardware. Si dos o más equipos
tienen las mismas configuraciones de hardware, la asignación coherente del dispositivo será la
misma. Utilice la opción -c para que se muestren todas las asignaciones coherentes del sistema.
La asignación consta de dígitos y caracteres. No se permite ningún otro carácter.
Este comando permite utilizar caracteres comodín para eliminar o mostrar asignaciones. No
obstante, no es posible usar caracteres comodín para realizar la asignación.
Ejemplo
Para eliminar una asignación:
Shell> map -d nombre-dispositivo
Detalles de los resultados
En la tabla siguiente se describen los resultados que puede producir este comando.
Tabla 7 Detalles de los resultados del comando map
48
Número de columna
Descripción
1
El nombre de la tabla. El nombre es mappings (asignaciones).
2
El nombre asignado. El nombre del dispositivo asignado.
Referencia de comandos de UEFI Shell
Tabla 7 Detalles de los resultados del comando map (continuación)
Número de columna
Descripción
3
La ruta del dispositivo. La ruta del dispositivo que se corresponde con el nombre del
dispositivo asignado.
4
El nombre coherente. Nombre asignado coherente (si existe) equivalente a
mappedname. Esta columna no contendrá ningún valor si mappedname ya es un
nombre asignado coherente.
memmap
Sintaxis
memmap[-b][-sfo]
Descripción
Muestra el mapa de memoria del sistema.
Opciones
-b
Muestra una pantalla a la vez.
-sfo
Muestra los resultados en formato estándar en una tabla de resumen y en una tabla
detallada. Consulte Detalles de los resultados del comando memmap.
Uso
El mapa de memoria realiza un seguimiento de toda la memoria física del sistema y de cómo
se está usando actualmente.
Ejemplo
Para mostrar el mapa de memoria del sistema:
fs0:\> memmap
Type
Start
End
# Pages
available
0000000000750000-0000000001841FFF
LoaderCode 0000000001842000-00000000018A3FFF
available
00000000018A4000-00000000018C1FFF
LoaderData 00000000018C2000-00000000018CAFFF
BS_code
00000000018CB000-0000000001905FFF
BS_data
0000000001906000-00000000019C9FFF
...
RT_data
0000000001B2B000-0000000001B2BFFF
BS_data
0000000001B2C000-0000000001B4FFFF
reserved
0000000001B50000-0000000001D4FFFF
reserved :
LoaderCode:
LoaderData:
BS_code
:
BS_data
:
RT_data
:
available :
Total Memory:
Attributes
00000000000010F2
0000000000000062
000000000000001E
0000000000000009
000000000000003B
00000000000000C4
0000000000000009
0000000000000009
0000000000000009
0000000000000009
0000000000000009
0000000000000009
0000000000000001 8000000000000009
0000000000000024 0000000000000009
0000000000000200 0000000000000009
512 Pages (2,097,152)
98 Pages (401,408)
32 Pages (131,072)
335 Pages (1,372,160)
267 Pages (1,093,632)
19 Pages (77,824)
4,369 Pages (17,895,424)
20 MB (20,971,520) Bytes
Detalles de los resultados
En la tabla siguiente se describen los resultados que puede producir este comando.
Comandos de UEFI Shell
49
Tabla 8 Detalles de los resultados del comando memmap
Columna
Descripción
Type
Tipo de memoria. Las opciones disponibles son las siguientes:
• Available
• LoaderCode
• LoaderData
• BootServiceCode
• BootServiceData
• RuntimeCode
• RuntimeData
• Reserved
• MemoryMappedIO
• MemoryMappedIOPortSpace
• UnusableMemory
• ACPIReclaimMemory
• ACPIMemoryNVS
• PalCode
Start
Dirección de inicio.
End
Dirección de finalización.
# Pages
Número de páginas de 4 KB.
reserved
Cantidad total de memoria reservada en bytes.
LoaderCode
Tamaño total de código de cargador en bytes.
LoaderData
Tamaño total de datos de cargador en bytes.
BS_code
Tamaño total de código de servicio de arranque en bytes.
BS_data
Tamaño total de datos de servicio de arranque en bytes.
RT_data
Tamaño total de datos en tiempo de ejecución en bytes.
available
Memoria disponible en bytes.
Total Memory
Memoria total en bytes.
mkdir
Sintaxis
mkdir dir[dir...]
Descripción
Permite crear uno o varios directorios.
Opción
dir
50
Especifica uno o varios nombres de directorios. Este comando no admite el uso de
caracteres comodín.
Referencia de comandos de UEFI Shell
Uso
Si dir incluye directorios anidados, se crearán los directorios principales antes de los secundarios.
Si el directorio ya existe, el comando finalizará con un error.
Ejemplos
Para crear un nuevo directorio y mostrar su contenido:
fs0:\> mkdir rafter
fs0:\> ls
Directory of: fs0:\
06/18/01 08:05p <DIR>
512
06/18/01 11:14p r
29
06/18/01 11:50p <DIR>
512
1 File(s)
211 bytes
2 Dir(s)
test
readme.txt
rafter
Para crear y mostrar varios directorios:
fs0:\> mkdir temp1 temp 2
fs0:\> ls
Directory of: fs0:\
06/18/01 08:05p <DIR>
512
06/18/01 11:14p r
29
06/18/01 11:50p <DIR>
512
06/18/01 11:52p <DIR>
512
06/18/01 11:52p <DIR>
512
1 File(s)
211 bytes
4 Dir(s)
test
readme.txt
rafter
temp1
temp2
mode
Sintaxis
mode[col row]
Descripción
Muestra o cambia el modo del dispositivo de salida de la consola.
Opciones
col
Especifica el número de columnas.
fil
Especifica el número de filas.
Uso
Cuando se utiliza sin parámetros, muestra una lista de los modos que admite actualmente el
dispositivo de salida estándar. El comando puede utilizarse con los parámetros row y col para
cambiar el número de filas y columnas en el dispositivo de salida estándar.
NOTA: La pantalla se borra cada vez que se utiliza el comando mode para cambiar el modo
de visualización actualmente seleccionado.
Ejemplos
Para mostrar todos los modos disponibles en el dispositivo de salida estándar, así como el modo
seleccionado actualmente (indicado con un *):
Shell> mode
Available modes on standard output
col 80 row 25 *
col 80 row 50
Comandos de UEFI Shell
51
col 80 row 43
col 100 row 100
Para cambiar la configuración del modo actual a una pantalla de modo de texto de 80 X 50:
Shell> mode 80 50
Available modes on standard output
col 80 row 25
col 80 row 50 *
col 80 row 43
col 100 row 100
mv
Sintaxis
mv src...[dst]
Descripción
Permite mover uno o varios archivos a un destino del sistema de archivos.
Opciones
orig...
Especifica un archivo de origen o nombre de directorio. Este comando admite el
uso de caracteres comodín.
dest
Especifica un nombre de archivo o de directorio de destino. Este comando admite
el uso de caracteres comodín. Si no se especifica, se asumirá que el directorio de
trabajo actual es el de destino. Si hay más de un argumento en la línea de comandos,
siempre se considerará el último como destino.
Uso
Este comando no admite el traslado entre volúmenes del sistema de archivos. Si el destino es
un directorio existente, los orígenes se moverán a dicho directorio. De lo contrario, los orígenes
se moverán al destino como si se hubiese cambiado el nombre del directorio. Si no se especifica
ningún destino, se asumirá que el directorio actual es el destino.
Se producirá un error si se intenta mover un directorio o archivo de solo lectura. Este comando
permite mover un directorio que contiene archivos de solo lectura. No es posible mover un
directorio a sí mismo o a sus subdirectorios. No se podrá mover un directorio si este es el
directorio de trabajo actual o alguno de sus subdirectorios.
Los demás archivos o directorios se moverán pese a que se produzca un error.
Ejemplo
Para cambiar el nombre de un archivo:
fs0:\> mv IsaBus.efi Bus.efi
moving fs0:\IsaBus.efi -> \Bus.efi
- [ok]
openinfo
Sintaxis
openinfo handle[-b]
Descripción
Muestra los protocolos y agentes asociados a un identificador.
Opciones
-b
52
Muestra una pantalla a la vez.
Referencia de comandos de UEFI Shell
indentificador
Muestra la información de los protocolos abiertos para el identificador
especificado.
parse
Sintaxis
parse filename tablename column[-i instance][-s instance]
Descripción
Permite recuperar un valor de un registro especificado que se generó en los resultados con
formato estándar.
Opciones
nombre-de-archivo
Especifica el nombre del archivo de origen.
nombre-de-tabla
Especifica el nombre de la tabla que se debe analizar.
columna
Especifica el índice de columna para determinar el valor específico
del registro que se debe analizar.
-i instancia
Inicia el análisis de la instancia n de la opción tablename
especificada, después de la instancia especificada de
ShellCommand. Si no se encuentra, se devolverán todas las
instancias.
-s instancia
Inicia el análisis de la instancia n de la tabla ShellCommand
especificada. Si no se encuentra, el parámetro tomará el valor 1.
Uso
Este comando permite analizar los datos de un archivo que contiene el resultado de un comando
con el que se ha utilizado el parámetro –sfo. Puesto que el formato estándar de resultados
tiene métodos de análisis conocidos, este comando debe utilizarse como método simplificado
para hacer que las secuencias de comandos usen los archivos de resultados creados y los datos
recuperados en la lógica de las secuencias de comandos programadas para UEFI Shell.
Ejemplos
A continuación se muestran los datos incluidos en un archivo temporal (temp.txt):
ShellCommand, "LS"
VolumeInfo, "MikesVolume","400000000","32000000","16000000"
FileInfo, "fs0:/efi/boot/winloader.efi","45670","arsh"
FileInfo, "fs0:/efi/boot/mikesfile.txt","1250","a"
FileInfo, "fs0:/efi/boot/readme.txt","795","a"
Para utilizar el parámetro de índice para analizar el archivo temp.txt:
fs0:\> parse temp.txt FileInfo 3 –i 3
795
partitions
Sintaxis
partitions[-v]
Descripción
Muestra una lista de las particiones de disco del sistema.
Comandos de UEFI Shell
53
Opción
-v
Proporciona información detallada sobre todas las particiones del sistema de archivos.
Ejemplo
Para mostrar información detallada sobre las particiones:
Shell> partitions –v
pause
Sintaxis
pause[-q]
Descripción
Permite poner en pausa la ejecución del archivo de la secuencia de comandos.
Uso
Este comando solo está disponible para las secuencias de comandos. Muestra un mensaje en
la pantalla, suspende la ejecución del archivo de la secuencia de comandos y espera a que se
pulse una tecla del teclado. La ejecución se reanudará al pulsar cualquier tecla, excepto las
teclas q o Q. Si se pulsan las teclas q o Q, finalizará el procesamiento de la secuencia de
comandos. En caso contrario, la ejecución continuará con la siguiente línea tras el comando de
pausa.
Opción
–q
Oculta el mensaje mostrado.
Ejemplos
Esta secuencia de comandos muestra un ejemplo del comando pause:
fs0:\> type pause.nsh
#
# Example script for 'pause' command
#
echo pause.nsh begin..
date
hour
pause
echo pause.nsh done.
Para ejecutar la secuencia de comandos con el eco activado:
fs0:\> pause.nsh
+pause.nsh> echo pause.nsh begin..
pause.nsh begin..
+pause.nsh> date
06/19/2001
+pause.nsh> time
00:51:45
+pause.nsh> pause
Enter 'q' to quit, any other key to continue:
+pause.nsh> echo pause.nsh done.
pause.nsh done.
Para ejecutar la secuencia de comandos con el eco desactivado:
fs0:\> echo —off
fs0:\> pause.nsh
pause.nsh begin..
pause.nsh begin..
06/19/2001
54
Referencia de comandos de UEFI Shell
00:52:50
Enter 'q' to quit, any other key to continue: q
fs0:\>
pci
Sintaxis
pci[bus dev[func][-s seg][-i]]
Descripción
Muestra una lista de dispositivos PCI o información acerca del espacio de configuración de la
función PCI.
Opciones
bus
Número de bus.
dev
Número de dispositivo.
func
Número de función.
-s seg
Especifica un número de segmento.
-i
Información interpretada.
Uso
Este comando muestra todos los dispositivos PCI del sistema. La información mostrada para el
espacio de configuración de un dispositivo PCI se basa en las direcciones especificadas de bus,
dispositivo y función. Si no se especifica ninguna dirección de función, se tomará el valor 0 de
forma predeterminada.
La opción -i muestra información detallada sobre el dispositivo PCI especificado. El espacio
de configuración de PCI del dispositivo se vuelca con una interpretación detallada.
Si no se especifica ningún parámetro, se volcarán todos los dispositivos PCI con una interpretación
detallada.
Si se especifican los parámetros bus y dev (número de dispositivo), pero no se especifican los
parámetros func o seg, func o seg tomarán el valor 0, (valor predeterminado).
Ejemplos
Para mostrar todos los dispositivos PCI del sistema:
fs0:\> pci
Para mostrar el espacio de configuración del bus 0, el dispositivo 0 y la función 0:
fs0:\> pci 00 00 00 -i
ping
Sintaxis
ping[-s sourceIP][-n count][-l size]targetIP
Descripción
Envía un ping al host de destino con una pila IPv4.
Opciones
-s
Especifica que el adaptador de origen es una dirección IPv4.
sourceIP
Especifica la dirección IPv4 de la máquina de origen.
Comandos de UEFI Shell
55
-n número
Especifica el número de datagramas de solicitud de eco que han de enviarse.
-l tamaño
Especifica el tamaño del búfer de datos en el datagrama de solicitud de eco.
targetIP
Especifica la dirección IPv4 de la máquina de destino.
Uso
Este comando utiliza el datagrama ICMPv4 ECHO_REGUEST para obtener un ECHO_REPLY de
un host.
Ejemplos
Para hacer ping al host de destino en 192.168.0.1 con 64 bytes de datos:
FS0:\>ping -1 64 192.168.0.1
Para hacer ping al host de destino en 202.120.120.100 mediante el envío de un datagrama de
solicitud de eco de 20 bytes:
FS0:\>ping -n 20 202.120.120.100
ramdisk
Sintaxis
ramdisk -c[-s size][v volumelabel][-t type]
ramdisk -d[fs|all]
ramdisk -l [-sfo]
Descripción
Crea y elimina discos de RAM.
Opciones
-c
Crea un disco de RAM.
-s tamaño
Especifica el tamaño del disco de RAM en MB. Los valores válidos
están comprendidos entre 4 y 512 MB.
-v etiqueta-volumen
Especifica un nombre de etiqueta de volumen para el disco de
RAM. Se permite una secuencia de hasta once caracteres, sin
espacios y que no incluya ninguno de los símbolos siguientes: %
^ * + = [ ] | : ; \ < > ? /.
-t tipo
Especifica un tipo de sistema de archivos.
-d
Permite eliminar uno o varios discos de RAM.
fs
Especifica la unidad del sistema de archivos para la eliminación
del disco de RAM.
all
Elimina todos los discos de RAM.
-l
Muestra todos los discos de RAM.
-sfo
Muestra la información de los resultados en formato estándar.
Uso
Puede utilizar este comando para aprovisionar las ubicaciones de almacenamiento provisional
temporales. Es muy útil en entornos sin configurar en los que no hay ningún soporte disponible
para el almacenamiento provisional o las secuencias de comandos. El comando admite hasta
10 discos de RAM de los siguientes sistemas de archivos y tamaños:
•
56
FAT16: (predeterminado) tamaño mínimo de 4 MB y tamaño máximo de 512 MB
Referencia de comandos de UEFI Shell
•
FAT32: tamaño mínimo de 512 MB y tamaño máximo de 2000 MB
Si no especifica -t tipo, se crea un sistema de archivos de tipo FAT16 de forma
predeterminada.
Ejemplos
Para crear un disco de RAM de 512 MB FAT16:
Shell> ramdisk -c -s 512
Para crear un disco de RAM de 512 MB FAT16 con una etiqueta de volumen RAMDISK1:
Shell> ramdisk -c -s 512 -v RAMDISK1
Para crear un disco de RAM de 1000 MB FAT32:
Shell> ramdisk -c -s 1000
Para mostrar la información completa de asignación de todos los discos de RAM:
Shell> ramdisk -l
Para eliminar un disco de RAM fs0:
Shell> ramdisk -d fs0
reset
Sintaxis
reset[-w|[-s]|-c][string]
Descripción
Permite restablecer el sistema.
Opciones
-w
Realiza un arranque en caliente.
-s
Apaga el sistema.
-c
Realiza un arranque en frío.
cadena
Especifica la cadena que se debe transmitir para restablecer el servicio.
Uso
El uso predeterminado de este comando lleva a cabo un reinicio en frío. Si se especifica la opción
cadena, se transmitirá el valor de esta opción a la función SystemTable ResetSystem()
para informar al sistema de la razón para el reinicio del sistema.
Ejemplo
Para restablecer el sistema:
Shell> reset
restclient
Sintaxis
restclient -uri URI options
restclient -type TYPE options
restclient -t
Comandos de UEFI Shell
57
Descripción
Interactúa con el servicio de la API de RESTful local. El comando restcli es un alias
interno de este comando.
Opciones de selección de recursos
-uri URI
Solicita un recurso desde una URI específica.
-type TIPO
Devuelve un recurso que coincide con el tipo especificado, si existe uno.
Acciones
-m MÉTODO
Envía la solicitud HTTP mediante el método especificado. Los
valores válidos son: GET/POST/PUT/PATCH/DELETE.
-g [PROPIEDAD...]
Obtiene el recurso completo, o una propiedad específica dentro
del recurso. -m GET está implícito con esta opción.
-s PROPIEDAD = VALOR
Especifica un valor para una propiedad de un recurso. -m PATCH
está implícito con esta opción, y el contenido de la solicitud se
genera automáticamente.
-t
Muestra una lista de todos los tipos de recursos.
Opciones generales
-i ARCHIVO
Envía el contenido de un archivo específico en el contenido de la solicitud.
-c
Utiliza el contenido guardado en la memoria caché para las solicitudes GET
siempre que sea posible. Esta opción mejora el rendimiento, pero es posible
que devuelva datos obsoletos.
Uso
Los URI deben comenzar por el recurso raíz, y no deben llevar una barra inclinada delante. Por
ejemplo: rest/v1/Systems.
TIPO es una cadena con el formato NombreDeTipo.X.Y.Z, donde X, Y, Z son las versiones
principal, secundaria y de corrección de errores, respectivamente. Si se omiten algunos de los
especificadores de la versión (o todos ellos), se utiliza la coincidencia por caracteres comodín.
Asimismo, los TIPOS que especifican las versiones secundarias y de corrección de errores
también coinciden con los recursos con valores mayores debido a que estos son compatibles
con las versiones anteriores.
PROPIEDAD distingue entre mayúsculas y minúsculas, y se pueden seleccionar propiedades
anidadas mediante la adición de delimitadores '/'. La opción -s no puede aceptar propiedades
anidadas.
VALOR puede representar JSON (objetos, arrays, nulo, etc.). No es necesario usar comillas para
los valores de cadena, salvo para conservar el espacio en blanco.
El contenido del ARCHIVO debe ser JSON válido.
Ejemplo
Para obtener el recurso raíz:
Shell> restclient -uri rest/v1 -g
Para obtener la propiedad AdminName del recurso BIOS:
Shell> restclient -uri rest/v1/Systems/1/Bios -g AdminName
Para obtener la versión del BIOS de un recurso ComputerSystem:
Shell> restclient -type ComputerSystem -g Bios/Current/VersionString
Para establecer la propiedad AdminName del recurso BIOS:
58
Referencia de comandos de UEFI Shell
Shell> restclient -uri rest/v1/Systems/1/Bios/Settings -s AdminName=\"First Last
Para enviar una solicitud POST:
Shell> restclient -uri rest/v1/Systems/1 -m POST -i PostData.json
rm/del
Sintaxis
rm[-q]file/directory[file/directory...]
Descripción
Permite eliminar uno o varios archivos o directorios. El comando del es un alias interno de este
comando.
Opciones
-q
Realiza la eliminación de forma silenciosa, sin mostrar ningún mensaje de
confirmación.
archivo
Especifica el nombre del archivo que se va a eliminar. Este comando admite
el uso de caracteres comodín.
directorio
Especifica el directorio que se va a eliminar. Este comando admite el uso de
caracteres comodín.
Uso
Si el destino es un directorio, este comando lo eliminará, incluidos todos sus subdirectorios. Este
comando no puede redirigir archivos cuyos directorios principales (o incluso los propios archivos)
se vayan a eliminar.
Se producirá un error si se eliminan directorios o archivos de solo lectura. También se producirá
un error si se elimina un directorio que contenga uno o varios archivos de solo lectura. En caso
de error, el comando rm se cerrará inmediatamente y no se eliminarán los archivo o directorios
restantes.
No es posible eliminar un directorio si el directorio actual es el directorio que se trata de eliminar
o alguno de sus subdirectorios. Si el archivo especificado para la eliminación contiene caracteres
comodín, el sistema no solicitará confirmación alguna.
Asimismo, no es posible eliminar el directorio raíz, el directorio actual ni sus antecesores.
Ejemplos
Intento de eliminación de varios directorios a la vez cuando no se pueden encontrar los directorios
(lo que provoca la finalización del comando):
fs0:\> ls test
Directory of: fs0:\test
06/18/01 01:01p <DIR>
06/18/01 01:01p <DIR>
06/19/01 12:59a <DIR>
06/19/01 12:59a <DIR>
0 File(s) 0 bytes
4 Dir(s)
512 .
0 ..
512 temp1
512 temp2
fs0:\> rm test\temp11 temp2
rm/del: Cannot find 'fs0:\test\temp11' - Not Found
Para eliminar varios directorios con caracteres comodín:
fs0:\> rm test\temp*
rm/del: Remove subtree 'fs0:\test\temp1' [y/n]? y
removing fs0:\test\temp1\temp1.txt
Comandos de UEFI Shell
59
- [ok]
removing fs0:\test\temp1\boot\nshell.efi
- [ok]
removing fs0:\test\temp1\boot
- [ok]
removing fs0:\test\temp1
- [ok]
rm/del: Remove subtree 'fs0:\test\temp2' [y/n]? y
removing fs0:\test\temp2\temp2.txt
- [ok]
removing fs0:\test\temp2
- [ok]
Intento de eliminación de un directorio que contiene un archivo de solo lectura, lo que provoca
un mensaje de error:
fs0:\> attrib +r test\temp1\readme.txt
A R fs0:\test\temp1\readme.txt
fs0:\> rm test\temp1
rm/del: Cannot open 'readme.txt' under 'fs0:\test\temp1' in
writable mode
- [error] - Access Denied
Exit status code: Access Denied
secboot
Sintaxis
secboot[-l all]|[PK]|[KEK]|[db]|[dbx][-sfo]
secboot[-f file]secboot[-e PK]|[KEK]|[db]|[dbx][-f file]
secboot[-r][-q]
secboot[-d all]|[PK]|[KEK]|[db]|[dbx][-i index][-q]
Descripción
Muestra y modifica las bases de datos, las claves y los informes de seguridad del arranque
seguro.
Opciones
60
-l
Muestra las bases de datos y las claves del arranque seguro.
all
Muestra o elimina las firmas de todas las variables del arranque seguro.
PK
Muestra información de la clave de la plataforma (PK). Distingue entre
mayúsculas y minúsculas.
KEK
Muestra información de la clave de intercambio de claves (KEK). Distingue
entre mayúsculas y minúsculas.
db
Muestra información de la base de datos de firmas permitidas (DB).
dbx
Muestra información de la base de datos de firmas prohibidas (DB).
-sfo
Muestra la información de los resultados en formato estándar.
-e
Inscribe un archivo X509 con formato DER o el hash de una aplicación EFI en
una variable de arranque seguro.
-f archivo
Muestra información sobre un archivo X509 con formato DER.
-r
Reinicializa todas las firmas de arranque seguro con los valores predeterminados
de la plataforma.
-d
Elimina todas las firmas o elimina las firmas de una base de datos determinada.
Referencia de comandos de UEFI Shell
-i índice
Selecciona una firma (1, 2, ...) de una base de datos específica.
-q
Se muestra en modo silencioso sin preguntas de confirmación al usuario.
Ejemplos
Para mostrar las firmas de todas las variables del arranque seguro:
Shell> secboot -l all
Para mostrar información de la base de datos de firmas permitidas:
Shell> secboot -l db
Para mostrar información del archivo X509 con formato DER:
Shell> secboot -f abc.der
Para inscribir el hash de una aplicación EFI en la base de datos de firmas permitidas:
Shell> secboot -e db –f boot64.efi
Para volver a inicializar todas las firmas de arranque seguro con los valores predeterminados
de la plataforma:
Shell> secboot -r
Para eliminar todas las firmas de arranque seguro:
Shell> secboot -d all
Para eliminar una clave de plataforma:
Shell> secboot -d PK
Para borrar la base de datos de firmas permitidas
Shell> secboot -d db
Para eliminar la segunda firma de la clave de intercambio de claves:
Shell> secboot -d KEK —i 2
set
Sintaxis
set[-v][sname[value]]
set[-d sname]
Descripción
Permite crear, mostrar, cambiar o eliminar una variable de entorno de UEFI Shell.
Opciones
-v
Establece una variable volátil que desaparece en el siguiente inicio.
-d
Elimina una variable.
nombre
Especifica un nombre para la variable.
valor
Especifica un valor para la variable.
Uso
Este comando establece la variable de entorno especificada con la opción nombre con los
parámetros opcionales valor. Si no se utiliza ningún parámetro, se mostrarán todas las variables
de entorno. Si se utiliza con la opción -d, se eliminará la variable de entorno especificada con
la opción nombre.
Este comando no modifica el valor de la variable de entorno lasterror.
Comandos de UEFI Shell
61
Ejemplos
Para agregar una variable de entorno:
Shell> set DiagnosticPath fs0:\efi\diag;fs1:\efi\diag
Para mostrar las variables de entorno:
Shell> set
* path
: .
diagnosticPath
: fs0:\efi1.1\diag;fs1:\efi1.1\diag
Para eliminar una variable de entorno:
Shell> set -d diagnosticpath
Shell> set
* path
: .
“
Para modificar una variable de entorno:
fs0:\> set src efi
fs0:\> set
]* path
: .;fs0:\efi\tools;fs0:\efi\boot;fs0:\
src : efi
fs0:\> set src efi1.1
fs0:\> set
* path
: .;fs0:\efi\tools;fs0:\efi\boot;fs0:\
src : efi1.1
Para agregar una variable de entorno:
Shell> set
* path
: .
Shell> set path %path%;fs0:\efi\tools;fs0:\efi\boot;fs0:\
Shell> set
* path
: .;fs0:\efi\tools;fs0:\efi\boot;fs0:\
Para establecer una variable volátil que desaparezca la próxima vez que se reinicie:
Shell> set -v EFI_SOURCE c:\project\EFI1.1
Shell> set
* path
: .;fs0:\efi\tools;fs0:\efi\boot;fs0:\
* EFI_SOURCE
: c:\project\EFI1.1
setsize
Sintaxis
setsize size[-d]file[file...]
Descripción
Permite ajustar el tamaño de un archivo de destino.
Opciones
tamaño
Especifica el tamaño del archivo una vez que se ajusta.
-d
Elimina una variable.
archivo
Especifica el archivo cuyo tamaño debe ajustarse.
Uso
Al ajustar el tamaño de un archivo, este comando trunca o amplía automáticamente el tamaño
en función de los parámetros utilizados. El archivo se creará en caso de que no exista ninguno.
Al establecer un tamaño inferior al de los datos reales del archivo, se truncan los datos.
62
Referencia de comandos de UEFI Shell
Ejemplo
Para establecer el tamaño de un archivo:
fs0:\> setsize size file [file...]
shift
Sintaxis
shift
Descripción
Permite desplazar el contenido de los parámetros posicionales de una secuencia de comandos
de UEFI Shell para que las secuencias de comandos puedan procesarlos de izquierda a derecha.
Uso
Este comando permite desplazar el contenido de los parámetros de las secuencias de comandos
de UEFI Shell para descartar %1, copiar %2 en %1, %3 en %2, %4 en %3 y así sucesivamente.
Esto permite a las secuencias de comandos de UEFI Shell procesar los parámetros de izquierda
a derecha.
Este comando no modifica la variable de entorno de UEFI Shell lasterror.
Ejemplos
Para ejecutar la secuencia de comandos con el eco activado:
fs0:\> shift.nsh welcome EFI world
shift.nsh> echo welcome EFI world
welcome EFI world
shift
echo EFI world
EFI world
Para ejecutar la secuencia de comandos con el eco desactivado:
fs0:\> echo -off
shift.nsh> shift.nsh welcome EFI world
welcome EFI world
EFI world
smbiosview
Sintaxis
smbiosview[-t SmbiosType]|[-h SmbiosHandle]|[-s]|[-a]
Descripción
Muestra la información de SMBIOS.
Opciones
-t
Muestra todas las estructuras de SmbiosType.
SmbiosType
Especifica el tipo de estructura de SMBIOS. Es un número del 0 al 42. Para
ver los valores admitidos y sus descripciones, utilice el comando help
smbios.
-h
Muestra las estructuras de SmbiosHandle.
SmbiosHandle
Especifica un identificador único de 16 bits de una estructura SMBIOS.
-s
Muestra una tabla de estadísticas.
Comandos de UEFI Shell
63
Muestra toda la información.
—a
Ejemplo
Para mostrar todas las estructuras de SmbiosType 7 (información de la caché):
fs0:\> smbiosview -t 7
stall
Sintaxis
stall tiempo
Descripción
Establece una detención temporizada de las operaciones, en microsegundos, durante la ejecución
de una secuencia de comandos.
Opción
tiempo
Especifica el número de microsegundos que debe detenerse el procesador.
Ejemplo
Para detener el procesador durante 20 microsegundos:
Shell> stall 20
sysconfig
Sintaxis
sysconfig -i[all|settingname][-sfo][-b]
sysconfig -g[all|settingname][settingname...][-sfo][-b]
sysconfig -s[settingname=settingvalue...]
sysconfig -s AdminPassword=settingvalue OldAdminPassword=settingvalue
sysconfig -s PowerOnPassword=settingvalue
OldPowerOnPassword=settingvalue[-b]
sysconfig -d[get|set][DefaultType][settingname|all] [-sfo][-b]
sysconfig -import filename.txt[ASCII]
sysconfig -export filename.txt
Descripción
Muestra o configura los ajustes del BIOS del sistema HPE.
Opciones
64
-b
Muestra una pantalla a la vez.
-i
Muestra información de los ajustes de configuración especificados
o de todos los ajustes, incluidos los valores posibles.
nombre-ajuste
Especifica el nombre del ajuste de configuración sobre el que se
va a mostrar la información. Consulte Atributos de sysconfig.
all
Muestra toda la información de todos los ajustes.
-g
Muestra los valores actuales de los ajustes seleccionados o de
todos los ajustes.
—s
Establece el valor del ajuste especificado.
Referencia de comandos de UEFI Shell
valor-ajuste
Especifica el valor de un ajuste.
AdminPassword
Especifica una nueva contraseña de administrador.
OldAdminPassword
Especifica la contraseña de administrador que se va a restablecer.
PowerOnPassword
Especifica una contraseña nueva para encender el servidor.
OldPowerOnPassword
Especifica la contraseña de encendido que se va a restablecer.
–d
Obtiene (muestra en una lista) o establece el valor predeterminado
para un tipo-predeterminado especificado o para todos los
ajustes de tipo predeterminados.
tipo-predeterminado
Especifica el ajuste de tipo predeterminado que se va a obtener
(mostrar en una lista) o establecer.
-import
Importa todos los ajustes de configuración de un archivo de
secuencia de comandos.
-export
Exporta todos los ajustes de configuración a un archivo de
secuencia de comandos.
nombre-de-archivo
Especifica el destino del archivo de la secuencia de comandos
para la importación o exportación.
ASCII
Utiliza la codificación ASCII para los archivos de resultados.
-sfo
Muestra la información de los resultados en formato estándar.
Uso
Para mostrar o definir ajustes de tipo cadena, utilice comillas para cualquier valor-ajuste
que contenga espacios o caracteres '='. Por ejemplo: "sysconfig -s AdminName ="José
López".
Para eliminar un valor-ajuste de un ajuste de tipo cadena, utilice comillas. Por ejemplo:
"sysconfig -s AdminName ="".
La opción – sfo permite analizar más fácilmente la salida del comando mediante secuencias
de comandos del shell. Cuando se utiliza esta opción, cualquier carácter de punto y coma de la
cadena del valor se sustituye por la secuencia de escape ' \;'.
Las opciones -export, -set e -import no son compatibles con SFO.
Se permite el carácter \ en valores de tipo cadena.
Ejemplos
Para ver los valores actuales de todos los ajustes del BIOS:
Shell> sysconfig -g all
Para mostrar información detallada sobre el parámetro ProcHyperthreading:
Shell> sysconfig -i ProcHyperthreading
Para obtener el valor actual del ajuste ProcHyperthreading:
Shell> sysconfig -g ProcHyperthreading
Para establecer el valor del ajuste ProcHyperthreading en desactivado:
Shell> sysconfig -s ProcHyperthreading=Disabled
Para obtener una lista de todos los ajustes de tipo predeterminados:
Shell> sysconfig -d get
Para obtener una lista con todos los ajustes predeterminados:
Shell> sysconfig -d get SystemDefaults all
Para obtener los ajustes predeterminada de NicBoot1:
Shell> sysconfig -d get SystemDefaults NicBoot1
Comandos de UEFI Shell
65
Para establecer los valores predeterminados de todos los ajustes del BIOS:
Shell> sysconfig -d set SystemDefaults all
Para establecer los ajustes predeterminados de NicBoot1:
Shell> sysconfig -d set SystemDefaults NicBoot1
Para introducir 123 como nueva contraseña de administrador:
Shell> sysconfig -s AdminPassword=123 OldAdminPassword=""
Para eliminar Joe Smith como contraseña de encendido:
Shell> sysconfig -s PowerOnPassword="" OldPowerOnPassword="Joe Smith"
Para mostrar la lista del orden de arranque UEFI:
Shell> sysconfig -g UefiBootOrder
UefiBootOrder=
0: Embedded UEFI Shell
8: Rear USB 2
10: Embedded LOM 1 Port 1
Para configurar un nuevo orden de arranque UEFI para que Embedded LOM 1 Port 1 arranque
en primer lugar:
Shell> sysconfig -s UefiBootOrder=10,0
The new boot order is:
10: Embedded LOM 1 Port 1
0: Embedded UEFI Shell
8: Rear USB 2
Para obtener el valor actual del ajuste EmbeddedUefiShell con resultados en formato estándar:
Shell> sysconfig -g EmbeddedUefiShell -sfo
ShellCommand,"sysconfig"
SysConfigGet,"EmbeddedUefiShell[Embedded UEFI Shell]","Disabled[Disabled]"
Para mostrar información detallada sobre los ajustes de EmbeddedUefiShell con resultados
en formato estándar:
Shell> sysconfig -i EmbeddedUefiShell -sfo
ShellCommand,"sysconfig"
Enabled[Enabled];Disabled[Disabled]","Enum"
Para obtener el valor predeterminado de ServerName con resultados en formato estándar:
Shell> sysconfig -d get ServerName -sfo
ShellCommand,"sysconfig"
SysConfigDefault,"ServerName","","SystemDefaults"
Atributos de sysconfig
Para sysconfig, puede ver todos los nombres de atributos, descripciones, valores actuales y
posibles y tipos de ajustes Enum. El ejemplo siguiente muestra una parte de la salida posible
del comando.
Para obtener más información sobre cada atributo, consulte la Guía de usuario de las utilidades
del sistema HPE UEFI para servidores HPE ProLiant Gen9.
NOTA:
66
La salida del comando sysconfig varía según el modelo de servidor.
Setting Name
= EmbeddedSerialPort
Current Value
= Com1Irq4
Possible Values = Com1Irq4
Com2Irq3
Disabled
Setting Type
= Enum
[Puerto serie
[COM 1; IRQ4;
[COM 1; IRQ4;
[COM 2; IRQ3;
[Desactivado]
Setting Name
= VirtualSerialPort
Current Value
= Com2Irq3
Possible Values = Com1Irq4
[Puerto serie virtual]
[COM 2; IRQ3; I/O: 2F8h-2FFh]
[COM 1; IRQ4; I/O: 3F8h-3FFh]
Referencia de comandos de UEFI Shell
integrado]
I/O: 3F8h-3FFh]
I/O: 3F8h-3FFh]
I/O: 2F8h-2FFh]
Setting Type
Com2Irq3
Disabled
= Enum
[COM 2; IRQ3; I/O: 2F8h-2FFh]
[Desactivado]
Setting Name
= NicBoot1
Current Value
= NetworkBoot
Possible Values = NetworkBoot
Disabled
Setting Type
= Enum
[LOM 1 integrada puerto 1]
[Arranque desde la red]
[Arranque desde la red]
[Desactivado]
Setting Name
= PreBootNetwork
Current Value
= FlexLom1
Possible Values = FlexLom1
PciSlot1
PciSlot2
PciSlot3
PciSlot4
PciSlot5
PciSlot6
PciSlot7
PciSlot8
PciSlot9
Setting Type
= Enum
[Interfaz de red previa al arranque]
[Integrado: FlexLOM 1]
[Integrado: FlexLOM 1]
[Ranura PCIe 1]
[Ranura PCIe 2]
[Ranura PCIe 3]
[Ranura PCIe 4]
[Ranura PCIe 5]
[Ranura PCIe 6]
[Ranura PCIe 7]
[Ranura PCIe 8]
[Ranura PCIe 9]
Setting Name
= Dhcpv4
Current Value
= Enabled
Possible Values = Disabled
Enabled
Setting Type
= Enum
[DHCPv4]
[Activado]
[Desactivado]
[Activado]
sysinfo
Sintaxis
sysinfo[token][-sfo][-b][-v]
Descripción
Muestra información del sistema, que incluye nombre del sistema, número de serie, ID
del producto, versión del BIOS, versión de la copia de seguridad del BIOS, versión del firmware
del controlador de gestión de la alimentación, modo de arranque, memoria del sistema,
procesadores, direcciones IP de iLO y dispositivos de red.
Opciones
token
Especifica lo que se debe mostrar. Los tokens disponibles son:
•
summary: un resumen de información del sistema
•
all: toda la información del sistema
•
cpu: información de la CPU
•
mem: información de la memoria
•
fw: información del firmware
•
pci: información sobre los dispositivos PCI
-sfo
Muestra la información de los resultados en formato estándar.
-b
Muestra la información una pantalla a la vez.
-v
Muestra la información con formato detallado.
Ejemplos
Para mostrar un breve resumen de información del sistema:
Shell> sysinfo summary
Comandos de UEFI Shell
67
Para mostrar información sobre la memoria:
Shell> sysinfo mem
Para mostrar información sobre la memoria con el resultado en formato estándar:
Shell> sysinfo mem –sfo
Para mostrar información detallada sobre la memoria, incluida la información sobre las ranuras
vacías:
Shell> sysinfo mem –v
time
Sintaxis
time[hh:mm[:ss]][-tz tz][-d dl]
Descripción
Muestra o permite establecer la hora actual del sistema.
Opciones
hh
Establece un nuevo valor para la hora (0–23).
mm
Establece un nuevo valor para los minutos (0–59).
ss
Establece un nuevo valor para los segundos (0–59). Si no se especifica, se utilizará
el valor cero.
-tztz
Establece un ajuste de zona horaria, en minutos con respecto a la hora GMT. Los
valores válidos pueden estar entre -1440 y 1440 o bien el valor 2047. Si no se encuentra
el valor o se establece como 2047, se establecerá en la hora local.
-d dl
Establece un valor de horario de verano. Los valores válidos son:
•
0: la hora no se ve afectada por el horario de verano.
•
1: la hora se ve afectada por el horario de verano, pero no se ha ajustado.
•
3: la hora se ve afectada por el horario de verano y se ha ajustado.
Si no se especifica ningún valor después de –d, se mostrará el horario de verano
actual.
Uso
Si no se especifica ningún parámetro, este comando muestra la hora actual. La hora del sistema
se actualizará si se especifican valores de horas, minutos y segundos válidos.
A excepción de los caracteres numéricos y del carácter : (dos puntos), todos los caracteres
restantes del argumento no serán válidos. El shell mostrará de un error si el número se encuentra
en el intervalo incorrecto de horas/minutos/segundos. No se permiten espacios antes o después
del carácter numérico. Tampoco se permiten espacios insertados en la secuencia numérica.
Si no se especifica el parámetro ss, los segundos se establecerán en cero de forma
predeterminada.
Ejemplos
Para mostrar la hora actual del sistema:
fs0:\> time
16:51:03 (GMT+08:00)
Para establecer la hora actual del sistema:
fs0:\> time 9:51:30
fs0:\> time
9:51:31 (GMT+08:00)
68
Referencia de comandos de UEFI Shell
Para establecer la hora del sistema y, a continuación, mostrar el valor del horario de verano:
fs0:\> time 9:51:30
fs0:\> time —d
09:51:31 (GMT+08:00) DST: Not Affected
timezone
Sintaxis
timezone[-s:hh:mm][-l-b-f]
Descripción
Muestra o permite establecer la información de zona horaria.
Opciones
-s
Establece la zona horaria asociada con un ajuste de hh:mm con respecto a la hora UTC.
-l
Muestra una lista con todas las zonas horarias.
-b
Muestra una pantalla a la vez.
-f
Muestra información completa de la zona horaria especificada.
Uso
Si no se especifica ningún parámetro, este comando muestra la zona horaria actual. Si se
especifica un parámetro hh:mm válido, se actualizará la información de zona horaria del sistema.
Ejemplos
Para mostrar todas las zonas horarias disponibles:
fs0:\> timezone -l
Para establecer la zona horaria:
fs0:\> timezone -s 7:00
Para mostrar información detallada de la zona horaria actual:
fs0:\> timezone -f
touch
Sintaxis
touch[-r]file[file...]
Descripción
Permite actualizar la fecha y la hora de un archivo con la fecha y la hora actuales.
Opciones
-r
Hace que la actualización se realice de forma recursiva en los subdirectorios.
archivo
Especifica el nombre o el patrón del archivo o directorio que se va a actualizar. Es
posible actualizar varios archivos a la vez.
Uso
Cuando se especifican varios archivos, el sistema procesa los archivos de uno en uno y hace
caso omiso de los errores.
Este comando no puede cambiar la hora y la fecha de los archivos y directorios de solo lectura.
Comandos de UEFI Shell
69
Ejemplo
Para actualizar la fecha y hora de un archivo:
fs0:\> touch myfile.txt
type
Sintaxis
type file[file...]
Descripción
Permite enviar el contenido de un archivo al dispositivo de salida estándar.
Opción
archivo
Especifica el nombre del archivo cuyo contenido se va a mostrar.
Uso
Si no se especifica ninguna opción, este comando intentará detectar el tipo de archivo. Si el
comando falla, se asumirá que el tipo de archivo es UCS-2.
Ejemplos
Para mostrar un archivo de formato:
fs0:\> type pause.nsh
#
# Example script for 'pause' command
#
echo pause.nsh begin..
\date
time
pause
echo pause.nsh done.
Para mostrar varios archivos:
fs0:\> type test.*
How to Install?
time
stall 3000000
time
unload
Sintaxis
unload[-n][-v|verbose]handle
Descripción
Descarga una imagen del controlador UEFI de la memoria.
Opciones
70
-n
Omite todos los mensajes que se muestran durante la descarga, de
manera que se puede utilizar la salida en un archivo de secuencia de
comandos.
-v
Muestra información detallada de la imagen antes de descargarla.
verbose
Vuelca información detallada de la imagen antes de descargarla.
Referencia de comandos de UEFI Shell
indentificador
Especifica el identificador del controlador que se va a descargar en
formato hexadecimal.
Uso
Solo se pueden descargar los controladores que admiten la descarga.
Ejemplos
Para buscar el identificador para la imagen del controlador UEFI que se va a descargar:
Shell> dh -b
Para descargar la imagen del controlador UEFI con identificador 27:
Shell> unload 27
ver
Sintaxis
ver[-s|-t]
Descripción
Muestra la información de versión de UEFI Shell y del firmware UEFI subyacente.
Opciones
-s
Muestra solo la versión de UEFI Shell.
-t
Muestra el contenido resumido (abreviado).
Uso
Este comando recupera información de la tabla del sistema UEFI o la imagen del shell.
Ejemplo
Para mostrar solo la versión de UEFI Shell:
fs0:\> ver —s
2.0
Para mostrar la información completa acerca de la versión de firmware de UEFI Shell:
fs0:\> ver
HP Embedded UEFI Shell v2.1
(C) Copyright 1982 — 2015 Hewlett Packard Enterprise Development L.P.
UEFI v2.40 (HP, 0x00010000)
HP ProLiant System BIOS - P79 (01/14/2014)
vol
Sintaxis
vol[fs][-n volumelabel]
vol[fs][-d]
Descripción
Muestra la información del volumen de un sistema de archivos.
Opciones
fs
Especifica el nombre del sistema de archivos para mostrar.
-n etiqueta-de-volumen
Especifica el nombre de la etiqueta del volumen. No es posible
utilizar los caracteres siguientes: % ^ * + = [ ] | : ;
Comandos de UEFI Shell
71
" < > ? / . No se permite el uso de espacios en la etiqueta
de volumen.
Especifica una etiqueta de volumen vacía.
-d
Uso
Si no se especifica la opción fs, el sistema tomará el sistema de archivos actual. Si se especifica
-n, la etiqueta del volumen de fs se configura para el parámetro etiqueta-de-volumen. La
longitud máxima del parámetro etiqueta-de-volumen es de 11 caracteres.
Ejemplos
Para mostrar el volumen del sistema de archivos actual:
fs0:\> vol
Volume has no label (rw)
1,457,664 bytes total disk space
1,149,440 bytes available on disk
512 bytes in each allocation unit
Para cambiar la etiqueta de fs0:
shell> vol fs0 –n help_test
Volume HELP_TEST (rw)
1,457,664 bytes total disk space
1,149,440 bytes available on disk
512 bytes in each allocation unit
Para eliminar la etiqueta de volumen de fs0:
fs0:\> vol fs0 -d
Volume has no label (rw)
1,457,664 bytes total disk space
220,160 bytes available on disk
512 bytes in each allocation unit
webclient
Sintaxis
webclient[-g URL][-o file]|[-m][-l]
Descripción
Descarga archivos de HTTP o FTP y monta un sistema de archivos ISO.
Opciones
72
-g
Recupera un documento especificado por la dirección URL.
URL
Especifica la dirección de hipertexto del documento que se debe recuperar. Puede
ser una dirección IPv4 o un nombre de host.
-o
Redirige el resultado al archivo especificado.
archivo
Especifica el nombre del archivo al que se redirige el resultado.
-m
Descarga y monta un archivo ISO como un sistema de archivos.
-l
Muestra información sobre la configuración de red utilizada.
Referencia de comandos de UEFI Shell
Uso
IMPORTANTE: No es necesario utilizar ifconfig en una interfaz de red si va a ejecutar
webclient o ftp sobre la misma interfaz debido a que la configuración de la dirección IP y de
la interfaz se selecciona automáticamente mediante la opción Pre-Boot Network Settings
(Configuración de red previa al arranque) que se configura en las utilidades del sistema.
Si la interfaz utilizada por ftp y webclient se ha configurado mediante ifconfig, dicha
configuración se borra y, en su lugar, cuando se ejecutan los comandos, se aplica a la interfaz
el menú Pre-Boot Network Settings (Configuración de red previa al arranque) de las utilidades
del sistema.
Este comando permite realizar transferencias de red mediante secuencias de comandos. Una
ventaja importante del uso de este comando es que se puede especificar una URL con una
dirección HTTP para recuperar un documento, enviarlo a un archivo en dicha dirección y descargar
un archivo o montar un archivo ISO. Pulse ESC o Ctrl-C para cancelar una transferencia de
archivos. Para las URL de FTP, se admite la autenticación especificando un nombre de usuario
y una contraseña en texto sin cifrar en la dirección URL. El tamaño máximo de un archivo que
se puede guardar en una partición FAT32 es de 4 GB. Debe utilizar una dirección IPv4.
Ejemplos
Para descargar un archivo ISO de un servidor HTTP o FTP y montar un sistema de archivos ISO:
fs0:\> webclient -g http:\/\/192.168.1.20/filename.iso -m
o bien
fs0:\> webclient -g http:\/\/www.hpe.com/filename.iso -m
o bien
fs0:\> webclient -g ftp:\/\/192.168.1.20/filename.iso -m
Para descargar un archivo desde un servidor FTP o HTTP y guardarlo en el sistema de archivos
actual:
fs0:\> webclient -g http:\/\/192.168.1.20/file.html -o file.html
o bien
fs0:\> webclient -g ftp:\/\/192.168.1.20/file.html -o file.html
o bien
fs0:\> webclient -g ftp:\/\/ftp.hpe.com/file.html
-o file.html
Para descargar un archivo desde un servidor FTP con el nombre de usuario usuario y la
contraseña contr:
fs0:\> webclient -g ftp:\/\/usuario:[email protected]/file.html -o file.html
Para mostrar la configuración de la red:
fs0:\> webclient -l
Comandos de UEFI Shell
73
3 Ejecución y edición de secuencias de comandos de
UEFI Shell
La siguiente información describe cómo ejecutar y modificar las funciones de secuencias de
comandos de UEFI Shell. También se facilita una aplicación de ejemplo que muestra el texto
"Hello World".
Métodos para la invocación de secuencias de comandos
Es posible llamar a las secuencias de comandos de UEFI Shell con cualquiera de los dos métodos
siguientes:
•
Configuración del inicio automático de la secuencia de comandos de UEFI Shell en las
utilidades del sistema
•
Llamada manual a una secuencia de comandos del shell
Configuración del inicio automático de la secuencia de comandos de UEFI Shell
en las utilidades del sistema
La secuencia de comandos de inicio permite crear un disco de RAM, descargar archivos de la
red, recopilar datos, volver a cargar resultados en la red y, a continuación, arrancar el sistema
operativo sin necesidad de reiniciar el sistema. Puede almacenar el archivo de secuencia de
comandos en un soporte local o acceder a él desde una ubicación de red.
De forma predeterminada, la opción UEFI Shell Script Auto-Start (Inicio automático de la
secuencia de comandos de UEFI Shell) está activada en las utilidades del sistema y está
configurada para que el shell busque el archivo startup.nsh en cualquier sistema de archivos
FAT16 o FAT32 disponible. Puede modificar esta configuración para que el shell busque la
secuencia de comandos de inicio en un sistema de archivos específico en los soportes conectados
o en una ubicación de red determinada. Cuando se configura para una ubicación de red, se
puede especificar la dirección URL del archivo startup.nsh en formato HTTP o FTP. Para
obtener más información, consulte "Inicio automático de la secuencia de comandos de UEFI
Shell" en la Guía de usuario de las utilidades del sistema HPE UEFI para servidores HPE ProLiant
Gen9.
Llamada manual a una secuencia de comandos del shell
1.
2.
Vaya a la ubicación del archivo de secuencia de comandos .nsh.
Haga doble clic en el archivo o haga clic con el botón secundario en el archivo y, a
continuación, seleccione Open (Abrir).
Exportación e importación de configuraciones a archivos
Para exportar toda la configuración a un archivo:
fs0:\> sysconfig –export archivo.txt
Para importar toda la configuración a un archivo:
fs0:\> sysconfig –import archivo.txt
Edición de secuencias de comandos del shell
Puede editar los archivos de secuencias de comandos sin conexión o en el shell mediante el
comando edit. También puede utilizar el comando type para mostrar la secuencia de comandos
en la pantalla.
74
Ejecución y edición de secuencias de comandos de UEFI Shell
Ejemplos de secuencias de comandos de UEFI Shell
Los siguientes ejemplos muestran una secuencia de comandos de código fuente de aplicación
y una secuencia de comandos de inicio.
Secuencia de comandos con el código fuente de una aplicación
El siguiente código fuente de ejemplo muestra cómo implementar una aplicación de UEFI Shell
para imprimir "Hello World" en la pantalla y mostrar la versión y las variables de entorno de UEFI
Shell. Esta secuencia de comandos se ejecuta repetidamente a través de todos los sistemas
de archivos FS*: (FS0, FS1, FS2) para buscar un archivo de entrada específico (en este caso,
sysconfig_backup.txt).
Ejemplo de exportación:
fs0:\>
@echo -off
cls
set -v myfs 0
if exist FS0:\* then
FS0:
echo "FS0:\ Found!"
goto FSFOUND
endif
echo "FS0:\ not found in system"
echo "Going to search first available file system from FS1, FS2,..., FS100"
pause
for %a run (1 100)
set -v myfs %a
if exist FS%myfs%:\* then
FS%myfs%:
echo "FS%myfs%:\ Found!"
goto FSFOUND
endif
endfor
## No valid FS found in system, so exit now
echo "No valid File System (FS0, FS1,..., FS100) found in system"
goto END
:FSFOUND
if exist sysconfig_backup.txt then
echo ===========================================================================
echo "%cwd%sysconfig_backup.txt already exists! Continuing the execution of the"
echo "script will remove existing sysconfig_backup.txt file and create a new"
echo "latest system configuration sysconfig_backup.txt file."
echo ===========================================================================
pause
rm sysconfig_backup.txt
endif
echo "Saving latest system configuration in sysconfig_backup.txt file."
sysconfig -export sysconfig_backup.txt
:END
set -d myfs
Ejemplo de importación:
fs0:\>
@echo -off
cls
set -v myfs 0
if exist FS0:\sysconfig_backup.txt then
FS0:
echo "FS0:\sysconfig_backup.txt Found!"
goto FSFOUND
endif
echo ===========================================================================
echo "FS0:\sysconfig_backup.txt not found in system"
echo "Going to search sysconfig_backup.txt from all available file system"
echo "from FS1, FS2,..., FS100"
echo ===========================================================================
Ejemplos de secuencias de comandos de UEFI Shell
75
pause
for %a run (1 100)
set -v myfs %a
if exist FS%myfs%:\sysconfig_backup.txt then
FS%myfs%:
echo "FS%myfs%:\sysconfig_backup.txt Found!"
goto FSFOUND
endif
endfor
## No valid sysconfig_backup.txt found in system, so exit now
echo "No valid sysconfig_backup.txt found from File System (FS0, FS1,..., FS100)"
goto END
:FSFOUND
if exist sysconfig_backup.txt then
echo ===========================================================================
echo "%cwd%sysconfig_backup.txt Found! Continuing the execution of the script"
echo "will cause system to override previous configuration and use the"
echo "configuration settings stored in sysconfig_backup.txt file."
echo ===========================================================================
pause
sysconfig -import sysconfig_backup.txt
endif
:END
set -d myfs
Secuencia de comandos de inicio
A continuación, se muestra un ejemplo de secuencia de comandos de configuración que
Embedded UEFI Shell puede ejecutar desde una ubicación de red especificada. Puede utilizar
esta secuencia de comandos para crear un disco RAM y, a continuación, buscar el sistema de
archivos FS de dicho disco que se utilizará para redireccionar la salida de archivos.
@echo -off
#
# Setup the environment variables. All of them are created as volatile.
#
#
# The volume label for the RAMDISK.
#
set -v VolumeLabel MYRAMDISK
#
# Variable to store the file system index that will be looped
# to determine the FS<x> number for the RAMDISK that is created.
#
set -v FsIndex 0
#
# Variable to store the output string of the ramdisk -c command.
# Successful creation of RAMDISK will give the following output:
# "RAM disk 'FSx:' created successfully." where x=0,1,2,...
#
set -v RamDiskStr 0
#
# Size of the RAMDISK in MegaBytes (MB).
#
set -v RamDiskSize 512
#
# Server URL hosting the OS loader and images.
# Can be HTTP or FTP. Names or IP addresses are allowed.
# Ensure DNS service is available and configured (see pre-requisites)
# when server names are used.
#
set -v Url http://192.168.1.1
#
# Files to be downloaded
#
set -v DownloadFile1 efilinux.efi
set -v DownloadFile2 deploy.kernel
set -v DownloadFile3 deploy.ramdisk
76
Ejecución y edición de secuencias de comandos de UEFI Shell
#
# Step 1. Create RAMDISK to store the downloaded OS programs.
#
echo "Creating a RAM Disk to save downloaded files..."
ramdisk -c -s %RamDiskSize% -v %VolumeLabel% -t F32 >v RamDiskStr
if %lasterror% ne 0x0 then
echo "Cannot create a RAMDISK of size %RamDiskSize%."
goto EXITSCRIPT
endif
echo "RAM Disk with Volume Label %VolumeLabel% created successfully."
#
# Step 2. Check each word in the output (RamDiskStr) and see if it matches
# the FSx: pattern. The newly created RAMDISK will be FS1: or higher.
# Here the check goes upto FS3: (the inner for loop), but a larger limit
# may be used in case many other file systems already exist before
# the creation of this RAMDISK. The FS for the RAMDISK is found when the
# FsIndex matches the FS<x> in RamDiskStr. Change the working directory
# to FS<FsIndex>:, so all downloads get saved there.
#
# FS0: is ignored. In the worst case, when no other usable
# file system is present, FS0: will map to the file system
# that this script is executing from.
#
#
for %a in %RamDiskStr%
for %b run (1 10)
set -v FsIndex %b
if 'FS%FsIndex%:' == %a then
FS%FsIndex%:
goto RDFOUND
endif
endfor
endfor
#
# The following message appears if the newly created RAMDISK cannot be found.
#
echo "RAMDISK with Volume Label %VolumeLabel% not found!"
goto EXITSCRIPT
#
# The following message appears if the RAMDISK FS<x> has been found and you are in the
# RAMDISK's root folder.
#
:RDFOUND
echo "RAMDISK with Volume Label %VolumeLabel% found at FS%FsIndex%:."
#
# Step 3: Download the required files into the RAMDISK.
#
echo "Downloading %Url%/deploy/%DownloadFile1% (File 1 of 3...)"
webclient -g %Url%/deploy/%DownloadFile1% -o %DownloadFile1%
if %lasterror% ne 0x0 then
goto EXITSCRIPT
endif
echo "Downloading %Url%/deploy/%DownloadFile2% (File 2 of 3...)"
webclient -g %Url%/deploy/%DownloadFile2% -o %DownloadFile2%
if %lasterror% ne 0x0 then
goto EXITSCRIPT
endif
echo "Downloading %Url%/deploy/%DownloadFile3% (File 3 of 3...)"
webclient -g %Url%/deploy/%DownloadFile3% -o %DownloadFile3%
if %lasterror% ne 0x0 then
goto EXITSCRIPT
endif
#
# Step4: Launch the boot loader.
#
echo "Starting the OS..."
%DownloadFile1% -f %DownloadFile2% initrd=%DownloadFile3%
#
# You reach here only if the downloads and booting failed.
#
:EXITSCRIPT
echo "Exiting Script."
Ejemplos de secuencias de comandos de UEFI Shell
77
La secuencia de comandos de ejemplo hace lo siguiente:
1. Crea un disco de RAM temporal para guardar el cargador de arranque que se ha descargado,
el kernel del sistema operativo, el sistema de archivos y los archivos de configuración
necesarios para que el cargador de arranque y el kernel se inicialicen a sí mismos y continúen
con la instalación a través de la red.
2. Determina el ID de FS<x> para el disco de RAM recién creado.
3. Define el directorio de trabajo en el directorio raíz del disco de RAM (por ejemplo FS1:\).
4. Descarga los archivos necesarios para iniciar el sistema operativo: el cargador de arranque,
el kernel del sistema operativo y un sistema de archivos en memoria para el kernel del
sistema operativo.
5. Realiza una de las siguientes operaciones:
•
Si falla la descarga de todos los archivos necesarios, realiza una limpieza y sale de la
secuencia de comandos de inicio.
•
Si la descarga se realiza correctamente, inicia el cargador de arranque y le pasa como
argumentos de línea de comandos la ruta del archivo del kernel del sistema operativo,
su sistema de archivos en memoria y los argumentos del kernel del sistema operativo
(que el cargador de arranque debe pasar al kernel al iniciarlo).
La función de UEFI Shell y la secuencia de comandos previa al arranque termina aquí,
y el sistema operativo ahora es capaz de continuar con la implementación por sí mismo,
con la ayuda de las secuencias de comandos de implementación específicas del sistema
operativo integradas en su sistema de archivos en memoria.
78
Ejecución y edición de secuencias de comandos de UEFI Shell
4 Modelo de programación UEFI
UEFI Shell ofrece una API de programación. Puede utilizar dicha API para escribir sus propias
aplicaciones UEFI para llamar a determinadas API o protocolos de programación del shell. Para
obtener más información, consulte la Especificación de UEFI Shell y EDK2. Tal como se muestra
en la tabla siguiente, UEFI Shell dispone de una API de programación. La función
EFI_SHELL_PROTOCOL proporciona servicios de shell a las aplicaciones de UEFI. Esta función
proporciona a las aplicaciones de UEFI Shell acceso a las funciones de bajo nivel del shell como,
por ejemplo, los archivos, las canalizaciones, las variables de entorno, el directorio de trabajo
actual, las asignaciones, el texto de ayuda, los alias o las secuencias de comandos y aplicaciones
del shell de inicio.
Tabla 9 API de aplicaciones UEFI
Tipo de función
Nombre de función
Descripción
EFI_SHELL_EXECUTE
Execute
Hace que el shell analice y ejecute la
línea de comandos.
EFI_SHELL_GET_ENV
GetEnv
Obtiene la variable de entorno.
EFI_SHELL_SET_ENV
SetEnv
Modifica una variable de entorno
específica.
EFI_SHELL_GET_ALIAS
GetAlias
Recupera el alias de un comando del
shell específico.
EFI_SHELL_SET_ALIAS
SetAlias
Añade o quita el alias de un comando
del shell específico.
EFI_SHELL_GET_HELP_TEXT
GetHelpText
Devuelve información de ayuda sobre
un comando específico.
EFI_SHELL_GET_DEVICE_PATH_FROM_MAP GetDevicePathFromMap
Devuelve la ruta del dispositivo
correspondiente a una asignación.
EFI_SHELL_GET_MAP_FROM_DEVICE_PATH GetMapFromDevicePath
Devuelve la asignación que
corresponde a una ruta de dispositivo
determinada.
EFI_SHELL_GET_DEVICE_PATH_FROM_FILE_PATH GetDevicePathFromFilePath Convierte una ruta de archivo en una
ruta de dispositivo, donde se han
sustituido todas las asignaciones por
las rutas de dispositivo
correspondientes.
EFI_SHELL_GET_FILE_PATH_FROM_DEVICE_PATH GetFilePathFromDevicePath Convierte una ruta de dispositivo en
una ruta de archivo, la parte de la ruta
del dispositivo correspondiente a una
de las asignaciones se sustituye por
dicha asignación.
EFI_SHELL_SET_MAP
SetMap
Crea, actualiza o elimina una
asignación entre un dispositivo y una
ruta de dispositivo.
EFI_SHELL_GET_CUR_DIR
GetCurDir
Devuelve el directorio actual de un
dispositivo.
EFI_SHELL_SET_CUR_DIR
SetCurDir
Cambia el directorio actual de un
dispositivo.
EFI_SHELL_OPEN_FILE_LIST
OpenFileList
Abre los archivos que coinciden con
el patrón de ruta especificado.
EFI_SHELL_FREE_FILE_LIST
FreeFileList
Libera la lista de archivos que se creó
mediante OpenFileList().
79
Tabla 9 API de aplicaciones UEFI (continuación)
80
Tipo de función
Nombre de función
Descripción
EFI_SHELL_REMOVE_DUP_IN_FILE_LIST
RemoveDupInFileList
Elimina los archivos duplicados de la
lista de archivos especificada.
EFI_SHELL_BATCH_IS_ACTIVE
BatchIsActive
Muestra si se está procesando algún
archivo de secuencia de comandos.
EFI_SHELL_IS_ROOT_SHELL
IsRootShell
Comprueba si el shell activo es el shell
raíz.
EFI_SHELL_ENABLE_PAGE_BREAK
EnablePageBreak
Habilita el modo de visualización de
resultados con saltos de página.
EFI_SHELL_DISABLE_PAGE_BREAK
DisablePageBreak
Deshabilita el modo de visualización
de resultados con saltos de página.
EFI_SHELL_GET_PAGE_BREAK
GetPageBreak
Obtiene el estado de habilitación del
modo de visualización de resultados
con saltos de página.
EFI_SHELL_GET_DEVICE_NAME
GetDeviceName
Obtiene el nombre del dispositivo
especificado por el identificador del
dispositivo.
EFI_SHELL_GET_FILE_INFO
GetFileInfo
Muestra información sobre un
identificador de archivo específico.
EFI_SHELL_SET_FILE_INFO
SetFileInfo
Modifica información sobre un
identificador de archivo específico.
EFI_SHELL_OPEN_FILE_BY_NAME
OpenFileByName
Abre un archivo especificado por el
nombre y devuelve un identificador del
archivo.
EFI_SHELL_CLOSE_FILE
CloseFile
Cierra un archivo abierto.
EFI_SHELL_CREATE_FILE
CreateFile
Crea un nuevo archivo.
EFI_SHELL_READ_FILE
ReadFile
Lee los datos de un archivo.
EFI_SHELL_WRITE_FILE
WriteFile
Escribe datos en un archivo.
EFI_SHELL_DELETE_FILE
DeleteFile
Elimina un archivo.
EFI_SHELL_DELETE_FILE_BY_NAME
DeleteFileByName
Permite eliminar un archivo por su
nombre.
EFI_SHELL_GET_FILE_POSITION
GetFilePosition
Muestra la posición de lectura/escritura
actual dentro de un archivo.
EFI_SHELL_SET_FILE_POSITION
SetFilePosition
Modifica la posición de
lectura/escritura actual dentro de un
archivo.
EFI_SHELL_FLUSH_FILE
FlushFile
Escribe todos los datos almacenados
en búfer en un archivo.
EFI_SHELL_FIND_FILES
FindFiles
Muestra todos los archivos que
coincidan con un patrón en una lista
de archivos.
EFI_SHELL_FIND_FILES_IN_DIR
FindFilesInDir
Muestra todos los archivos de un
directorio especificado en una lista de
archivos.
EFI_SHELL_GET_FILE_SIZE
GetFileSize
Muestra el tamaño de un archivo.
Modelo de programación UEFI
Tabla 9 API de aplicaciones UEFI (continuación)
Tipo de función
Nombre de función
Descripción
EFI_SHELL_OPEN_ROOT
OpenRoot
Muestra el directorio raíz de un
sistema de archivos.
EFI_SHELL_OPEN_ROOT_BY_HANDLE
OpenRootByHandle
Muestra el directorio raíz de un
sistema de archivos en un identificador
determinado.
EFI_EVENT
ExecutionBreak
Evento que muestra UEFI Shell
cuando el usuario pulsa CTRL-C para
indicar que la ejecución del comando
de UEFI Shell actual debe
interrumpirse.
UINT32
MajorVersion
Versión principal del entorno del shell.
UINT32
MinorVersion
Versión secundaria del entorno del
shell.
81
5 Códigos de estado de comandos de UEFI Shell
En la tabla siguiente se enumeran los códigos de estado que puede mostrar UEFI Shell cuando
se ejecuta un comando. Los códigos varían según el comando.
Tabla 10 Códigos de estado de comandos de UEFI Shell
82
Código de estado
Descripción
SHELL_SUCCESS
La acción se completó tal como se solicitó.
SHELL_NOT_FOUND
No se pudo encontrar el archivo o conjunto de archivos de destino.
SHELL_SECURITY_VIOLATION
La función no se puede realizar debido a una infracción de seguridad.
Cuando esté habilitado el arranque seguro, las aplicaciones UEFI que
no estén firmadas digitalmente con uno de los certificados de arranque
seguro integrados no podrán ejecutarse y el sistema mostrará el código
de estado SECURITY_VIOLATION.
SHELL_INVALID_PARAMETER
Uno de los parámetros pasados tiene un formato incorrecto o tiene un
valor que está fuera de los límites.
SHELL_OUT_OF_RESOURCES
No se pudo completar una solicitud para establecer una variable de forma
no volátil. La solicitud no volátil resultante se convierte en una solicitud
volátil.
SHELL_WRITE_PROTECTED
El soporte en el que se llevará a cabo la acción está protegido contra
escritura.
SHELL_DEVICE_ERROR
Error de hardware que impide la finalización de este comando.
Códigos de estado de comandos de UEFI Shell
6 Asistencia y otros recursos
Acceso al soprte de Hewlett Packard Enterprise
•
Para obtener asistencia en tiempo real, vaya a la página web Contact Hewlett Packard
Enterprise Worldwide (Póngase en contacto con Hewlett Packard Enterprise en todo el
mundo):
http://www.hpe.com/assistance
•
Para acceder a la documentación y los servicios de soporte técnico, vaya a la página web
del centro de soporte de Hewlett Packard Enterprise:
http://www.hpe.com/support/hpesc
Información que debe recopilar
•
Número de registro de asistencia técnica (si corresponde)
•
Nombre del producto, modelo o versión y número de serie
•
Nombre y versión del sistema operativo
•
Versión de firmware
•
Mensajes de error
•
Informes y registros específicos del producto
•
Productos o componentes adicionales
•
Productos o componentes de otros fabricantes
Acceso a las actualizaciones
•
Algunos productos de software proporcionan un mecanismo para acceder a las
actualizaciones de software a través de la interfaz del producto. Revise la documentación
del producto para identificar el método recomendado de actualización del software.
•
Para descargar actualizaciones del producto, vaya a cualquiera de las páginas web
siguientes:
◦
Página Get connected with updates from HPE (Conéctese con las actualizaciones
de HPE) del centro de soporte de Hewlett Packard Enterprise:
http://www.hpe.com/support/e-updates
◦
Página web de Software Depot:
http://www.hpe.com/support/softwaredepot
•
Para ver y actualizar sus concesiones, así como para vincular sus contratos y garantías
con su perfil, vaya a la página More Information on Access to HPE Support Materials
(Más información sobre cómo acceder a los materiales de soporte de HPE) del centro de
soporte de Hewlett Packard Enterprise:
http://www.hpe.com/support/AccessToSupportMaterials
IMPORTANTE: El acceso a algunas actualizaciones podría requerir la concesión de
producto cuando se accede a través del centro de soporte de Hewlett Packard Enterprise.
Debe disponer de una cuenta de HP Passport configurada con las concesiones necesarias.
Acceso al soprte de Hewlett Packard Enterprise
83
Información relacionada
La documentación más reciente para las utilidades del sistema UEFI UEFI y Embedded Shell
está disponible en: http://www.hpe.com/info/ProLiantUEFI/docs . Los documentos disponibles
incluyen:
•
Guía de usuario de las utilidades del sistema HPE UEFI para servidores HPE ProLiant Gen9
•
Tarjeta de referencia rápida de HPE UEFI Shell para servidores HPE ProLiant Gen9
•
Notas de la versión del shell y las utilidades del sistema HPE UEFI para servidores
HPE ProLiant Gen9
•
Guía de implementación de HPE UEFI para servidores HPE ProLiant Gen9
La HPE UEFI System Utilities and Shell Command Mobile Help for HPE ProLiant Gen9 Servers
(Ayuda para dispositivos móviles de los comandos del shell y las utilidades del sistema HP UEFI
para servidores HP ProLiant Gen9) está disponible al escanear el código QR que se encuentra
en la parte inferior de la pantalla System Utilities (Utilidades del sistema) o en http://
www.hpe.com/qref/ProLiantUEFI/Help.
Páginas web
Página web
Enlace
UEFI Specification (Especificación de multiprocesador)
http://www.uefi.org/specifications
Recursos de aprendizaje de UEFI
http://www.uefi.org/learning_center
Proyecto UEFI EDK2 en SourceForge (descarga de
especificaciones y código)
http://sourceforge.net/apps/mediawiki/tianocore
Biblioteca de información de Hewlett Packard Enterprise http://www.hpe.com/info/enterprise/docs
Centro de soporte de Hewlett Packard Enterprise
http://www.hpe.com/support/hpesc
Contacto con Hewlett Packard Enterprise en todo el
mundo
http://www.hpe.com/assistance
Servicio de suscripción/alertas de soporte
http://www.hpe.com/support/e-updates
Software Depot
http://www.hpe.com/support/softwaredepot
Reparaciones del propio cliente
http://www.hpe.com/support/selfrepair
Insight Remote Support
http://www.hpe.com/info/insightremotesupport/docs
Reparaciones del propio cliente
El programa de reparaciones del propio cliente (CSR) de Hewlett Packard Enterprise le permite
reparar su producto. Si es necesario reemplazar una pieza incluida en el programa CSR, se le
enviará directamente para que pueda instalarla cuando le resulte más cómodo. Algunas piezas
no entran en el programa CSR. El servicio técnico autorizado de Hewlett Packard Enterprise
determinará si una reparación entra en el programa CSR.
Para obtener más información sobre el programa CSR, póngase en contacto con el proveedor
de servicios local o vaya a la página web del CSR:
http://www.hpe.com/support/selfrepair
Remote Support
El soporte remoto está disponible con los dispositivos compatibles como parte de su garantía o
de un contrato de soporte. Proporciona diagnóstico inteligente de eventos y envío automático y
seguro de notificaciones de eventos de hardware a Hewlett Packard Enterprise, que iniciará un
84
Asistencia y otros recursos
proceso de solución rápido y preciso basándose en el nivel de servicio de su producto.
Hewlett Packard Enterprise le recomienda que registre su dispositivo en Remote Support.
Para obtener más información y conocer los detalles de los dispositivos compatibles, vaya a la
página web siguiente:
http://www.hpe.com/info/insightremotesupport/docs
Comentarios sobre la documentación
Hewlett Packard Enterprise se compromete a proporcionar documentación que se adapte a sus
necesidades. Para ayudarnos a mejorar la documentación, envíe cualquier error, sugerencia o
comentario a Comentarios sobre la documentación ([email protected]). Cuando envíe
sus comentarios, incluya el título del documento, el número de referencia, la edición y la fecha
de publicación, que se encuentran en la portada del documento. Para el contenido de ayuda en
línea, incluya el nombre y la versión del producto, la edición y la fecha de publicación de la
ayuda, que se encuentran en la página de avisos legales.
Comentarios sobre la documentación
85
Glosario
ASR
Automatic Server Recovery (Recuperación automática del servidor)
EFI
Extensible Firmware Interface (Interfaz de firmware extensible)
EMS
Emergency Management Services (Servicios de gestión de emergencias)
iLO
Integrated Lights-Out
IML
Integrated Management Log (Registro de gestión integrado)
MTC
Monotonic Counter (Contador monotónico)
PCIe
Peripheral Component Interconnect Express (Interconexión de componentes periféricos exprés)
POST
Power-On Self-Test (Autocomprobación al arrancar)
PXE
Preboot Execution Environment (Entorno de ejecución previo al arranque)
QPI
QuickPath Interconnect (Interconexión QuickPath) de Intel
RIS
Remote Installation Services (Servicios de instalación remota)
RTC
Real-Time Clock (Reloj de tiempo real)
SMBIOS
System Management BIOS (BIOS de gestión del sistema)
TPM
Trusted platform module (Módulo de plataforma de confianza)
UEFI
Unified Extensible Firmware Interface (Interfaz de firmware extensible unificada)
VSP
Virtual Serial Port (Puerto serie virtual)
86
Glosario
Índice
A
acceso
actualizaciones, 83
acceso a UEFI Shell, 6
acceso a un sistema de archivos, 16
actualización de componentes de firmware, 40
actualizaciones
acceso, 83
aliases, 19
análisis, 53
API de RESTful, 57
aplicación, API, 79
árbol de dispositivos, 31
archivos
actualización de la fecha y la hora, 69
comparación, 24
compresión y descompresión, 25
configuración del tamaño, 62
copia, 27
EFI, descompresión, 38
eliminación, 59
envío del contenido a un dispositivo de salida, 70
información del volumen, 71
listado, 44
manipulación, 6
transferencia a través de FTP, 39
arranque seguro
visualización de bases de datos, claves e informes de
seguridad, 60
asignación de nombres e identificadores de dispositivos,
47
atributos, 20
atributos de archivo y directorio , 20
ayuda, 12, 13, 41
B
bloques de dispositivo, 29
boot, 21
C
cambio de directorio, 22
color de fondo, 23
comandos de UEFI shell
restclient, 57
comandos de UEFI Shell, 18
ahsdownload, 18
attrib, 20
boot, 21
cd, 22
cls, 23
comp, 24
compress, 25
connect, 26
cp, 27
date, 28
dblk, 29
devices, 30
devtree, 31
dh, 32
disconnect, 34
dmem, 35
drivers, 35
echo, 36
edit, 37
eficompress, 38
efidecompress, 38
exit, 38
ftp, 39
fwupdate, 40
getmtc, 41
goto, 41
help, 41
ifconfig, 42
imlview, 43
load, 44
ls, 44
map, 47
memmap, 49
mkdir, 50
mode, 51
mv, 52
openinfo, 52
parse, 53
partitions, 53
pause, 54
pci, 55
ping, 55
ramdisk, 56
reset, 57
rm/del, 59
secboot, 60
set, 61
setsize, 62
shift, 63
smbiosview, 63
stall, 64
sysconfig, 64
sysinfo, 67
time, 68
timezone, 69
touch, 69
type, 70
unload, 70
ver, 71
vol, 71
webclient, 72
Comandos del shell de Hewlett Packard Enterprise, 8
comandos y capacidades, 6
comparación de archivos, 24
compresión de archivos, 25
conexión con la consola serie, 7
configuración de red previa al arranque, 42
configuración del BIOS del sistema, 64
87
configuración del tamaño de archivos, 62
confirmación, solicitud, 11
contacto con Hewlett Packard Enterprise, 83
contador monotónico, 41
contraseña de administrador, 64
contraseña de arranque, 64
contraseñas, 64
control del resultado de los comandos, 9
controladores, 35
carga, 44
descarga, 70
enlace, 26
copia de archivos y directorios, 27
creación y eliminación de discos de RAM, 56
D
del, alias, 59
descarga de archivos desde HTTP o FTP, 72
descarga de una imagen de controlador, 70
descompresión de archivos, 25
descompresión de EFI, 38
desconexión de controladores de dispositivos, 34
detalles de los resultados
comando devices, 31
comando dh, 34
comando drivers, 36
comando ls (información de archivo), 47
comando ls (información del volumen), 46
comando memmap, 50
comando sysconfig, 66
detención de la ejecución de secuencias de comandos,
64
dir, alias, 44
directorios
cambio, 22
creación, 50
eliminación, 59
listado, 44
discos de RAM, 56
dispositivos, 30
documentación
envío de comentarios sobre, 85
documentación relacionada, 84
documento
información relacionada, 84
E
echo, 36
edición de archivos, 37
edición, secuencias de comandos del shell, 74
ejemplo, secuencias de comandos del shell, 75
ejemplos de la sintaxis de la línea de comandos, 8
eliminación de la solicitud de confirmación al usuario, 11
enlace de controladores, 26
actualización, 40
visualización de la versión de UEFI, 71
G
goto, 41
H
hora del sistema, 68
horario de verano, 68
HTTP
descarga de archivos, 72
I
identificadores de dispositivos, 32
ifconfig, 42
imlview, 43
información de la versión, 71
información de SMBIOS, 63
información del sistema, 67
información sobre archivos o directorios, 44
información sobre PCI, 55
introducción, 6
ISO
montaje de un sistema de archivos, 72
L
línea de comandos, autocompletado, 8
línea de comandos, ayuda, 12, 13
llamada, secuencias de comandos, 74
load, 44
LL
llamada, secuencias de comandos, 74
M
manual, llamada a secuencia de comandos del shell, 74
map, 47
memoria
asignación, 49
visualización, 35
MiniZip, 25
mkdir, 50
modificación de la dirección de la pila de red IPv4, 42
modo
salida de la consola, 51
modo de salida de la consola, 51
montaje de un sistema de archivos ISO, 72
MTC, 41
O
opciones
arranque, 21
openinfo, 52
P
F
fecha, 28
fecha del sistema, 28
firmware
88
Índice
páginas web, 84
reparaciones del propio cliente, 84
partitions, 53
pausa, 54
ping, 55
primeros pasos, 9
protocolos y agentes de un identificador, 52
R
referencia de comandos de UEFI Shell, 8
registro de gestión integrado, 43
reinicio del sistema, 57
Remote Support, 84
reparaciones del propio cliente, 84
restablecimiento del sistema, 57
resultado
control, 9
detallado, 10
resumido, 11
una sola pantalla a la vez, 9
S
salida del shell o de una secuencia de comandos, 38
saltos de página globales, 10
secuencias de comandos, 6
búsqueda de una etiqueta, 41
desplazamiento de contenido, 63
detención de la ejecución, 64
pausa, 54
salida, 38
visualización, 36
secuencias de comandos, comandos, 74
shell, llamada manual a una secuencia de comandos, 74
shell, secuencias de comandos
edición, 74
ejemplos, 75
llamada manual, 74
sistema de archivos, 16
soporte
Hewlett Packard Enterprise, 83
sysconfig
atributos, 66
visualización y configuración, 64
códigos de estado, significado, 82
UEFI, API de aplicación, 79
UEFI, modelo de programación, 79
URL
recuperación de archivos, 72
V
variables
entorno, 61
visualización de ayuda sobre los comandos, 41
visualización de bases de datos, claves e informes de
seguridad de Secure Boot, 60
visualización de la ayuda de los comandos, 12
comandos que empiezan por un carácter específico,
14
para un comando específico, 13
todos los comandos, 12
volumen, 71
W
webclient, 72
Z
zona horaria, 69
T
tareas comunes, 17
touch, 69
transferencia FTP, 39, 72
traslado de archivos, 52
type, 70
U
UEFI Shell integrado
acceso , 6
antes del arranque, 6
arranque en, 6
requisitos previos, 6
UEFI Shell, códigos de estado de comandos
códigos de estado, 82
UEFI Shell, comandos
alias, 19
UEFI Shell, comandos de secuencias de comandos, 74
UEFI Shell, estado de los comandos
89