attc5a3.tmp

84
Guía de usuario de HP UEFI Shell para servidores HP ProLiant DL580 Gen8 Resumen Este documento detalla cómo utilizar y cómo acceder al Shell de Unified Extensible Firmware Interface (Interfaz de firmware extensible unificada, UEFI) integrado en la ROM de todos los servidores HP ProLiant DL580 Gen8 basados en UEFI. 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 de HP: 744994-073 Publicado: agosto de 2014 Edición: 1

Upload: nemes-rick

Post on 15-Jan-2016

216 views

Category:

Documents


0 download

DESCRIPTION

AttC5A3.Tmp

TRANSCRIPT

Page 1: AttC5A3.Tmp

Guía de usuario de HP UEFI Shell paraservidores HP ProLiant DL580 Gen8

ResumenEste documento detalla cómo utilizar y cómo acceder al Shell de Unified Extensible Firmware Interface (Interfaz de firmwareextensible unificada, UEFI) integrado en la ROM de todos los servidores HP ProLiant DL580 Gen8 basados en UEFI. Estedocumento está dirigido a la persona encargada de la instalación, administración y solución de problemas de los servidoresy sistemas de almacenamiento.

Nº de referencia de HP: 744994-073Publicado: agosto de 2014Edición: 1

Page 2: AttC5A3.Tmp

© Copyright 2014 Hewlett-Packard Development Company, L.P.

Avisos

Software informático confidencial. Para la posesión, uso o copia de su software es necesaria una licencia válida de HP. De conformidad con lanormativa FAR 12.211 y 12.212, el software informático comercial, la documentación del software informático comercial y los datos técnicossobre elementos comerciales se han concedido al gobierno de EE. UU. bajo la licencia comercial estándar del proveedor.

La información que incluye este documento está sujeta a cambios sin previo aviso. Las únicas garantías de los productos y servicios de HP estánestablecidas 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. HP no se hace responsable de los errores u omisiones de carácter técnico o editorial que puedanfigurar en este documento.

Reconocimientos

Intel®, Itanium®, Pentium®, Intel Inside® y el logotipo de Intel Inside son marcas comerciales o registradas de Intel Corporation o sus filiales en

los EE. UU. y en otros países.

Microsoft®, Windows®, Windows® XP y Windows NT® son marcas comerciales registradas de Microsoft Corporation en EE. UU.

.

® es una marca registrada de UEFI Forum, Inc.

UNIX® es una marca registrada de The Open Group.

Page 3: AttC5A3.Tmp

Contenido1 Introducción...............................................................................................5

Comandos y capacidades.........................................................................................................5Acceso a UEFI Shell..................................................................................................................5

Acceso a las utilidades del sistema HP UEFI............................................................................5Antes de arrancar UEFI Shell.................................................................................................7

Selección del modo de UEFI.............................................................................................7Habilitación de UEFI Shell integrado.................................................................................8

Configuración de UEFI Shell..................................................................................................8Adición de UEFI Shell integrado a la lista de secuencia de arranque.....................................8Cambio de la secuencia de arranque UEFI.........................................................................9

Arranque de UEFI Shell......................................................................................................10Acceso a UEFI Shell desde una conexión de consola de serie..................................................11

2 Referencia de los comandos de UEFI Shell...................................................13Sintaxis de la línea de comandos.............................................................................................13

Función de autocompletado de línea de comandos................................................................13Procedimientos iniciales ..........................................................................................................13

Control del resultado de los comandos.................................................................................14Limitación de los resultados a una sola pantalla a la vez....................................................14Visualización de resultados detallados.............................................................................15Visualización de un resumen de los resultados..................................................................16Eliminación de la solicitud de confirmación al usuario........................................................17

Visualización de la ayuda de los comandos..........................................................................17Visualización de la ayuda de todos los comandos.............................................................17Visualización de la ayuda de un comando específico........................................................18Visualización de todo el contenido de ayuda para los comandos que empiezan por un carácterdeterminado.................................................................................................................19

Acceso al sistema de archivos desde el Shell.........................................................................21Comandos de UEFI Shell.........................................................................................................21alias.....................................................................................................................................22attrib.....................................................................................................................................23cd........................................................................................................................................24cls........................................................................................................................................25comp....................................................................................................................................25cp........................................................................................................................................26date......................................................................................................................................28dblk......................................................................................................................................29devices..................................................................................................................................29devtree..................................................................................................................................31dh........................................................................................................................................32dmem...................................................................................................................................33drivers...................................................................................................................................34echo.....................................................................................................................................35edit.......................................................................................................................................36eficompress............................................................................................................................37efidecompress........................................................................................................................37exit.......................................................................................................................................37fwupdate...............................................................................................................................38getmtc...................................................................................................................................38goto.....................................................................................................................................38help......................................................................................................................................39ls/dir....................................................................................................................................40

Contenido 3

Page 4: AttC5A3.Tmp

map......................................................................................................................................42memmap...............................................................................................................................44mkdir....................................................................................................................................45mode....................................................................................................................................46mv........................................................................................................................................47openinfo...............................................................................................................................48parse....................................................................................................................................48pause...................................................................................................................................49pci........................................................................................................................................50reset.....................................................................................................................................50rm/del..................................................................................................................................51set........................................................................................................................................52setsize...................................................................................................................................53shift......................................................................................................................................54smbiosview............................................................................................................................54stall......................................................................................................................................55sysconfig...............................................................................................................................55

Atributos de sysconfig.........................................................................................................56time......................................................................................................................................66timezone...............................................................................................................................67touch....................................................................................................................................67type......................................................................................................................................68ver........................................................................................................................................68vol........................................................................................................................................69

3 Ejecución y edición de secuencias de comandos de UEFI Shell.......................70Comandos de secuencias de comandos de UEFI Shell.................................................................70Ejecución de secuencias de comandos......................................................................................70

Habilitación del inicio automático de las secuencias de comandos de UEFI Shell.......................70Ejecución manual de una secuencia de comandos de Shell.....................................................70

Edición de secuencias de comandos de Shell.............................................................................70Ejemplos de secuencias de comandos de Shell...........................................................................71

4 Uso del modelo de programación UEFI.......................................................73Ejemplos de secuencias de comandos de Shell...........................................................................75

5 Códigos de estado de comandos de UEFI Shell...........................................776 Asistencia y otros recursos.........................................................................78

Contacto con HP....................................................................................................................78Servicio de subscripción......................................................................................................78

Información relacionada..........................................................................................................78Páginas web.....................................................................................................................78

Convenciones tipográficas.......................................................................................................78Software HP Insight Remote Support..........................................................................................79

HP Insight Online...............................................................................................................807 Comentarios sobre la documentación..........................................................81Glosario.....................................................................................................82Índice........................................................................................................83

4 Contenido

Page 5: AttC5A3.Tmp

1 IntroducciónLa BIOS del sistema de todos los servidores HP ProLiant DL580 Gen8 incluye UEFI Shell integradoen la ROM. Dependiendo de la Especificación de UEFI Shell, el entorno de shell proporciona unaAPI e interfaces de línea de comandos (CLI) que permiten ejecutar secuencias de comandos,manipular archivos, obtener información del sistema. El shell ejecuta también otras aplicacionesUEFI. Estas funciones mejoran las capacidades de las utilidades del sistema UEFI. El acceso aUEFI Shell está activado por defecto.Para obtener más información, consulte la Guía de usuario de utilidades del sistema HP UEFI.

Comandos y capacidadesA continuación se detallan las capacidades que están disponibles en UEFI Shell:

• Creación de secuencias de comandos:

Archivos NSH con construcciones de secuencias de comandos estándar◦◦ Comandos echo, if / else / endif, shift, for/endfor

◦ Archivo de inicio de automático startup.nsh similar al archivo Autoexec.bat

◦ Salida de formato estándar (argumento - sfo) para la mayoría de los comandos– Salida de valores separados por comas que se pueden analizar 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 entrada/salida desde la consola y hacia la consola, así comode archivos

• Comandos de configuración:

Configuración de la BIOS (sysconfig)◦◦ Actualizaciones de firmware de la ROM (fwupdate)

Acceso a UEFI ShellEs posible acceder a UEFI Shell de una de las formas siguientes:• Durante el proceso POST del servidor, pulse F11 (menú de arranque) en la pantalla POST

del servidor HP ProLiant. Para obtener más información, consulte «Arranque de UEFI Shell»(página 10).

• Mediante una conexión de consola de serie. Para obtener más información, consulte «Accesoa UEFI Shell desde una conexión de consola de serie» (página 11).

• Mediante un puerto serie del servidor. Para obtener más información, consulte la Guía deusuario de utilidades del sistema HP UEFI.

Acceso a las utilidades del sistema HP UEFIPara tener acceso a las utilidades del sistema HP UEFI:

Comandos y capacidades 5

Page 6: AttC5A3.Tmp

1. Reinicie el servidor. El servidor se iniciará y se mostrará la pantalla POST de HP ProLiant enunos minutos.

2. Pulse F9 en la pantalla POST de HP ProLiant.

Aparecerá la pantalla System Utilities (Utilidades del sistema).3. Para navegar por las configuraciones y modificarlas a través de la interfaz de menús, utilice

las teclas que se definen en la tabla siguiente.

AcciónTecla

Pulse estas teclas para modificar la selección.Flechas arriba o abajo

Pulse esta tecla para seleccionar una entrada.Intro

Pulse esta tecla para volver a la pantalla anterior.ESC

Pulse esta tecla para ver la ayuda en línea de una opciónseleccionada.

F1

Pulse esta tecla para cargar los valores predeterminados de laconfiguración de la RBSU. Tendrá que reiniciar el sistema para

F7

que los cambios surtan efecto. Pulse la tecla Intro para aplicar losvalores predeterminados. Pulse la tecla ESC si desea cancelar.

Pulse la tecla para guardar los cambios.F10

Teclas de la pantalla POST

Pulse esta tecla durante el proceso POST del servidor o al reiniciarel sistema para que se muestre la pantalla System Utilities (Utilidadesdel sistema) en la consola remota de iLO 4.

F9

Pulse esta tecla durante el proceso POST del servidor para iniciarla pantalla One-Time Boot Menu (Menú de arranque único).

F11

4. Para salir de la pantalla System Utilities (Utilidades del sistema) y reiniciar el servidor, pulsela tecla Esc hasta que aparezca el menú principal. Para salir de la utilidad, seleccione Exitand Resume Boot (Salir y reanudar el arranque) en el menú principal.

6 Introducción

Page 7: AttC5A3.Tmp

Antes de arrancar UEFI ShellAntes de arrancar UEFI Shell, siga estos pasos:1. Asegúrese de que esté seleccionado UEFI como modo de arranque. De forma predeterminada,

HP ProLiant DL580 arrancará en el modo de arranque BIOS heredado. Consulte «Seleccióndel modo de UEFI» (página 7).

2. Asegúrese de que esté activado UEFI Shell. De forma predeterminada está activado. Consulte«Habilitación de UEFI Shell integrado» (página 8).

3. Agregue, si lo desea, UEFI Shell integrado a la lista de secuencia de arranque. Consulte«Adición de UEFI Shell integrado a la lista de secuencia de arranque» (página 8).

4. Modifique la entrada de UEFI Shell integrado en la lista de secuencia de arranque UEFI.Consulte «Cambio de la secuencia de arranque UEFI» (página 9).

Selección del modo de UEFIDe forma predeterminada, HP ProLiant DL580 arrancará en el modo de arranque BIOS heredado.Para cambiar el modo de arranque a UEFI en System Utilities (Utilidades del sistema), realice lospasos siguientes:1. Desde la pantalla System Utilities (Utilidades del sistema), seleccione System

Configuration→BIOS/Platform Configuration (RBSU)→Boot Options→Boot Mode (Configuracióndel sistema > BIOS/Configuración de plataforma [RBSU] > Opciones de arranque > Modode arranque) y pulse la tecla Intro.

2. Seleccione UEFI Mode (Modo UEFI) para configurar el sistema para que arranque en unsistema operativo compatible con UEFI.

3. Pulse la tecla F10 para guardar la selección.4. En la pantalla System Utilities (Utilidades del sistema), seleccione Exit and Resume Boot (Salir

y reanudar el arranque).5. Vuelva a arrancar el servidor para que el cambio surta efecto.

Figura 1 Pantalla Boot Options (Opciones de arranque) — Boot Mode (Modo de arranque)

Acceso a UEFI Shell 7

Page 8: AttC5A3.Tmp

Habilitación de UEFI Shell integradoPuede activar o desactivar UEFI Shell integrado. UEFI Shell es un entorno de línea de comandosprevio al arranque para ejecutar secuencias de comandos y aplicaciones UEFI, incluidos loscargadores de arranque de UEFI. UEFI Shell también proporciona comandos basados en la CLIpara obtener información sobre el sistema y configurar y actualizar la BIOS del sistema. Al habilitaresta opción, se agregará UEFI Shell integrado a las opciones de arranque UEFI. Solo se puedeconfigurar esta opción si el modo de arranque está establecido en UEFI. Para obtener másinformación, consulte «Selección del modo de UEFI» (página 7).Para configurar UEFI Shell integrado:1. Desde la pantalla System Utilities (Utilidades del sistema), seleccione System

Configuration→BIOS/Platform Configuration (RBSU)→System Options→UEFI ShellOptions→Embedded UEFI Shell (Configuración del sistema > BIOS/Configuración de plataforma[RBSU] > Opciones del sistema > Opciones de UEFI Shell > UEFI Shell integrado) y pulse latecla Intro.

2. Seleccione una de las siguientes opciones:• Enabled (Activado), predeterminado

• Disabled (Desactivado).3. Pulse la tecla F10 para guardar la selección.Para obtener más información, consulte «Ejecución y edición de secuencias de comandos de UEFIShell» (página 70).

Configuración de UEFI ShellLas siguientes secciones explican cómo agregar UEFI Shell integrado a la lista de secuencia dearranque y modificar el orden de elementos de la lista de secuencia de arranque si es necesario.Puede configurar UEFI Shell como la última entrada de la lista si desea solucionar un error dearranque.

Adición de UEFI Shell integrado a la lista de secuencia de arranqueSolo podrá agregar UEFI Shell integrado como entrada de la lista Boot Order (Secuencia dearranque) cuando UEFI Shell integrado esté habilitado y esté configurado Boot Mode (Modo dearranque) como UEFI. En caso contrario, esta opción se mostrará atenuada.

NOTA: Cuando se habilite esta opción, UEFI Shell integrado no aparecerá en la lista de secuenciade arranque hasta el siguiente reinicio del sistema.

Para agregar el UEFI Shell integrado a la lista de secuencia de arranque, haga lo siguiente:1. Desde la pantalla System Utilities (Utilidades del sistema), seleccione System

Configuration→BIOS/Platform Configuration (RBSU)→SystemOptions→UEFI Shell Options→AddEmbedded UEFI Shell to Boot Order (Configuración del sistema > BIOS/Configuración deplataforma [RBSU] > Opciones del sistema > Opciones de UEFI Shell > Agregar UEFI Shellintegrado a la secuencia de arranque) y pulse la tecla Intro.

2. Seleccione una de las siguientes opciones:• Enabled (Activado) (opción predeterminada): agrega UEFI Shell integrado a la secuencia

de arranque.• Disabled (Desactivado).

3. Pulse la tecla F10 para guardar la selección.

8 Introducción

Page 9: AttC5A3.Tmp

Figura 2 Opciones de UEFI Shell — Adición de UEFI Shell integrado a la pantalla de secuencia dearranque

Cambio de la secuencia de arranque UEFIPara cambiar la secuencia de la lista de arranque de UEFI, haga lo siguiente:1. Desde la pantalla System Utilities (Utilidades del sistema), seleccione System

Configuration→BIOS/Platform Configuration (RBSU)→Boot Options→UEFI Boot Order(Configuración del sistema > BIOS/Configuración de plataforma [RBSU] > Opciones dearranque > Secuencia de arranque UEFI) y pulse la tecla Intro. Aparecerá la pantalla UEFIBoot Order (Secuencia de arranque UEFI).

2. Seleccione Entrar para abrir la lista Boot Order (Secuencia de arranque).3. Utilice las teclas de flecha para desplazarse por la lista de secuencia de arranque.4. Pulse la tecla + (más) para subir una entrada en la lista de arranque.5. Pulse la tecla - (menos) para bajar una entrada en la lista de arranque.6. Pulse la tecla F10 para guardar la selección.7. En la pantalla System Utilities (Utilidades del sistema), seleccione Exit and Resume Boot (Salir

y reanudar el arranque).8. Vuelva a arrancar el servidor para que el cambio surta efecto.

Acceso a UEFI Shell 9

Page 10: AttC5A3.Tmp

Figura 3 Pantalla Boot Options (Opciones de arranque) — UEFI Boot Order (Secuencia de arranqueUEFI)

Arranque de UEFI ShellEs posible seleccionar UEFI Shell para que realice una única anulación de arranque siempre quesea necesario. Esta opción no modifica la configuración de secuencia de arranque predefinida.Para arrancar el UEFI Shell, haga lo siguiente:1. Reinicie el servidor.2. Durante el reinicio, pulse la tecla F11. Se mostrará el Boot Menu (Menú de arranque) en la

pantalla POST de HP ProLiant. En unos minutos, se mostrará la pantalla del menú One-TimeBoot (Arranque único).

3. Seleccione Embedded UEFI Shell (UEFI Shell integrado) y pulse la tecla Intro.4. Pulse cualquier tecla para confirmar que está presente físicamente. Este paso garantiza que

no haya restricciones en determinadas funciones como, por ejemplo, la deshabilitación delarranque seguro o la gestión de los certificados de arranque seguro mediante herramientasUEFI de terceros.

5. Si tiene establecida una contraseña de administrador, deberá escribirla en el símbolo delsistema. Para obtener información sobre la configuración de la contraseña de administrador,consulte la HP UEFI System Utilities User Guide (Guía del usuario de las utilidades del sistemaHP UEFI).Aparecerá el símbolo del sistema Shell>.

6. Escriba los comandos tal como se explica en la «Referencia de los comandos de UEFI Shell»(página 13).

7. Escriba el comando exit para salir del Shell.

10 Introducción

Page 11: AttC5A3.Tmp

Figura 4 Pantalla de menú de arranque único

Figura 5 Pantalla de símbolo del sistema de UEFI Shell

Acceso a UEFI Shell desde una conexión de consola de serie

NOTA: Cuando se accede al Shell desde una consola de serie, el inglés es el único idiomadisponible para las entradas y salidas.

Para obtener acceso a UEFI Shell desde una conexión de consola de serie, haga lo siguiente:

Acceso a UEFI Shell 11

Page 12: AttC5A3.Tmp

1. Arranque el servidor tal como se explica en «Arranque de UEFI Shell» (página 10).2. Abra una conexión en una aplicación cliente SSH con la dirección IP del servidor.3. Deje el puerto SSH con el valor 22.4. 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 serievirtual.Aparecerá el símbolo del sistema Shell>.

6. Escriba los comandos tal como se explica en la «Referencia de los comandos de UEFI Shell»(página 13).

7. Escriba el comando exit para salir del Shell.El Ejemplo 1 (página 12) muestra un ejemplo de inicio de sesión en UEFI Shell desde una conexiónde consola de serie.

Ejemplo 1 Inicio de sesión desde una conexión de consola de 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 2014Server Name:Server Power: On

hpiLO-> vsp

Virtual Serial Port Active: COM2

Starting virtual serial port.Press 'ESC (' to return to the CLI Session.

Shell>

12 Introducción

Page 13: AttC5A3.Tmp

2 Referencia de los comandos de UEFI ShellSintaxis de la línea de comandos

La Tabla 1, «Ejemplos de sintaxis» muestra ejemplos de cómo se debe interpretar la sintaxis delos comandos.

Tabla 1 Ejemplos de sintaxis

UsoEjemplo de sintaxis

Escriba exit.exit

Realice una de las acciones siguientes para mostrar la fecha actual:date [mm/dd/ { yy | yyyy }] [-sfo]• Escriba el comando date sin parámetros opcionales.

• Escriba el comando date seguido de -sfo para especificar el formatode salida estándar.

NOTA: Para establecer una fecha específica en el sistema, escribael comando date seguido de los parámetros de fecha en uno de losformatos siguientes:

◦ mm/dd/yy

◦ mm/dd/yyyy

Esta sintaxis indica que los parámetros de mes (mm) y día (dd) sonopcionales, pero que se necesita el parámetro de año de dos dígitos(yy) o de cuatro dígitos (yyyy) para configurar una fecha.

Escriba eficompress seguido del nombre del archivo de entrada sincomprimir como parámetro infile y, a continuación, especifique elarchivo de salida comprimido como parámetro outfile.

eficompress infile outfile

Función de autocompletado de línea de comandosLa función de autocompletado de la línea de la comandos simplifica la especificación y reutilizaciónde comandos. La Tabla 2, «Teclas de autocompletado de la línea de comandos» describe laspulsaciones de teclas que se deben realizar en la línea de comandos.

Tabla 2 Teclas de autocompletado de la línea de comandos

EfectoTecla

Permite retroceder por la lista de comandos especificados anteriormente.Tecla de flechaarriba

Permite avanzar por la lista de comandos especificados anteriormente.Tecla de flechaabajo

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 unaposibilidad, vuelva a pulsar la tecla TAB para ver todas las posibilidades.

TAB

Retrocede una página.Re Pág

Avanza una páginaAv Pág

Procedimientos inicialesEsta sección describe cómo utilizar algunos de los comandos básicos de UEFI Shell para losiguiente:

• «Control del resultado de los comandos» (página 14)

Sintaxis de la línea de comandos 13

Page 14: AttC5A3.Tmp

• «Visualización de la ayuda de los comandos» (página 17)

• «Acceso al sistema de archivos desde el Shell» (página 21)

• Uso de las opciones de sysconfig

• Uso del comando reset

Control del resultado de los comandosMuchos comandos de UEFI Shell admiten parámetros opcionales para controlar el modo en quese muestran los resultados en la pantalla. Las secciones siguientes explican estas opciones ymuestran ejemplos de su uso.

Limitación de los resultados a una sola pantalla a la vezUtilice la opción –b para limitar la visualización de los resultados de determinados comandos auna única pantalla a la vez. Entre los comandos de Shell que admiten esta opción se incluyen lossiguientes:

• comp

• devices

• devtree

• dh

• dmem

• help

• memmap

El Ejemplo 2 (página 15) muestra cómo limitar los resultados de devtree a una sola pantalla ala vez. Cuando se muestre la primera pantalla, el Shell solicitará que realice una de las accionessiguientes:• Pulse Intro para continuar con la pantalla siguiente.

• Pulse la tecla Q para salir de la pantalla.

14 Referencia de los comandos de UEFI Shell

Page 15: AttC5A3.Tmp

Ejemplo 2 Uso del comando -b para mostrar los resultados en una pantalla a la vez

Shell> devtree -bCtrl[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 7(página 18).

Ejemplo 3 Habilitación de saltos de página globales

Utilice el comando pagebreak para habilitar la paginación de los resultados globales

EjemploPara habilitar los saltos de página globales, haga lo siguiente:fs0:\> set -v pagebreak 1

Este comando crea una variable de entorno UEFI que se retiene hasta el siguiente reinicio delservidor.Para deshabilitar los saltos de página globales, haga lo siguiente:fs0:\> set -v pagebreak 0

Visualización de resultados detalladosUtilice la opción –v para mostrar los resultados detallados (modo detallado) de determinadoscomandos. Entre los comandos de Shell que admiten esta opción se incluyen los siguientes:

• dh

• help

• map

Procedimientos iniciales 15

Page 16: AttC5A3.Tmp

El Ejemplo 4 (página 16) muestra cómo mostrar resultados detallados del comando dh (identificadorde dispositivo) en una sola pantalla a la vez.

Ejemplo 4 Uso del comando -v para mostrar resultados detallados

Shell> dh -v -b

01: LoadedImage02: Decompress03: UnknownDevice DevicePath Fv(6522280D-28F9-4131-ADC4-F40EBFA45864) UnknownDevice04: UnknownDevice DevicePath Fv(770BF9B6-8AFE-4F4C-85E5-893FC3D2606C) UnknownDevice05: UnknownDevice DevicePath Fv(27A72E80-3118-4C0C-8673-AA5B4EFA9613) UnknownDevice06: UnknownDevice DevicePath Fv(29A72E80-7BFE-4101-8459-AB5B3EFA4271) UnknownDevice07: UnknownDevice DevicePath Fv(5A515240-D1F1-4C58-9590-27B1F0E86827) UnknownDevice08: UnknownDevice DevicePath Fv(5E2363B4-3E9E-4203-B873-BB40DF46C8E6) UnknownDevice09: UnknownDevice DevicePath Fv(CDBB7B35-6833-4ED6-9AB2-57D2ACDDF6F0) UnknownDevice0A: UnknownDevice UnknownDevice0B: ImageDevicePath LoadedImage0C: UnknownDevice Pcd0D: ImageDevicePath LoadedImage0E: UnknownDevice UnknownDevice0F: ImageDevicePath LoadedImage10: UnknownDevice ImageDevicePath LoadedImage11: UnknownDevice UnknownDevice UnknownDevice ImageDevicePath LoadedImage12: ImageDevicePath LoadedImage13: UnknownDevice14: UnknownDevice ImageDevicePath LoadedImage15: UnknownDevice16: UnknownDevice17: ImageDevicePath LoadedImage18: ImageDevicePath LoadedImage19: UnknownDevice ImageDevicePath LoadedImage1A: ImageDevicePath LoadedImage1B: UnknownDevice1C: ImageDevicePath LoadedImage1D: UnknownDevicePress ENTER to continue or 'Q' break:

Visualización de un resumen de los resultadosUtilice la opción –t para mostrar un resumen de los resultados (modo simplificado) de determinadoscomandos. Entre los comandos de Shell que admiten esta opción se incluyen los siguientes:

• ver

El Ejemplo 5 (página 17) muestra cómo utilizar el comando ver para mostrar información detalladade la versión de UEFI y, a continuación, cómo utilizar la opción -t para mostrar un resumen.

16 Referencia de los comandos de UEFI Shell

Page 17: AttC5A3.Tmp

Ejemplo 5 Uso de la opción -t para mostrar un resumen de los resultados

Shell> ver

UEFI Interactive Shell v2.0Copyright 1982, 2014 Hewlett-Packard Development Company, L.P.UEFI v2.31 (HP, 0x00010000)ProLiant System BIOS - P79 (01/14/2014)

Shell> ver -t UEFI Interactive Shell v2.0

Eliminación de la solicitud de confirmación al usuarioUtilice la opción –q para ejecutar determinados comandos en modo silencioso sin que se muestrensolicitudes de confirmación. Entre los comandos de Shell que admiten esta opción se incluyen lossiguientes:

• cp

• rm/del

El Ejemplo 6 (página 17) muestra cómo utilizar esta opción con el comando rm para eliminartodos los directorios temp sin que se muestren solicitudes de confirmación.

Ejemplo 6 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 comandosExisten varias opciones de comandos con las que se puede mostrar la ayuda detallada y resumidade uno o varios comandos.

Visualización de la ayuda de todos los comandosEl Ejemplo 7 (página 18) muestra cómo se puede mostrar la ayuda de todos los comandos enuna pantalla a la vez:

Procedimientos iniciales 17

Page 18: AttC5A3.Tmp

Ejemplo 7 Visualización de la ayuda de todos los comandos

Shell> help –balias - Displays, creates, or deletes UEFI Shell aliases.attrib - Displays or changes the attributes of files or directories.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.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 - 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 - Invokes an HP UEFI Shell utility used to update System BIOS firmware.getmtc - Gets the MTC from BootServices and displays it.Press ENTER to continue or 'Q' break:

Visualización de la ayuda de un comando específicoUtilice cualquiera de las siguientes opciones de sintaxis para mostrar la ayuda de un comandoespecífico:• help commandname

• ? commandname

• commandname -?

El Ejemplo 8 (página 19) muestra una forma de mostrar la ayuda del comando ls (una pantallaa la vez).

18 Referencia de los comandos de UEFI Shell

Page 19: AttC5A3.Tmp

Ejemplo 8 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, then all files will be listed. If -a is not specified, then 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, then 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 39).

Visualización de todo el contenido de ayuda para los comandos que empiezan por un carácterdeterminado

Utilice un carácter comodín (*) para mostrar la ayuda de todos los comandos que empiecen porun carácter determinado. El Ejemplo 9 (página 20) muestra cómo mostrar la ayuda de todos loscomandos que empiezan por el carácter a.

Procedimientos iniciales 19

Page 20: AttC5A3.Tmp

Ejemplo 9 Visualización de la ayuda de los comandos que empiezan con la letra a

Shell> help a*

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 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 then 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 - Set or clear the 'archive' attribute +s|-s - Set or clear the 'system' attribute +h|-h - Set or clear the 'hidden' attribute +r|-r - Set or clear the 'read-only' attribute file - File name (wild cards are permitted) directory - 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, then it is also shown to have the attribute [D]. 3. If any file in the file list that is specified in the command line

20 Referencia de los comandos de UEFI Shell

Page 21: AttC5A3.Tmp

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, then 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

Acceso al sistema de archivos desde el ShellCambie del Shell a un sistema de archivos antes de ejecutar comandos que requieran la entradao salida de archivos.Para cambiar a un sistema de archivos, haga lo siguiente: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» (página 42).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 dearchivos seleccionado.

De este modo, podrá tener acceso a los archivos de escritura del sistema de archivos especificadoy modificarlos.El Ejemplo 10 (página 21) muestra cómo tener acceso al sistema de archivos fs0 desde el Shell.

Ejemplo 10 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: \ > paramostrar la ubicación de acceso al sistema de archivos desde el Shell.

Comandos de UEFI ShellNOTA: Todos los comandos requieren autorización de administrador de la BIOS.Consulte la HP UEFI System Utilities User Guide (Guía del usuario de las utilidades del sistema HPUEFI) para obtener información sobre la configuración de la contraseña del administrador.

Comandos de UEFI Shell 21

Page 22: AttC5A3.Tmp

Tabla 3 Componentes de la lista de comandos de Shell

DescripciónSección

Nombre del comando seguido de una breve descripción de cómo se utilizaNombre del comando y línea deresumen

Sintaxis del comando, incluidos los parámetros necesarios y opcionalesSintaxis

Descripción de los parámetros de sintaxis y las variablesOpciones

Descripción detallada del uso del comandoDescripción

Uno o varios ejemplos del uso del comando

NOTA: Los elementos que debe especificar el usuario se muestran en negritaen los ejemplos de uso de los comandos.

Ejemplos

Descripciones de los campos mostrados del comando, si procede.Detalles de resultados

aliasPermite mostrar, crear o eliminar los alias del entorno de UEFI Shell.

Sintaxisalias [ -d | -v ] [alias-name] [command-name]

DescripciónEste comando muestra, crea o elimina los alias en el entorno de UEFI Shell. Los alias permitenproporcionar 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 nombresequivalentes 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.

EjemplosPara mostrar todos los alias en el entorno de UEFI Shell:Shell> alias

md : mkdirrd : rmmyguid : guid

Para crear un alias en el entorno de UEFI Shell:Shell> alias myguid guid

Shell> alias

md : mkdir rd : rmmyguid : guid

Para eliminar un alias del entorno de UEFI Shell:Shell> alias -d myguidShell> alias

md : mkdir rd : rm

Para agregar un alias volátil al entorno UEFI actual, identificado con un asterisco * en elencabezado de la línea. Este alias volátil desaparecerá en el siguiente inicio.

22 Referencia de los comandos de UEFI Shell

Page 23: AttC5A3.Tmp

Shell> alias -v fs0 floppy

Shell> alias

md : mkdirrd : rm* fs0 : floppy

attribPermite mostrar o modificar los atributos de archivos o directorios.

Sintaxisattrib [ +a | -a ] [ +s | -s ] [ +h | -h ] [ +r | -r ] [file...] [directory...]

Opciones[ +a | -a ] Establece o borra el atributo archive.[ +s | -s ] Establece o borra el atributo system.[ +h | -h ] Establece o borra el atributo hidden.[ +r | -r ] Establece o borra el atributo read-only.file... Especifica el nombre del archivo. Este comando admite el uso de caracteres

comodín.directory... Especifica el nombre del directorio. Este comando admite el uso de caracteres

comodín.

DescripciónEste comando muestra y establece los atributos de archivos o directorios. El sistema de archivosUEFI admite los cuatro tipos de atributos siguientes:

• Archive—A

• System—S

• Hidden—H

• Read only—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, attribseguirá 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 directorioactual.Si no se especifica ningún atributo, se mostrarán los atributos de los archivos.

EjemplosPara 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.efiattrib: DA fs0:\test1attrib: A HR fs0:\bios.inf

attrib 23

Page 24: AttC5A3.Tmp

attrib: A fs0:\VerboseHelp.txtattrib: 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

cdPermite mostrar o modificar el directorio actual.

Sintaxiscd [ruta]

Opcionesruta Especifica la ruta del directorio relativa o absoluta.

DescripciónEste comando permite cambiar el directorio de trabajo actual que utiliza el entorno de UEFI Shell.Si se especifica una asignación de sistema de archivos, se cambiará el directorio de trabajo actualpara dicho dispositivo. En caso contrario, se cambiará el directorio de trabajo actual para eldispositivo actual.Si no se indica la ruta, el directorio de trabajo actual (incluida la asignación de sistema dearchivos) se mostrará como resultado estándar.En la Tabla 4 (página 24) se describen las convenciones que se utilizan para hacer referencia alos directorios, los directorios primarios y el directorio raíz en el entorno de UEFI Shell.

Tabla 4 Convenciones de nombre de directorio

Se refiere a...Convención

Directorio actual..

Directorio primario del directorio actual.. .

Directorio raíz del sistema de archivos actual.\

El directorio de trabajo actual se mantiene en la variable de entorno %cwd%.

EjemplosPara 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 primario (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:\>

24 Referencia de los comandos de UEFI Shell

Page 25: AttC5A3.Tmp

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 quedesee.

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.

clsPermite borrar el resultado estándar y, de manera opcional, cambiar el color de fondo.

Sintaxiscls [color]

Opcionescolor Especifica un nuevo color de fondo mediante las opciones siguientes:

0: Negro1: Azul2: Verde3: Cian4: Rojo5: Magenta6: Amarillo7: Gris claro

DescripciónEste comando permite borrar la pantalla de resultados estándar y ofrece un atributo de color defondo opcional. Si no se especifica el color, el color de fondo no cambiará.

EjemplosPara 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

compPermite comparar el contenido de dos archivos byte a byte.

cls 25

Page 26: AttC5A3.Tmp

Sintaxiscomp [-b] archivo1 archivo2

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.

DescripciónEste comando permite comparar el contenido de dos archivos en modo binario. Muestra hasta10 diferencias entre los dos archivos. Para cada diferencia, se volcarán hasta 32 bytes desde laubicación en la que se inicia la diferencia. UEFI Shell se cerrará de inmediato si las longitudesde los archivos comparados son distintas.

EjemplosPara comparar dos archivos con longitudes diferentes:fs0:\> comp bios.inf legacy.inf

Compare fs0:\bios.inf to fs0:\legacy.infDifference #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.infCompare 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 *....*File2: fs0:\bios2.inf 0000000C: 25 32 03 03 *%2..*[difference(s) encountered]

cpPermite copiar uno o varios archivos de origen o directorios a un destino.

Sintaxiscp [-r] [-q] src src... [dst]

Opciones-r crea una copia de forma recursiva.-q Crea una copia de forma silenciosa (sin mostrar solicitudes de confirmación).

26 Referencia de los comandos de UEFI Shell

Page 27: AttC5A3.Tmp

src src... Especifica un archivo de origen o nombre de directorio. Este comando admiteel uso de caracteres comodín.

dst Especifica un nombre de archivo o directorio de destino. Este comando no admiteel uso de caracteres comodín. Si no se especifica, se asumirá que el directoriode trabajo actual es el de destino. Si se especifica más de un directorio, seasumirá que el último directorio es el de destino.

DescripciónEste comando permite copiar uno o varios archivos de origen o directorios a un destino. Si elorigen es un directorio, deberá especificar el indicador -r. Si se especifica el indicador -r, eldirectorio de origen se copiará de forma recursiva al destino (lo que significa que se copiarántodos los subdirectorios). Si no se especifica ningún destino, se asumirá que el directorio de trabajoes el actual.Si ya existe alguno de los archivos de destino (no un directorio), se mostrará un mensaje paraconfirmar la sustitución de los archivos. Se encuentran disponibles las cuatro opciones siguientes:

• Yes: Sustituye el archivo.

• No: No sustituye el archivo.

• All: Sustituye los archivos existentes en todos los casos siguientes.

• Cancel: No sustituye los archivos existentes en todos los casos siguientes.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 a otro directorio.

EjemplosPara mostrar el contenido del directorio actual:fs0:\> lsDirectory of: fs0:\ 06/18/01 01:02p <DIR> 512 efi 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)

Para copiar un archivo del mismo directorio y cambiar el nombre de archivo:fs0:\> cp temp.txt readme.txt

copying fs0:\temp.txt -> fs0:\readme.txt- [ok]

Para copiar varios archivos a otro directorio:fs0:\> cp temp.txt isaBus.efi \testcopying fs0:\temp.txt -> fs0:\test\temp.txt- [ok]copying fs0:\isaBus.efi -> fs0:\test\IsaBus.efi- [ok]

Para copiar varios directorios de forma recursiva a otro directorio:fs0:\> cp -r test1 test2 boot \test

copying fs0:\test1 -> fs0:\test\test1copying fs0:\test1\test1.txt -> fs0:\test\test1\test1.txt

cp 27

Page 28: AttC5A3.Tmp

- [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> 512 . 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>

datePermite mostrar y establecer la fecha actual del sistema.

Sintaxisdate [mm/dd/ { yy | yyyy }] [-sfo]

Opcionesmm Especifica el mes de la fecha que se va a establecer (1-12).dd Especifica el día de la fecha que se va a establecer (1-31).yy Especifica el año de la fecha con dos dígitos.yyyy Especifica el año de la fecha con cuatro dígitos.-sfo Especifica que los resultados se muestren en formato estándar.

DescripciónEste comando permite mostrar o establecer la fecha actual del sistema. Si no se utilizan parámetros,se mostrará la fecha actual. La fecha del sistema se actualizará si se proporcionan valores válidosde 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 son válidos. El Shell mostrará un error si el número se encuentra en el rangoincorrecto de mes/fecha/año.

• No se pueden usar espacios antes o después del carácter numérico. No es posible insertarespacios en el número.

• El intervalo de años es mayor o igual a 1998. Dos caracteres numéricos indican el año. Losnúmeros menores que 98 se considerarán como 20xx y los números iguales o mayores que98 se considerarán como 19xx. 00 equivale a 2000. Por ejemplo:Shell> date 8/4/97

Shell> date

8/04/2097Shell>Shell> date dblk8/4/98

28 Referencia de los comandos de UEFI Shell

Page 29: AttC5A3.Tmp

Shell> date08/04/1998 Shell>

El intervalo de años válidos es 1998–2099.

EjemplosPara mostrar la fecha actual en el sistema:fs0:\> date

06/18/2001

Para establecer la fecha con formato de año extendido y mostrarla:fs0:\> date 01/01/2050

fs0:\> date

01/01/2050

Para establecer la fecha con formato de año reducido y mostrarla:fs0:\> date 06/18/01fs0:\> date06/18/2001

dblkPermite mostrar uno o varios bloques desde un dispositivo de bloques.

Sintaxisdblk [lba] [blocks] [-b]

Opciones-b Permite mostrar una pantalla a la vez.device Nombre del dispositivo de bloque.lba Índice del primer bloque que se debe mostrar (número hexadecimal).blocks Número de bloques que se deben mostrar (número hexadecimal). El valor

predeterminado es 1. Si es mayor que 0 x 10, se mostrarán solo 0x10.

EjemplosPara 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

devicesPermite mostrar una lista de dispositivos gestionados mediante los controladores de UEFI.

Sintaxisdevices [-b] [-lxxx] [-sfo]

dblk 29

Page 30: AttC5A3.Tmp

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 UEFI.-sfo Muestra la información de los resultados en formato estándar.

DescripciónEste comando imprime una lista de dispositivos gestionados con los controladores del modelo delcontrolador de UEFI.

EjemploPara mostrar todos los dispositivos compatibles con el modelo de controlador de UEFI:Shell> devices

C T D T Y C IR P F A L E G G #P #D #C Device Name == = = = == == == =============================================================20 R - - - 1 13 VenHw(58C518B1-76F3-11D4-BCEA-0080C73C8881) 3D D - - 3 - - Primary Console Input Device 3E D - - 3 - - Primary Console Output Device 64 B - - 1 6 2 "UGA Window 1 65 B - - 1 6 2 UGA Window 2" 66 B - - 1 1 1 EFI_WIN_NT_SERIAL_PORT=COM167 B - - 1 1 1 COM1 68 B - - 1 4 2 PC-ANSI Serial Console 69 D - - 1 - - EFI_WIN_NT_SERIAL_PORT=COM2 6E D - - 1 - - EFI_WIN_NT_PHYSICAL_DISKS=e:RW;262144;5126F D - - 1 - - EFI_WIN_NT_CPU_MODEL=Intel(R) Processor Model 70 D - - 1 - - EFI_WIN_NT_CPU_SPEED=3000 71 D - - 1 - - EFI_MEMORY_SIZE=64 72 D - - 1 - - EFI_MEMORY_SIZE=64

Detalles de resultadosLa Tabla 5 (página 30) describe los posibles resultados para este comando.

Tabla 5 Detalles de resultados — Comando devices

Muestra...Columna

Número de identificación del dispositivo.CTRL

Tipo de dispositivo. Las opciones disponibles son las siguientes:TYPE

• R: Controlador raíz.

• B: Controlador de bus.

• D: Controlador del dispositivo.

Estado de soporte del protocolo de configuración:CFG

• Y: Sí

• N: No

Estado de soporte del protocolo de diagnóstico:DIAG

• Y: Sí

• N: No

Número de controladores primarios de este dispositivo#P

Número de dispositivos de este tipo#D

30 Referencia de los comandos de UEFI Shell

Page 31: AttC5A3.Tmp

Tabla 5 Detalles de resultados — Comando devices (continuación)

Muestra...Columna

Número de controladores secundarios generados por este dispositivo#C

Nombre del dispositivo según el protocolo de nombre de componentesDevice Name

devtreePermite mostrar el árbol de dispositivos compatibles con el modelo del controlador de UEFI.

Sintaxisdevtree [-b] [-d] [-lxxx] [devicehandle]

Opciones-b Muestra una pantalla a la vez.-d Muestra el árbol de dispositivos con las rutas de dispositivo.-lxxx Muestra el árbol del dispositivo en un idioma específico. Para obtener una

lista de las opciones de código posibles, consulte la Especificación UEFI.devicehandle Muestra el árbol del dispositivo debajo de un identificador especificado.

DescripciónEste comando imprime el árbol de dispositivos gestionados por los controladores que siguen elmodelo de controlador de UEFI. De forma predeterminada, los dispositivos se imprimen con losnombres de dispositivo que se recuperan con el protocolo de nombre de componentes. Si seespecifica la opción –d, se imprimirán las rutas del dispositivo en su lugar.

EjemploPara mostrar el árbol de todos los dispositivos compatibles con el modelo de controlador de UEFIen una pantalla a la vez:Shell> devtree -b

devtree -b fs0:\ 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)

devtree 31

Page 32: AttC5A3.Tmp

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:

dhMuestra los identificadores del dispositivo en el entorno UEFI.

Sintaxisdh [-lxxx] [ handle | -p prot_id ] [-d] [-b] [-v] [-sfo]

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ónUEFI.

handle Muestra el identificador de un dispositivo específico.-p prot_id 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 la Tabla 8

(página 42).

DescripciónEste comando muestra los identificadores de los dispositivos del entorno EFI. Si se utiliza con unnúmero de identificador específico, se mostrarán los detalles de todos los protocolos asociadosa dicho identificador de dispositivo. En caso contrario, es posible utilizar la opción-p para mostraruna lista de los identificadores de dispositivos que contengan un protocolo específico. Si no seespecifica la opción -pprot_id ni handle, se mostrarán todos los identificadores.

EjemplosPara mostrar todos los identificadores en una sola pantalla:Shell> dh -b

Handle dump 1: Image(DXE Core) 2: FwVol FwFileSys FwVolBlk DevPath(MemMap(11:1B50000- 1D4FFC8)) 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

Handle 30 (01AF5308) IsaIo ROM Size......: 00000000 ROM Location..: 00000000 ISA Resource List : IO : 000003F8-000003FF Attr : 00000000

32 Referencia de los comandos de UEFI Shell

Page 33: AttC5A3.Tmp

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 cuandola 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 resultadosLa Tabla 6 (página 33) describe los posibles resultados para este comando.

Tabla 6 Detalles de resultados — Comando dh

Muestra...Columna

Nombre del controlador que genera el identificador.Driver Name

Nombre del controlador que genera el identificador.Controller Name

Número entero del identificador.Handle number

Ruta del dispositivo asociado al identificador.Device Path

Lista separada por puntos y comas de los identificadores de protocolos o GUID.ProtocolIdentifiers

Cantidad total de bytes libres en el volumen.Free Space

Tamaño de bloque nominal, en bytes, que suelen aumentar los archivos.Block Size

dmemPermite mostrar el contenido de la memoria del dispositivo o sistema.

dmem 33

Page 34: AttC5A3.Tmp

Sintaxisdmem [-b] [address] [size] [-MMIO]

Opciones-b Muestra una pantalla a la vez.address Muestra el contenido de la memoria de una dirección de inicio específica (en formato

hexadecimal).size Muestra el contenido de la memoria de un tamaño específico (en formato

hexadecimal).-MMIO Muestra el contenido asignado de la memoria asignada mediante

EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.

DescripciónEste comando muestra el contenido de la memoria del sistema o del dispositivo. Si no se especificala opción address, se mostrará el contenido de la tabla del sistema EFI. De lo contrario, semostrará el contenido de la memoria que se inicie en address. Si no se especifica la opciónsize, se tomará el valor predeterminado de 512 bytes para la visualización. Si no se especificala 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 medianteEFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.

EjemploPara mostrar el contenido de la memoria desde 1af3088 con un tamaño de 16 bytes:Shell> dmem 1af3088 16Memory Address 0000000001AF3088 16 Bytes01AF3088: 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 *......*

driversMuestra una lista de información de controladores que siguen el modelo de controlador UEFI delentorno UEFI.

Sintaxisdrivers [-lxxx] [-sfo]

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 UEFI.-sfo Muestra el contenido en una tabla de resultados de formato estándar. Consulte la Tabla 7

(página 35).

DescripciónEste comando muestra una lista de información de los controladores que siguen el modelo decontrolador UEFI en el entorno UEFI. Para obtener una descripción de los elementos mostrados,consulte la Tabla 7 (página 35).

EjemploPara mostrar la lista de controladores:Shell> drivers

34 Referencia de los comandos de UEFI Shell

Page 35: AttC5A3.Tmp

T DD Y C I R P F A V VERSION E G G #D #C DRIVER NAME IMAGE NAME === ======= = = = == == ===================================== ==========39 00000010 D - - 1 - Platform Console Management Driver ConPlatform3A 00000010 D - - 1 - Platform Console Management Driver ConPlatform3B 00000010 B - - 1 1 Console Splitter Driver ConSplitter3C 00000010 ? - - - - Console Splitter Driver ConSplitter3D 00000010 B - - 1 1 Console Splitter Driver ConSplitter3E 00000010 ? - - - - Console Splitter Driver ConSplitter42 00000010 D - - 1 - UGA Console Driver GraphicsConsole43 00000010 ? - - - - Serial Terminal Driver Terminal44 00000010 D - - 1 - Generic Disk I/O Driver DiskIo45 00000010 D - - 1 - FAT File System Driver Fat48 00000010 ? - - - - ISA Bus Driver IsaBus49 00000010 ? - - - - ISA Serial Driver IsaSerial4C 00000010 B - - 1 1 PCI Bus Driver PciBus55 00000010 D X X 1 - Windows Block I/O Driver WinNtBlockIo56 00000010 ? - - - - Windows Text Console Driver WinNtConsole57 00000010 ? - - - - Windows Serial I/O Driver WinNtSerialIo58 00000010 D - - 1 - Windows Simple File System Driver WinNtSimpleFileSystem59 00000010 B - - 1 3 Windows Bus Driver WinNtBusDriver5F 00000010 D - - 1 - Windows Universal Graphics Adapter WinNtUga

Detalles de resultadosLa Tabla 7 (página 35) describe los posibles resultados de este comando.

Tabla 7 Detalles de resultados — Comando drivers

Muestra...Columna

Identificador entero del controlador.DRV

Número de versión del controlador.VERSION

Tipo de controlador. Los valores posibles son:TYPE

• B: Controlador de bus.

• D: Controlador del dispositivo.

Estado de soporte del protocolo de configuración:CFG

• Y: Sí

• N: No

Estado de soporte del protocolo de controlador:DIAG

• Y: Sí

• N: No

Número de dispositivos que gestiona este controlador.#D

Número de dispositivos secundarios que produjo este controlador.#C

Nombre del controlador según el protocolo de nombre de componentes.DRIVER NAME

Ruta de dispositivo desde la que se descargó el controlador.IMAGE NAME

echoPermite controlar si se muestran los comandos de las secuencias de comandos conforme se vanleyendo del archivo de la secuencia de comandos e imprime el mensaje especificado para lavisualización.

Sintaxisecho [ -on | -off ]

echo 35

Page 36: AttC5A3.Tmp

echo message

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.message Especifica un mensaje para mostrar.

DescripciónLa primera forma de este comando controla si se muestran los comandos de las secuencias decomandos conforme se leen de los archivos de secuencias de comandos. Si no se especificaningún argumento, se mostrará el estado actual on u off. La segunda forma de este comandoimprime el mensaje especificado en la pantalla.

NOTA: Este comando no modifica el valor de la variable de entorno lasterror.

EjemplosPara 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íneasdel 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

editPermite editar un archivo ASCII o UCS-2 en modo de pantalla completa.

Sintaxisedit [file]

Opcionesfile 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.

DescripciónEste comando permite editar un archivo con un editor de pantalla completa. El editor admite lostipos de archivo UCS-2 y ASCII.

36 Referencia de los comandos de UEFI Shell

Page 37: AttC5A3.Tmp

EjemploPara editar el archivo shell.log:fs0:\> edit shell.log

eficompressComprime un archivo con el algoritmo de compresión de EFI.

Sintaxiseficompress infile outfile

Opcionesinfile Especifica el nombre de archivo de entrada sin comprimir.outfile Especifica el nombre de archivo de salida comprimido.

DescripciónEste comando permite comprimir un archivo mediante el algoritmo de compresión EFI y, acontinuación, escribe el formato comprimido en un archivo nuevo.

EjemploPara comprimir un archivo denominado sincomprimir a un archivo denominado comprimido:fs0:\> eficompress sincomprimir comprimido

efidecompressDescomprime un archivo con el algoritmo de descompresión de EFI.

Sintaxisefidecompress infile outfile

Opcionesinfile Especifica el nombre de archivo de entrada comprimido.outfile Especifica el nombre de archivo de sin comprimir.

DescripciónEste comando permite descomprimir un archivo mediante el algoritmo de descompresión EFI y, acontinuación, escribe el formato descomprimido en un archivo nuevo.

EjemploPara descomprimir un archivo denominado comprimido a un archivo denominadosincomprimir:fs0:\> eficompress comprimido sincomprimir

exitPermite salir de UEFI Shell o de la secuencia de comandos actual.

Sintaxisexit [/b] [exit-code]

eficompress 37

Page 38: AttC5A3.Tmp

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 unainstancia de UEFI Shell, especifica el valor devuelto a la persona que llama. Si nose especifica, devuelve el valor 0.

DescripciónEste comando permite salir de UEFI Shell o, si se especifica la opción /b, de la secuencia decomandos actual.

EjemploPara salir de UEFI Shell:fs0:\> exit

fwupdatePermite actualizar el firmware de la BIOS del sistema.

Sintaxisfwupdate firmwarefile [-r]

Opcionesfirmwarefile Especifica el nombre del archivo de la imagen de firmware para actualizar.-r Lleva a cabo un reinicio después de actualizar el firmware.

DescripciónEste comando actualiza el firmware de la BIOS del sistema. De manera opcional, puede especificarque se restablezca la NVRAM, que se reinicie el sistema tras la actualización, o ambas opciones.Si no se especifica ninguna opción, no se realizará ninguna acción.

EjemploPara actualizar la BIOS del sistema, restablecer la NVRAM a su configuración predeterminada yejecute un reinicio del sistema: Shell> fwupdate YourFlashImage.BIN -r

getmtcPermite obtener el valor de MTC de BootServices y mostrarlo.

Sintaxisgetmtc

Este comando muestra el valor actual del contador monotónico. El valor de 32 bits inferior aumentacada vez que se ejecuta este comando. Cada vez que se reinicia el sistema, aumenta el valorsuperior de 32 bits y se restablece a 0 el valor inferior de 32 bits.

gotoPermite ir a una etiqueta de una secuencia de comandos.

38 Referencia de los comandos de UEFI Shell

Page 39: AttC5A3.Tmp

Sintaxisgoto label

helpMuestra la lista de comandos integrados en UEFI Shell.

Sintaxishelp [ cmd | pattern | special ] [-usage] [-v] [-section sectionname] [-b]

Opcionescmd Especifica el comando para que se va a mostrar la ayuda.pattern 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 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 sectionname Muestra la sección especificada de la información de ayuda.-b Muestra el resultado de la ayuda en una única pantalla.

DescripciónEste comando permite mostrar información sobre uno o varios comandos del shell.Si no se especifica ninguna otra opción, los comandos se mostrarán con una breve descripciónde su función. Si se especifica la opción –v, se mostrará toda la información del comandoespecificado. Si se especifica la opción –section, solo se mostrará la sección especificada(véase más adelante). Si se especifica la opción –usage, se mostrarán el comando, una descripciónbreve e información sobre el uso del comando.El texto de ayuda se toma de los archivos de texto UCS-2 que pueden encontrarse en el directorioen el que se encuentra el archivo ejecutable del shell o del comando shell. Los archivos tienen elnombre comando-nombre.man donde comando-nombre equivale al nombre del comandoshell. Los archivos siguen un subconjunto del formato de página MAN, tal como se describe acontinuación.Si no se especifica ninguna opción, solo se mostrará la sección NAME de la página.

EjemploPara mostrar la lista de comandos de UEFI Shell e insertar un salto de página tras una pantalla:Shell> help –balias - Displays, creates, or deletes UEFI Shell aliases.attrib - Displays or changes the attributes of files or directories.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.

Para mostrar información de ayuda sobre el comando de shell ls (puede utilizar cualquiera delas siguientes opciones de sintaxis):Shell> help lsShell> ? ls

Shell> ls -?

help 39

Page 40: AttC5A3.Tmp

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

ls/dirMuestra el contenido de un directorio o la información de un archivo.

Sintaxisls [-r] [-a[attrib]] [-sfo] [file]

Opciones-r Muestra el contenido de forma recursiva (incluidos los subdirectorios).-a attrib 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, semostrarán todos los archivos no ocultos y que no sean del sistema. Los atributos(attrib) pueden ser uno o varios de los siguientes:• a: Archivo.

• s: Sistema.

• h: Oculto.

• r: Read-only

• d: Directorio.

-sfo Muestra el contenido de los resultados en formato estándar. Para obtener másinformación, consulte «Detalles de resultados — Comando ls (información delvolumen)» (página 42) y «Detalles de resultados — Comando ls (información dearchivo)» (página 42).

file Especifica el nombre de un archivo o directorio. Este comando admite el uso decaracteres comodín.

DescripciónEste comando muestra el contenido del directorio o la información de archivos. Si no se especificaningún nombre de archivo o de directorio, se tomará el directorio de trabajo actual. El contenidode 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 file.

• El valor del parámetro file 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 nombreespecificado.

◦ El indicador -r determina si se realizará una búsqueda recursiva.

◦ La opción -a attrib 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 dichosatributos. Si la opción -a no va seguida de ningún valor, se mostrarán todos los archivoso directorios, sin tener en cuenta sus atributos. Si no se especifica la opción -a, semostrarán todos los archivos salvo los archivos ocultos y del sistema.

40 Referencia de los comandos de UEFI Shell

Page 41: AttC5A3.Tmp

EjemplosPara ocultar archivos al agregar el atributo de archivo oculto o de sistema:fs0:\> attrib +s +h *.efiASH fs0:\IsaBus.efi ASH fs0:\IsaSerial.efi

Para mostrar todos los archivos, excepto los archivos o directorios con el atributo h o s:fs0:\> ls

Directory of: fs0:\

06/18/01 09:32p 153 for.nsh 06/18/01 01:02p <DIR> 512 efi 06/18/01 01:02p <DIR> 512 test1 06/18/01 01:02p <DIR> 512 test2 06/18/01 08:04p 29 temp.txt 06/18/01 08:05p <DIR> 512 test 01/28/01 08:24p r 29 readme.txt 3 File(s) 211 bytes 4 Dir(s)

Para mostrar los archivos con todos los atributos en el directorio actual:fs0:\> ls -a

Directory of: fs0:\

06/18/01 09:32p 153 for.nsh 06/18/01 01:02p <DIR> 512 efi 06/18/01 01:02p <DIR> 512 test1 06/18/01 01:02p <DIR> 512 test2 06/18/01 10:59p 28,739 IsaBus.efi 06/18/01 10:59p 32,838 IsaSerial.efi 06/18/01 08:04p 29 temp.txt 06/18/01 08:05p <DIR> 512 test 01/28/01 08:24p r 29 readme.txt 5 File(s) 61,788 bytes 4 Dir(s)

Para mostrar los archivos con atributos de solo lectura del directorio actual:fs0:\> ls -ar

Directory of: fs0:\ 06/18/01 11:14p r 29 readme.txt 1 File(s) 29 bytes 0 Dir(s)

Para mostrar los archivos con el atributo s:fs0:\> ls -as isabus.efi Directory of: fs0:\

06/18/01 10:59p 28,739 IsaBus.efi 1 File(s) 28,739 bytes 0 Dir(s)

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

ls/dir 41

Page 42: AttC5A3.Tmp

Detalles de resultadosLa Tabla 8 (página 42) describe los posibles resultados de información de volumen (directorio)que se pueden obtener con este comando. La Tabla 9 (página 42) describe los posibles resultadosde información de archivo que se pueden obtener con este comando.

Tabla 8 Detalles de resultados — Comando ls (información del volumen)

Muestra...Columna

Etiqueta de volumen estándar.Name

Número total de bytes en el volumen.Total Size

Estado de solo lectura:Read Only status

• True

• False

Cantidad total de bytes libres en el volumen.Free Space

Tamaño de bloque nominal, en bytes, que suelen aumentar los archivos.Block Size

Tabla 9 Detalles de resultados — Comando ls (información de archivo)

Muestra...Columna

Nombre de archivo completo y directorio, incluido el nombre asignado del sistema dearchivos.

Name

Tamaño del archivo, en bytes.Logical Size

Tamaño en bytes del archivo en el volumen, incluido el material de relleno.Physical Size

Lista de atributos del archivo. Los valores posibles son:Attributes

• a: Archivo.

• d: Directorio.

• h: Oculto.

• r: Solo lectura.

• s: Sistema.

Hora a la que creó el archivo con el formato: hh:mm:ss.File Creation Time

Fecha en la que se creó el archivo con el formato: dd:mm:yyyy.File Creation Date

Hora la que se tuvo acceso al archivo por última vez con el formato: hh:mm:ss.File Access Time

Fecha en la que se tuvo acceso al archivo por última vez con el formato: dd:mm:yyyy.File Access Date

Hora a la que se modificó el archivo con el formato: hh:mm:ss.File ModificationTime

Fecha en la que se modificó el archivo con el formato: dd:mm:yyyy.File ModificationDate

mapPermite mostrar o configurar una asignación entre un nombre definido por el usuario y unidentificador del dispositivo.

Sintaxismap [-d mappedname]map [ -r | -v | -c | -f | -u | -t type [,type...] | mappedname ] [-sfo]map [ mappedname | mapping ]

42 Referencia de los comandos de UEFI Shell

Page 43: AttC5A3.Tmp

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: Disquete.

• hd: Disco duro.

• cd: CD-ROM.Los tipos se pueden combinar si se intercala una coma entre ellos. No es posibleintercalar espacios entre los tipos.

-sfo Muestra el contenido de los resultados en formato estándar. Para obtener másinformación, consulte la Tabla 10 (página 44).

-u Permite agregar asignaciones para los dispositivos recién instalados. Asimismo,permite quitar las asignaciones de dispositivos desinstalados; aunque no modificalas asignaciones de los dispositivos existentes. Mantiene las asignacionesdefinidas por el usuario.

handle Especifica el número del identificador.mapping Especifica un nuevo nombre asignado para un dispositivo. La asignación debe

terminar con el signo de dos puntos (:).

DescripciónEste comando permite crear una asignación entre un nombre definido por el usuario y undispositivo. Este comando se utiliza con más frecuencia para crear un nombre asignado para losdispositivos 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 queadmiten un sistema de archivos reconocido.Este comando puede utilizarse para crear asignaciones adicionales o para eliminar una asignaciónexistente con la opción -d. Si se utiliza el comando sin ningún parámetro, se mostrarán todas lasasignaciones actuales. Si se utiliza la opción - v, se mostrarán las asignaciones con informaciónadicional sobre cada dispositivo.La opción - r restablece todas las asignaciones predeterminadas de un sistema. Esta opciónresulta ú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; sin embargo, no modifica lasasignaciones de los dispositivos existentes. Esta opción también conserva las asignaciones definidaspor el usuario. Este comando también guarda un historial de asignaciones para que se puedausar el nombre de asignación original de un dispositivo con una ruta de dispositivo específica encaso de que se utilice dicho nombre de asignación para la ruta del dispositivo por última vez. Eldirectorio actual también se mantendrá si no se modifica el dispositivo actual.Cada dispositivo del sistema tiene una asignación coherente. Las asignaciones coherentes deldispositivo no cambiarán si no se modifica la configuración de hardware. Si dos o más equipostienen las mismas configuraciones de hardware, la asignación coherente del dispositivo será lamisma. Utilice la opción -c para que se muestren todas las asignaciones coherentes del sistema.

map 43

Page 44: AttC5A3.Tmp

La asignación consta de dígitos y caracteres. Los demás caracteres no son válidos.Este comando permite utilizar caracteres comodín para eliminar o mostrar asignaciones. Noobstante, no es posible usar caracteres comodín para la asignación.

EjemploPara eliminar una asignación:Shell> map -d devicename

Detalles de resultadosLa Tabla 10 (página 44) describe los posibles resultados de este comando.

Tabla 10 Detalles de resultados — Comando map

Muestra...Número de columna

El nombre de la tabla. El nombre es Mappings (Asignaciones).1

El nombre asignado. El nombre del dispositivo asignado.2

La ruta del dispositivo. La ruta del dispositivo que se corresponde con el nombre deldispositivo asignado.

3

El nombre coherente. Nombre asignado coherente (si existe) equivalente a mappedname.Esta columna no contendrá ningún valor si mappedname ya es un nombre asignadocoherente.

4

memmapMuestra la asignación de memoria del sistema.

Sintaxismemmap [-b] [-sfo]

Opciones-b Muestra una pantalla a la vez.-sfo Muestra el contenido de los resultados en formato estándar en una tabla de resumen y

detallada. Para obtener más información, consulte «Detalles de resultados — Comandomemmap» (página 45).

DescripciónEste comando muestra la asignación de memoria del entorno EFI, que realiza un seguimiento dela memoria física del sistema y de su utilización actual.

EjemploPara mostrar la asignación de memoria del sistema:fs0:\> memmap

Type Start End # Pages Attributes available 0000000000750000-0000000001841FFF 00000000000010F2 0000000000000009LoaderCode 0000000001842000-00000000018A3FFF 0000000000000062 0000000000000009available 00000000018A4000-00000000018C1FFF 000000000000001E 0000000000000009LoaderData 00000000018C2000-00000000018CAFFF 0000000000000009 0000000000000009BS_code 00000000018CB000-0000000001905FFF 000000000000003B 0000000000000009BS_data 0000000001906000-00000000019C9FFF 00000000000000C4 0000000000000009... RT_data 0000000001B2B000-0000000001B2BFFF 0000000000000001 8000000000000009

44 Referencia de los comandos de UEFI Shell

Page 45: AttC5A3.Tmp

BS_data 0000000001B2C000-0000000001B4FFFF 0000000000000024 0000000000000009reserved 0000000001B50000-0000000001D4FFFF 0000000000000200 0000000000000009

reserved : 512 Pages (2,097,152) LoaderCode: 98 Pages (401,408) LoaderData: 32 Pages (131,072) BS_code : 335 Pages (1,372,160) BS_data : 267 Pages (1,093,632) RT_data : 19 Pages (77,824) available : 4,369 Pages (17,895,424)Total Memory: 20 MB (20,971,520) Bytes

Detalles de resultadosLa Tabla 11 (página 45) describe los posibles resultados para este comando.

Tabla 11 Detalles de resultados — Comando memmap

Muestra...Columna

Tipo de memoria. Las opciones disponibles son las siguientes:Type

• Available

• LoaderCode

• LoaderData

• BootServiceCode

• BootServiceData

• RuntimeCode

• RuntimeData

• Reserved

• MemoryMappedIO

• MemoryMappedIOPortSpace

• UnusableMemory

• ACPIReclaimMemory

• ACPIMemoryNVS

• PalCode

Dirección de inicio.Start

Dirección de finalización.End

Número de páginas de 4 KB.# Pages

Cantidad total de memoria reservada en bytes.reserved

Tamaño total de código de cargador en bytes.LoaderCode

Tamaño total de datos de cargador en bytes.LoaderData

Tamaño total de código de servicio de arranque en bytes.BS_code

Tamaño total de datos de servicio de arranque en bytes.BS_data

Tamaño total de los datos en tiempo de ejecución en bytes.RT_data

Memoria disponible en bytes.available

Memoria total en bytes.Total Memory

mkdirPermite crear uno o varios nuevos directorios.

mkdir 45

Page 46: AttC5A3.Tmp

Sintaxismkdir dir [dir...]

Opcióndir Especifica uno o varios nombres de directorios. Este comando no admite el uso de caracteres

comodín.

DescripciónEste comando permite crear uno o varios directorios nuevos. Si dir incluye directorios anidados,se crearán los directorios primarios antes de los secundarios. Si el directorio ya existe, el comandofinalizará con un error.

EjemplosPara crear un nuevo directorio y mostrar su contenido:fs0:\> mkdir rafter

fs0:\> ls

Directory of: fs0:\

06/18/01 08:05p <DIR> 512 test 06/18/01 11:14p r 29 readme.txt 06/18/01 11:50p <DIR> 512 rafter 1 File(s) 211 bytes 2 Dir(s)

Para crear y mostrar varios directorios:fs0:\> mkdir temp1 temp 2

fs0:\> ls

Directory of: fs0:\

06/18/01 08:05p <DIR> 512 test 06/18/01 11:14p r 29 readme.txt 06/18/01 11:50p <DIR> 512 rafter 06/18/01 11:52p <DIR> 512 temp1 06/18/01 11:52p <DIR> 512 temp2 1 File(s) 211 bytes 4 Dir(s)

modePermite mostrar o modificar el modo del dispositivo de resultados de la consola.

Sintaxismode [col row]

Opcionescol Especifica el número de columnas.row Especifica el número de filas.

46 Referencia de los comandos de UEFI Shell

Page 47: AttC5A3.Tmp

DescripciónEste comando se utiliza para cambiar el modo de visualización del dispositivo de resultados dela consola. Cuando se utiliza sin parámetros, muestra una lista de los modos que admiteactualmente el dispositivo de resultados estándar. El comando puede utilizarse con los parámetrosrow y col para cambiar el número de filas y columnas en el dispositivo de resultados estándar.

NOTA: La pantalla se borra cada vez que se utiliza el comando mode para cambiar el modode visualización actualmente seleccionado.

EjemplosPara mostrar todos los modos disponibles en el dispositivo de resultados estándar, así como elmodo seleccionado actualmente (indicado con un *):Shell> mode

Available modes on standard output col 80 row 25 * col 80 row 50 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 50Available modes on standard output col 80 row 25 col 80 row 50 * col 80 row 43 col 100 row 100

mvPermite mover uno o varios archivos a un destino del sistema de archivos.

Sintaxismv src... [dst]

Opcionessrc... Especifica un archivo de origen o nombre de directorio. Este comando admite el uso

de caracteres comodín.dst Especifica un nombre de archivo o archivo de destino. Este comando admite el uso

de caracteres comodín. Si no se especifica, se asumirá que el directorio de trabajoactual es el de destino. Si hay más de un argumento en la línea de comandos, siemprese considerará el último como destino.

DescripciónEste comando permite mover uno o ovarios archivos a un destino del sistema de archivos. No esposible mover archivos entre volúmenes de sistema distintos. 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 destinocomo si se hubiese cambiado el nombre del directorio. Si no se especifica ningún destino, seasumirá que el directorio actual es el destino.Se producirá un error si se intenta mover un directorio o archivo de solo lectura. Este comandopermite mover un directorio que contiene archivos de solo lectura. No es posible mover un directorioa sí mismo o a sus subdirectorios. No se podrá mover un directorio si este es el directorio detrabajo actual o alguno de sus subdirectorios.Los demás archivos o directorios se moverán pese a que se produzca un error.

mv 47

Page 48: AttC5A3.Tmp

EjemploPara cambiar el nombre de un archivo:fs0:\> mv IsaBus.efi Bus.efimoving fs0:\IsaBus.efi -> \Bus.efi - [ok]

openinfoMuestra los protocolos y agentes asociados a un identificador.

Sintaxisopeninfo Handle [-b]

Opciones-b Permite mostrar una pantalla a la vez.Handle Muestra la información del protocolo abierto del identificador especificado.

parsePermite recuperar un valor de un registro especificado en resultado con formato estándar.

Sintaxisparse filename tablename column [-i instance] [-s instance]

Opcionesfilename Especifica un nombre de archivo de origen.tablename Especifica el nombre de la tabla que se debe analizar.column Especifica el índice de columna que se debe utilizar para determinar el valor

del registro determinado que se debe analizar.-i instance 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 instance Inicia el análisis de la instancia n de la tabla ShellCommand especificada.Si no se encuentra, el parámetro tomará el valor 1.

DescripciónEste comando permite analizar los datos de un archivo que contiene resultados de datos de uncomando que haya utilizado el parámetro –sfo. Puesto que el formato estándar de resultadostiene métodos de análisis conocidos, este comando debe utilizarse como método simplificadopara hacer que las secuencias de comandos usen los archivos de resultados creados y los datosrecuperados en la lógica de las secuencias de comandos programadas para UEFI Shell.

EjemplosA 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:

48 Referencia de los comandos de UEFI Shell

Page 49: AttC5A3.Tmp

fs0:\> parse temp.txt FileInfo 3 –i 3

795

pausePermite poner en pausa la ejecución del archivo de la secuencia de comandos.

Sintaxispause [-q]

DescripciónEste comando solo está disponible para las secuencias de comandos. Muestra un mensaje en lapantalla y, a continuación, suspende la ejecución del archivo de la secuencia de comandos yespera 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 secuenciade comandos. En caso contrario, la ejecución continuará con la siguiente línea tras el comandode pausa.

Opción–q Oculta el mensaje mostrado.

EjemplosEsta secuencia de comandos muestra un ejemplo del comando pause:fs0:\> type pause.nsh# # Example script for 'pause' command # echo pause.nsh begin..date hour pauseecho 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> time00: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/200100:52:50 Enter 'q' to quit, any other key to continue: q

fs0:\>

pause 49

Page 50: AttC5A3.Tmp

pciMuestra una lista de dispositivos PCI o información acerca del espacio de configuración de lafunción PCI.

Sintaxispci [Bus Dev [Func] [-s Seg] [-i]]

Opciones-s Número de segmento opcional Seg especificado.mappedname Especifica un nombre de asignación.-i Información interpretada.-Bus Número de bus.Dev Número de dispositivo.Func Número de función.

DescripciónEste comando muestra todos los dispositivos PCI del sistema. También puede mostrar el espaciode configuración de un dispositivo PCI según las direcciones especificadas de bus (Bus), dispositivo(Dev) y función (Func). Si no se especifica ninguna dirección de función, se tomará el valor 0 deforma predeterminada.La opción -i se utiliza para mostrar información detallada sobre el dispositivo PCI especificado.El espacio de configuración de PCI del dispositivo se vuelca con una interpretación de los detalles.Si no se especifica ningún parámetro, se volcarán todos los dispositivos PCI con una interpretacióndetallada.Si se especifican los parámetros de número de dispositivo y de bus y no se especifican losparámetros Func o Seg, se tomará el valor 0 de forma predeterminada para estos parámetros.

EjemploPara 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 -1

resetPermite restablecer el sistema.

Sintaxisreset [ -w | [-s] | -c ] [string]

Opciones-w Realiza un arranque en caliente.-s Apaga el sistema.-c Realiza un arranque en frío.string Especifica la cadena que se debe transmitir para restablecer el servicio.

50 Referencia de los comandos de UEFI Shell

Page 51: AttC5A3.Tmp

DescripciónEste comando permite restablecer el sistema. De forma predeterminada, el sistema realizará unrestablecimiento en frío. Si se especifica la opción string, se transmitirá el valor de esta opcióna la función SystemTable ResetSystem() para informar al sistema de la razón para elrestablecimiento del sistema.

EjemploPara restablecer el sistema:Shell> reset

rm/delPermite eliminar uno o varios archivos o directorios. El comando del es un alias interno delcomando rm.

Sintaxisrm [-q] file/directory [file/directory...]

Opciones-q Realiza la eliminación de forma silenciosa, sin mostrar ningún mensaje de

confirmación.file Especifica el nombre del archivo que se va a eliminar. Este comando admite el

uso de caracteres comodín.directory Especifica el directorio que se va a eliminar. Este comando admite el uso de

caracteres comodín.

DescripciónEste comando permite eliminar uno o varios archivos o directorios. Si el destino es un directorio,este se eliminará, incluidos todos los subdirectorios. No es posible redirigir archivos cuyosdirectorios primarios (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 casode error, el comando rm se cerrará inmediatamente y no se eliminarán los archivo o directoriosrestantes.No es posible eliminar un directorio si el directorio actual es el directorio que se trata de eliminaro alguno de sus subdirectorios. Si el archivo especificado para la eliminación contiene caracterescomodín, el sistema no solicitará confirmación alguna.El directorio raíz no se puede eliminar. Asimismo, no es posible eliminar el directorio actual nisus elementos antecesores.

EjemplosIntento 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> 512 . 06/18/01 01:01p <DIR> 0 .. 06/19/01 12:59a <DIR> 512 temp1 06/19/01 12:59a <DIR> 512 temp2

rm/del 51

Page 52: AttC5A3.Tmp

0 File(s) 0 bytes 4 Dir(s)

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]? yremoving 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] 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 provocaun mensaje de error:fs0:\> attrib +r test\temp1\readme.txtA R fs0:\test\temp1\readme.txt

fs0:\> rm test\temp1rm/del: Cannot open 'readme.txt' under 'fs0:\test\temp1' in writable mode- [error] - Access Denied Exit status code: Access Denied

setPermite mostrar, cambiar o eliminar una variable de entorno de UEFI Shell.

Sintaxisset [-v] [sname [value]]set [-d sname]

Opciones-v Establece una variable volátil que desaparece en el siguiente inicio.-d Elimina una variable.sname Especifica un nombre para la variable.value Especifica un valor de variable.

DescripciónEste comando mantiene las variables de entorno de UEFI Shell. Se puede utilizar para lo siguiente:

• Mostrar las variables de entorno.

• Crear nuevas variables de entorno.

• Cambiar el valor de las variables de entorno existentes.

52 Referencia de los comandos de UEFI Shell

Page 53: AttC5A3.Tmp

• Eliminar variables de entorno.Este comando establece la variable de entorno especificada con la opción sname con losparámetros opcionales value. Si no se utiliza ningún parámetro, se mostrarán todas las variablesde entorno. Si se utiliza con la opción-d, se eliminará la variable de entorno especificada conla opción sname.

NOTA: Este comando no modifica el valor de la variable de entorno lasterror.

EjemplosPara 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 diagnosticpathShell> set* path : .

“Para modificar una variable de entorno:fs0:\> set src efifs0:\> set

]* path : .;fs0:\efi\tools;fs0:\efi\boot;fs0:\ src : efifs0:\> set src efi1.1fs0:\> 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

setsizePermite ajustar el tamaño de un archivo.

Sintaxissetsize size [-d] file [file...]

Opcionessize Tamaño del archivo una vez que se ajusta.-d Elimina una variable.

setsize 53

Page 54: AttC5A3.Tmp

file Archivo con el tamaño ajustado.

DescripciónEste comando permite ajustar el tamaño de un archivo de destino. Al ajustar el tamaño de unarchivo se trunca o amplía automáticamente el tamaño en función de los parámetros transmitidos.El archivo se creará en caso de que no exista ninguno. Al establecer un tamaño inferior al de losdatos reales del archivo, se truncan los datos.

EjemploPara establecer el tamaño de un archivo:fs0:\> setsize size file [file...]

shiftPermite desplazar el contenido de los parámetros posicionales de las secuencias de comandosde UEFI Shell para que las secuencias de comandos puedan procesarlos de izquierda a derecha.

Sintaxisshift

DescripciónEste comando permite desplazar el contenido de los parámetros de las secuencias de comandosde UEFI Shell para descartar %1, copiar %2 en %1, %3 en %2, %4 en %3 y así sucesivamente. Estopermite a las secuencias de comandos de UEFI Shell procesar los parámetros de izquierda aderecha.

NOTA: Este comando no modifica la variable de entorno de UEFI Shell lasterror.

EjemploPara 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

smbiosviewMuestra la información de SMBIOS.

Sintaxissmbiosview [-t SmbiosType] [-h SmbiosHandle] [-s] [-a]

54 Referencia de los comandos de UEFI Shell

Page 55: AttC5A3.Tmp

Opciones-t Muestra todas las estructuras de SmbiosType.-h Muestra las estructuras de SmbiosHandle.-s Muestra una tabla de estadísticas.-a Muestra toda la información.SmbiosType Tipo de estructura de SMBIOS.SmbiosHandle Identificador de 16 bits único de la estructura de SMBIOS.

EjemploPara establecer el tamaño de un archivo:fs0:\> setsize size file [file...]

stallPermite detener el procesador durante un determinado número de microsegundos.

Sintaxisstall time

Opcióntime Especifica el número de microsegundos que debe detenerse el procesador.

DescripciónEste comando establece un periodo de detención para las operaciones durante la ejecución deuna secuencia de comandos.

EjemploPara detener el procesador durante 20 microsegundos:Shell> stall 20

sysconfigMuestra o configura los valores del BIOS del sistema HP.

Sintaxissysconfig -i [ all | settingname ]sysconfig -g [ all | settingname ] [settingname...]sysconfig -s [settingname=settingvalue ...]sysconfig -s AdminPassword=settingvalue OldAdminPassword=settingvaluesysconfig -s PowerOnPassword=settingvalue OldPowerOnPassword=settingvaluesysconfig [ -import | exportación ] nombre de archivo.txt

Opciones-i Muestra información de los valores de configuración

especificados o de todos los valores, incluidos los valoresposibles. El valor actual de la opción se indica con un asterisco(*).

settingname Especifica el nombre del valor de configuración sobre el que seva a mostrar la información. Consulte Atributos de sysconfig(página 56).

stall 55

Page 56: AttC5A3.Tmp

all Muestra toda la información de todos los valores.-g Muestra los valores actuales de los parámetros seleccionados

o de todos los valores.—s Establece el valor de la configuración especificada.settingvalue Especifica un valor de configuración. Consulte Atributos de

sysconfig (página 56).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.-import Importa toda la configuración de un archivo de secuencia de

comandos.-export Exporta todos los valores de configuración a un archivo de

secuencia de comandos.nombre de archivo.txt Especifica el destino del archivo de la secuencia de comandos

para la importación o exportación.

DescripciónEste comando muestra o configura los valores de la BIOS del sistema.

NOTA:• La configuración del BIOS en las opciones de servicio o de depuración no están disponibles

para la ejecución de all en el Shell.

EjemplosPara ver todos los atributos de sysconfig posibles existentes en el sistema, así como los valoresactuales configurados:Shell> sysconfig -g all

Para obtener una descripción de los valores de salida, consulte Atributos de sysconfig (página 56).Para mostrar toda la información del ajuste ProcHyperthreading:Shell> sysconfig -I ProcHyperthreading

Para obtener el valor actual del parámetro de configuración ProcHyperthreading:Shell> sysconfig -g ProcHyperthreading

Para establecer el valor del parámetro ProcHyperthreading como desactivado:Shell> sysconfig -s ProcHyperthreading=Disabled

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"

Atributos de sysconfigPuede ver todos los nombres de atributos, descripciones, valores actuales, valores posibles y tiposde configuración Enum de sysconfig, como se muestra en el ejemplo siguiente.Para obtener más información sobre cada atributo, consulte la Guía de usuario de utilidades delsistema HP UEFI.

56 Referencia de los comandos de UEFI Shell

Page 57: AttC5A3.Tmp

Shell> sysconfig -I all

Setting Name = EmbeddedSerialPort [Puerto serie integrado]Current Value = Com1Irq4 [COM 1; IRQ4; I/O: 3F8h-3FFh]Possible Values = Com1Irq4 [COM 1; IRQ4; I/O: 3F8h-3FFh] Com2Irq3 [COM 2; IRQ3; E/S: 2F8h-2FFh] Disabled [Desactivado]Setting Type = Enum

Setting Name = VirtualSerialPort [Puerto serie virtual]Current Value = Com2Irq3 [COM 2; IRQ3; E/S: 2F8h-2FFh]Possible Values = Com1Irq4 [COM 1; IRQ4; I/O: 3F8h-3FFh] Com2Irq3 [COM 2; IRQ3; E/S: 2F8h-2FFh] Disabled [Desactivado]Setting Type = Enum

Setting Name = PreBootNetwork [Interfaz de red previa al arranque]Current Value = FlexLom1 [Integrado: FlexLOM 1]Possible Values = FlexLom1 [Integrado: FlexLOM 1] PciSlot1 [Ranura PCIe 1] PciSlot2 [[Ranura PCIe 2] PciSlot3 [[Ranura PCIe 3] PciSlot4 [[Ranura PCIe 4] PciSlot5 [[Ranura PCIe 5] PciSlot6 [[Ranura PCIe 6] PciSlot7 [[Ranura PCIe 7] PciSlot8 [[Ranura PCIe 8] PciSlot9 [[Ranura PCIe 9]Setting Type = Enum

Setting Name = Dhcpv4 [DHCPv4]Current Value = Enabled [Activado]Possible Values = Disabled [Desactivado] Enabled [Activado]Setting Type = Enum

Setting Name = Ipv4Address [Dirección IPv4]Current Value = 0.0.0.0 Setting Type = String

Setting Name = Ipv4SubnetMask [Máscara de subred IPv4]Current Value = 0.0.0.0 Setting Type = String

Setting Name = Ipv4Gateway [Puerta de enlace IPv4]Current Value = 0.0.0.0 Setting Type = String

Setting Name = Ipv4PrimaryDNS [DNS primaria IPv4]Current Value = 0.0.0.0 Setting Type = String

Setting Name = Ipv4SecondaryDNS [DNS secundaria IPv4]Current Value = 0.0.0.0 Setting Type = String

Setting Name = AdvancedMemProtection [Protección de memoria avanzada]Current Value = AdvancedEcc [Compatibilidad con ECC avanzado]Possible Values = AdvancedEcc [Compatibilidad con ECC avanzado] OnlineSpareAdvancedEcc [Repuesto en línea con compatibilidad con ECC avanzado] MirroredAdvancedEcc [Memoria auxiliar con soporte ECC avanzado] LockstepDddc [Lockstep Mode with DDDC Support]Setting Type = Enum

Setting Name = UsbControl [Control USB]Current Value = UsbEnabled [USB activado]Possible Values = UsbEnabled [USB activado] ExternalUsbDisabled [Puertos USB externos desactivados]Setting Type = Enum

Setting Name = UsbBoot [Compatibilidad con arranque de USB]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = RemovableFlashBootSeq [Removable Flash Media Boot Sequence]Current Value = ExternalKeysFirst [Llaves de unidad externa primero]Possible Values = InternalSdCardFirst [Tarjeta SD interna primero]

sysconfig 57

Page 58: AttC5A3.Tmp

InternalKeysFirst [Llaves de unidad interna primero] ExternalKeysFirst [Llaves de unidad externa primero]Setting Type = Enum

Setting Name = ProcNoExecute [No-Execute Protection]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = ProcVirtualization [Tecnología de virtualización]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = ProcHyperthreading [Intel(R) Hyperthreading Options]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = ProcTurbo [Intel(R) Turbo Boost Technology]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = IntelProcVtd [Intel(R) VT-d]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = EmbeddedUefiShell [Embedded UEFI Shell]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = UefiShellBootOrder [Add Embedded UEFI Shell to Boot Order]Current Value = Disabled [Desactivado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = UefiShellStartup [UEFI Shell Script Auto-Start]Current Value = Disabled [Desactivado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = PowerProfile [Perfil de alimentación de HP]Current Value = BalancedPowerPerf [Balanced Power and Performance]Possible Values = BalancedPowerPerf [Balanced Power and Performance] MinPower [Uso de alimentación mínimo] MaxPerf [Rendimiento máximo] Custom [Personalizado]Setting Type = Enum

Setting Name = PowerRegulator [Regulador de alimentación HP]Current Value = DynamicPowerSavings [HP Dynamic Power Savings Mode]Possible Values = DynamicPowerSavings [HP Dynamic Power Savings Mode] StaticLowPower [HP Static Low Power Mode] StaticHighPerf [Modo de alto rendimiento estático de HP] OsControl [Modo de control de SO]Setting Type = Enum

Setting Name = RedundantPowerSupply [Redundant Power Supply Mode]Current Value = BalancedMode [Modo equilibrado]Possible Values = BalancedMode [Modo equilibrado] HighEfficiencyAuto [Modo de alta eficacia (Automático)] HighEfficiencyOddStandby [Modo de alta eficacia (fuentes pares en espera)] HighEfficiencyEvenStandby [Modo de alta eficacia (fuentes impares en espera)]Setting Type = Enum

Setting Name = IntelQpiPowerManagement [Intel QPI Link Power Management]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

58 Referencia de los comandos de UEFI Shell

Page 59: AttC5A3.Tmp

Setting Name = IntelQpiFreq [Frecuencia de enlace de Intel QPI]Current Value = Auto [Automático]Possible Values = Auto [Automático] MinQpiSpeed [Min QPI Speed]Setting Type = Enum

Setting Name = QpiBandwidthOpt [QPI Bandwidth Optimization (RTID)]Current Value = Balanced [Equilibrado]Possible Values = Balanced [Equilibrado] OptimizedForIo [Optimized for I/O (Alternate RTID)]Setting Type = Enum

Setting Name = MinProcIdlePower [Minimum Processor Idle Power Core C-State]Current Value = C6 [Estado C6]Possible Values = C6 [Estado C6] C3 [Estado C3] C1E [Estado C1E] NoCStates [No C-states]Setting Type = Enum

Setting Name = MinProcIdlePkgState [Minimum Processor Idle Power Package C-State]Current Value = C6NonRetention [Package C6 (non-retention) State]Possible Values = C6Retention [Package C6 (retention) State] C6NonRetention [Package C6 (non-retention) State] NoState [Sin estado de paquete]Setting Type = Enum

Setting Name = EnergyPerfBias [Energy/Performance Bias]Current Value = MaxPerf [Rendimiento máximo]Possible Values = MaxPerf [Rendimiento máximo] BalancedPerf [Rendimiento equilibrado] BalancedPower [Balanced Power] PowerSavingsMode [Modo de ahorro de energía]Setting Type = Enum

Setting Name = MaxMemBusFreqMHz [Frecencia máxima del bus de memoria]Current Value = Auto [Automático]Possible Values = Auto [Automático] 1600 [1600 MHz] 1333 [1333 MHz] 1066 [1066 MHz]Setting Type = Enum

Setting Name = ChannelInterleaving [Intercalación de canal]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = MaxPcieSpeed [Velocidad máxima de PCI Express]Current Value = MaxSupported [Máximo admitido]Possible Values = MaxSupported [Máximo admitido] PcieGen1 [Generación de PCIe 1.0]Setting Type = Enum

Setting Name = DynamicPowerResponse [Respuesta de modo dinámico de ahorro de energía]Current Value = Fast [Rápido]Possible Values = Fast [Rápido] Slow [Lento]Setting Type = Enum

Setting Name = CollabPowerControl [Control de alimentación compartido]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = DynamicPowerCapping [Función de limitación de alimentación dinámica]Current Value = Auto [Automático]Possible Values = Auto [Automático] Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = AcpiSlit [ACPI SLIT Preferences]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

sysconfig 59

Page 60: AttC5A3.Tmp

Setting Name = EmbSasEnable [Embedded RAID : Smart Array P830i Controller]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = AsrStatus [Estado ASR]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = AsrTimeoutMinutes [Tiempo de espera de ASR]Current Value = 10 [10 minutos]Possible Values = 10 [10 minutos] 15 [15 minutos] 20 [20 minutos] 30 [30 minutos] 5 [5 minutos]Setting Type = Enum

Setting Name = WakeOnLan [Wake-On LAN]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = PostF1Prompt [Solicitud de POST mediante F1]Current Value = Delayed20Sec [Retardo de 20 segundos]Possible Values = Disabled [Desactivado] Delayed2Sec [Retardo de 2 segundos] Delayed20Sec [Retardo de 20 segundos]Setting Type = Enum

Setting Name = PowerButton [Modo del botón de alimentación]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = AutoPowerOn [Encendido automático]Current Value = RestoreLastState [Restaurar último estado de encendido]Possible Values = AlwaysPowerOn [Siempre encendido] AlwaysPowerOff [Siempre apagado] RestoreLastState [Restaurar último estado de encendido]Setting Type = Enum

Setting Name = PowerOnDelay [Retardo de encendido]Current Value = None [Sin retardo]Possible Values = None [Sin retardo] Random [Retardo aleatorio] 15Sec [Retardo de 15 segundos] 30Sec [Retardo de 30 segundos] 45Sec [Retardo de 45 segundos] 60Sec [Retardo de 60 segundos]Setting Type = Enum

Setting Name = IntelligentProvisioning [Intelligent Provisioning (F10 Prompt)]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = EmbeddedDiagnostics [Diagnóstico integrado]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = EmbeddedDiagsMode [Modo de diagnóstico integrado]Current Value = Auto [Automático]Possible Values = Auto [Automático] TextConsole [Consola de texto]Setting Type = Enum

Setting Name = TpmType [Tipo de TPM actual]Current Value = NoTpm [Sin TPM]Possible Values = NoTpm [Sin TPM] Tpm12 [TPM 1.2] Tpm20 [TPM 2.0]Setting Type = Enum

60 Referencia de los comandos de UEFI Shell

Page 61: AttC5A3.Tmp

Setting Name = TpmState [Estado TPM actual]Current Value = NotPresent [No está presente]Possible Values = NotPresent [No está presente] PresentDisabled [Presente y desactivado] PresentEnabled [Presente y activado]Setting Type = Enum

Setting Name = TpmOperation [TPM 1.2 Operation]Current Value = Disable [Desactivar]Possible Values = Enable [Activar] Disable [Desactivar] Clear [Borrar] NoAction [Ninguna acción]Setting Type = Enum

Setting Name = TpmVisibility [TPM 1.2 Visibility]Current Value = Visible [Visible]Possible Values = Hidden [Oculto] Visible [Visible]Setting Type = Enum

Setting Name = TpmBinding [Enlace TPM]Current Value = Disabled [Desactivado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = SerialConsolePort [Puerto de consola serie del BIOS]Current Value = Auto [Automático]Possible Values = Auto [Automático] Disabled [Desactivado] Physical [Puerto serie físico] Virtual [Puerto serie virtual]Setting Type = Enum

Setting Name = SerialConsoleEmulation [Modo de emulación de la consola serie del BIOS]Current Value = Vt100Plus [VT100+]Possible Values = Vt100 [VT100] Ansi [ANSI] Vt100Plus [VT100+]Setting Type = Enum

Setting Name = SerialConsoleBaudRate [Velocidad en baudios de la consola serie del BIOS]Current Value = 115200 [115200]Possible Values = 9600 [9600] 19200 [19200] 57600 [57600] 115200 [115200]Setting Type = Enum

Setting Name = EmsConsole [Consola EMS]Current Value = Disabled [Desactivado]Possible Values = Disabled [Desactivado] Com1Irq4 [COM 1; IRQ4; E/S: 3F8h-3FFh] Com2Irq3 [COM 2; IRQ3; E/S: 2F8h-2FFh]Setting Type = Enum

Setting Name = RomSelection [Selección de ROM]Current Value = CurrentRom [Usar ROM actual]Possible Values = CurrentRom [Usar ROM actual] BackupRom [Switch to Backup ROM]Setting Type = Enum

Setting Name = NmiDebugButton [NMI Debug Button]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = VirtualInstallDisk [Virtual Install Disk]Current Value = Disabled [Desactivado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = EmbeddedUserPartition [Partición de usuario integrada]Current Value = Disabled [Desactivado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

sysconfig 61

Page 62: AttC5A3.Tmp

Setting Name = PciBusPadding [Opciones de relleno del bus PCI]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = PowerOnLogo [Power-On Logo]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = F11BootMenu [One-Time Boot Menu (F11 Prompt)]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = Sriov [SR-IOV]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = ConsistentDevNaming [Denominación de dispositivos coherente]Current Value = LomsOnly [Compatibilidad de CDN solo para LOM]Possible Values = LomsOnly [Compatibilidad de CDN solo para LOM] Disabled [Desactivado]Setting Type = Enum

Setting Name = NetworkBootRetry [Compatibilidad con reintentos de arranque de red]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = BootOrderPolicy [Boot Order Policy]Current Value = RetryIndefinitely [Retry Boot Order Indefinitely]Possible Values = RetryIndefinitely [Retry Boot Order Indefinitely] AttemptOnce [Attempt Boot Order Once] ResetAfterFailed [Reset After Failed Boot Attempt]Setting Type = Enum

Setting Name = VideoOptions [Opciones de vídeo]Current Value = BothVideoEnabled [Vídeo opcional e integrado activados]Possible Values = OptionalVideoOnly [Vídeo opcional habilitado, vídeo integrado desactivados] BothVideoEnabled [Vídeo opcional e integrado activados]Setting Type = Enum

Setting Name = UefiPxeBoot [UEFI PXE Boot Policy]Current Value = Auto [Automático]Possible Values = Auto [Automático] IPv4ThenIPv6 [IPv4 then IPv6] IPv4 [IPv4] IPv6 [IPv6] IPv6ThenIPv4 [IPv6 then IPv4]Setting Type = Enum

Setting Name = EmbVideoConnection [Conexión de vídeo integrado]Current Value = Auto [Automático]Possible Values = Auto [Automático] AlwaysDisabled [Siempre desactivado] AlwaysEnabled [Siempre activado]Setting Type = Enum

Setting Name = PwrSupplyReqOverride [Anulación de los requisitos de fuente de alimentación]Current Value = Default [Requisitos predeterminados de fuente de alimentación]Possible Values = Default [Requisitos predeterminados de fuente de alimentación] 1Min2Redundant [Configurar para 1 mínimo requerido, 2 requerido para redundancia] 2Min3Redundant [Configurar para 2 mínimo requerido, 3 requerido para redundancia] 2Min4Redundant [Configurar para 2 mínimo requerido, 4 requerido para redundancia] 3Min4Redundant [Configurar para 3 mínimo requerido, 4 requerido para redundancia] 4MinNoneRedundant [Configurar para 4 mínimo requerido, sin redundancia]Setting Type = Enum

Setting Name = ThermalConfig [Configuración térmica]Current Value = OptimalCooling [Refrigeración óptima]Possible Values = OptimalCooling [Refrigeración óptima] IncreasedCooling [Refrigeración aumentada] MaxCooling [Refrigeración máxima]

62 Referencia de los comandos de UEFI Shell

Page 63: AttC5A3.Tmp

Setting Type = Enum

Setting Name = ThermalShutdown [Apagado térmico]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = HwPrefetcher [Precargador de HW]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = AdjSecPrefetch [Precargador de sector adyacente]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = DcuStreamPrefetcher [Precargador de flujo DCU]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = DcuIpPrefetcher [Precargador de IP DCU]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = NodeInterleaving [Intercalación de nodos]Current Value = Disabled [Desactivado]Possible Values = Disabled [Desactivado] Enabled [Activado]Setting Type = Enum

Setting Name = RestoreDefaults [Restore Default System Settings]Current Value = No [No, cancelar el procedimiento de restauración.]Possible Values = No [No, cancelar el procedimiento de restauración.] Yes [Sí, restaurar a la configuración predeterminada.]Setting Type = Enum

Setting Name = RestoreManufacturingDefaults[Restore Default Manufacturing Settings]Current Value = No [No, cancelar el procedimiento de restauración.]Possible Values = No [No, cancelar el procedimiento de restauración.] Yes [Sí, restaurar a la configuración predeterminada.]Setting Type = Enum

Setting Name = SaveUserDefaults [Guardar configuración predeterminada del usuario]Current Value = No [No, Cancelar]Possible Values = No [No, Cancelar] Yes [Sí, Guardar]Setting Type = Enum

Setting Name = EraseUserDefaults [Borrar configuración predeterminada del usuario]Current Value = No [No, Cancelar]Possible Values = No [No, Cancelar] Yes [Sí, borrar la configuración actual.]Setting Type = Enum

Setting Name = UtilityLang [Idioma de la utilidad]Current Value = English [Inglés]Possible Values = English [Inglés] Japanese [?,?] Chinese [-??S]Setting Type = Enum

Setting Name = IntelPerfMonitoring [Intel Performance Monitoring Support]Current Value = Disabled [Desactivado]Possible Values = Disabled [Desactivado] Enabled [Activado]Setting Type = Enum

Setting Name = BootMode [Modo de arranque]Current Value = Uefi [Modo UEFI]Possible Values = Uefi [Modo UEFI] LegacyBios [Modo BIOS heredado]Setting Type = Enum

sysconfig 63

Page 64: AttC5A3.Tmp

Setting Name = UefiOptimizedBoot [Inicio optimizado UEFI]Current Value = Enabled [Activado]Possible Values = Disabled [Desactivado] Enabled [Activado]Setting Type = Enum

Setting Name = ProcX2Apic [Compatibilidad con procesador x2APIC]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = AcpiRootBridgePxm [Memory Proximity Reporting for I/O]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = ExtendedMemTest [Prueba de memoria extendida]Current Value = Disabled [Desactivado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = MixedPowerSupplyReporting[Mixed Power Supply Reporting]Current Value = Enabled [Activado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = AcpiRtcSupport [ACPI RTC Support]Current Value = Disabled [Desactivado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = ServerName [Nombre del servidor]Current Value = Setting Type = String

Setting Name = ServerPrimaryOs [SO del servidor principal]Current Value = Setting Type = String

Setting Name = ServerOtherInfo [Otra información del servidor]Current Value = Setting Type = String

Setting Name = AdminName [Nombre del administrador]Current Value = Setting Type = String

Setting Name = AdminPhone [Número de teléfono del administrador]Current Value = Setting Type = String

Setting Name = AdminEmail [Dirección de correo electrónico del administrador]Current Value = Setting Type = String

Setting Name = AdminOtherInfo [Otra información del administrador]Current Value = Setting Type = String

Setting Name = ServiceName [Nombre de contacto del servicio]Current Value = Setting Type = String

Setting Name = ServicePhone [Teléfono de contacto del servicio]Current Value = Setting Type = String

Setting Name = ServiceEmail [Correo electrónico de contacto del servicio]Current Value = Setting Type = String

64 Referencia de los comandos de UEFI Shell

Page 65: AttC5A3.Tmp

Setting Name = ServiceOtherInfo [Otra información de contacto del servicio]Current Value = Setting Type = String

Setting Name = CustomPostMessage [Mensaje de POST personalizado]Current Value = Setting Type = String

Setting Name = ProcCoreDisable [Desactivar núcleo de procesador]Current Value = 0 Setting Type = Numeric

Setting Name = ProductId [ID de producto]Current Value = Setting Type = String

Setting Name = ServerAssetTag [Etiqueta de activo de servidor]Current Value = Setting Type = String

Setting Name = SerialNumber [Número de serie]Current Value = Setting Type = String

Setting Name = AssetTagProtection [Protección de etiqueta de activo]Current Value = Unlocked [Desbloqueado]Possible Values = Locked [Bloqueado] Unlocked [Desbloqueado]Setting Type = Enum

Setting Name = SecureBoot [Arranque seguro]Current Value = Disabled [Desactivado]Possible Values = Enabled [Activado] Disabled [Desactivado]Setting Type = Enum

Setting Name = TimeZone [Zona horiaria]Current Value = Utc0 [UTC-00:00, Hora del meridiano de Greenwich, Dublín, Londres]Possible Values = UtcM12 [UTC-12:00, Línea internacional de cambio de fecha oeste] UtcM11 [UTC-11:00, Isla del Mediodía, Samoa] UtcM10 [UTC-10:00, Hawaii] UtcM9 [UTC-09:00, Alaska] UtcM8 [UTC-08:00, Hora del Pacífico (EE. UU. y Canadá)] UtcM7 [UTC-07:00, Hora de las Montañas Rocosas (EE. UU. y Canadá)] UtcM6 [UTC-06:00, América central, Hora central (EE. UU. y Canadá)] UtcM5 [UTC-05:00, Hora oriental (EE. UU. y Canadá)] UtcM430 [UTC-04:30, Caracas] UtcM4 [UTC-04:00, Hora del Atlántico (Canadá), Caracas, Santiago de Chile]

UtcM330 [UTC-03:30, Terranova] UtcM3 [UTC-03:00, Brasilia, Buenos Aires, Georgetown, Groenlandia] UtcM2 [UTC-02:00, Atlántico Central] UtcM1 [UTC-01:00, Azores, Cabo Verde.] Utc0 [UTC-00:00, Hora del meridiano de Greenwich, Dublín, Londres] UtcP1 [UTC+01:00, Ámsterdam, Berlín, Roma, París, África Central Occidental]

UtcP2 [UTC+02:00, Atenas, Estanbul, Cairo, Jerusalén] UtcP3 [UTC+03:00, Bagdad, Kuwait, Riyad, Moscú, Nairobi] UtcP330 [UTC+03:30, Teherán] UtcP4 [UTC+04:00, Abu Dhabi, Muscat, Baku, Tbilisi, Yerevan] UtcP430 [UTC+04:30, Kabul] UtcP5 [UTC+05:00, Ekaterinburg, Islamabad, Karachi, Tashkent] UtcP530 [UTC+05:30, Chennai, Kolkata, Mumbai, Nueva Delhi] UtcP545 [UTC+05:45, Kathmandú] UtcP6 [UTC+06:00, Almaty, Novosibirsk, Astana, Dacca] UtcP630 [UTC+06:30, Rangún] UtcP7 [UTC+07:00, Bangkok, Hanio, Yakarta, Krasnoyarsk] UtcP8 [UTC+08:00, Taipei, Pekín, Chongqing, Hong Kong, Urumqi] UtcP9 [UTC+09:00, Osaka, Sapporo, Tokio, Seúl, Yakutsk] UtcP930 [UTC+09:30, Adelaida, Darwin] UtcP10 [UTC+10:00, Canberra, Melbourne, Sidney, Guam, Hobart, Vladivostok]

UtcP11 [UTC+11:00, Magadan, Islas Solomón., Nueva Caledonia] UtcP12 [UTC+12:00, Auckland, Wellington, Fiji, Kamchatka, Islas Marshall.]

UtcP13 [UTC+13:00, Nuku'alofa] UtcP14 [UTC+14:00, Islas Espóradas Ecuatoriales] Unspecified [Zona horaria no especificada]Setting Type = Enum

sysconfig 65

Page 66: AttC5A3.Tmp

timeMuestra o permite establecer la hora actual del sistema.

Sintaxistime [hh:mm [:ss]] [-tz tz] [-d dl]

Opcioneshh Establece un nuevo valor de hora (0–23).mm Establece un nuevo valor de minutos (0–59).ss Establece un nuevo valor de 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 -440 y 1440 o 2047. Si no se encuentra el valor o seestablece como 2047, se establecerá 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.

DescripciónEste comando muestra o permite establecer la hora actual del sistema. Si no se utiliza ningúnparámetro, se mostrará la hora actual. La hora del sistema se actualizará si se especifican valoresde horas, minutos y segundos válidos.

NOTA:• 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 seencuentra en el intervalo incorrecto de horas/minutos/segundos.

• No se permiten espacios antes o después del carácter numérico. Tampoco se permiten espaciosinsertados en la secuencia numérica.

• El parámetro de segundos es opcional. Si no se especifica, se establecerá el cero para lossegundos de forma predeterminada.

EjemplosPara mostrar la hora actual del sistema:fs0:\> time16:51:03 (GMT+08:00)

Para establecer la hora actual del sistema:fs0:\> time 9:51:30fs0:\> time 9:51:31 (GMT+08:00)

Para establecer la hora del sistema y, a continuación, mostrar el valor del horario de verano:fs0:\> time 9:51:30fs0:\> time —d

09:51:31 (GMT+08:00) DST: Not Affected

66 Referencia de los comandos de UEFI Shell

Page 67: AttC5A3.Tmp

timezoneMuestra o permite establecer la información de zona horaria.

Sintaxistimezone [-s:hh:mm] [-l-b-f]

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.

DescripciónEste comando muestra o permite establecer la zona horaria actual del sistema. Si no se utilizaningún parámetro, se mostrará la zona horaria actual. Si se especifica un parámetro hh:mmválido, se actualizará la información de zona horaria del sistema.

EjemplosPara 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

touchPermite actualizar la fecha y la hora de un archivo con la fecha y la hora actuales.

Sintaxistouch [-r] file [file...]

Opciones-r Hace que la actualización se realice de forma recursiva en los subdirectorios.file Especifica el nombre o el patrón del archivo o directorio que se va a actualizar. Es posible

actualizar varios archivos a la vez.

DescripciónEste comando actualiza la fecha y la hora del archivo especificado con el parámetro file conla fecha y la hora actuales.Si se especifican varios archivos, el sistema continúa el procesamiento. El sistema procesará losarchivos de uno en uno e ignorará los errores.Este comando no puede cambiar la hora y la fecha de los archivos y directorios de solo lectura.

EjemploPara actualizar la fecha y hora de un archivo:fs0:\> touch myfile.txt

timezone 67

Page 68: AttC5A3.Tmp

typePermite enviar el contenido de un archivo al dispositivo de salida estándar.

Sintaxistype file [file...]

Opciónfile Especifica el nombre de archivo para mostrar.

DescripciónEste comando envía el contenido de un archivo al dispositivo de salida estándar. Si no se utilizaninguna opción, el comando intentará detectar el tipo de archivo. En caso de error, se asumiráque el tipo de archivo es UCS-2.

EjemplosPara mostrar un archivo de formato:fs0:\> type pause.nsh

# # Example script for 'pause' command#echo pause.nsh begin..\datetime pauseecho pause.nsh done.

Para mostrar varios archivos:fs0:\> type test.*How to Install?timestall 3000000time

verMuestra la información de versión para de UEFI Shell y del firmware UEFI subyacente.

Sintaxisver [ -s | -t ]

Opciones-s Muestra solo la versión de UEFI Shell.-t Muestra el contenido de resumen (abreviado).

DescripciónEste comando muestra información sobre la versión del firmware UEFI o de la versión de UEFIShell. La información se recupera a través de la tabla del sistema UEFI o de la imagen de Shell.

EjemploPara mostrar solo la versión de UEFI Shell.fs0:\> ver —s2.0

68 Referencia de los comandos de UEFI Shell

Page 69: AttC5A3.Tmp

Para mostrar la información acerva de la versión de firmware de UEFI Shell.fs0:\> verUEFI Interactive Shell v2.0Copyright 1982, 2014 Hewlett-Packard Development Company, L.P.UEFI v2.31 (HP, 0x00010000)ProLiant System BIOS - P79 (01/14/2014)

volMuestra la información del volumen de un sistema de archivos.

Sintaxisvol [fs] [-n volumelabel]vol [fs] [-d]

Opcionesfs Especifica el nombre del sistema de archivos para mostrar.-n volumelabel Especifica el nombre de la etiqueta del volumen. No es posible utilizar los

caracteres siguientes: % ^ * + = [ ] | : ; " < > ? / . No sepermite el uso de espacios en la etiqueta de volumen.

-d Especifica una etiqueta de volumen vacía.

DescripciónEste comando muestra la información de volumen de un sistema de archivos. Si no se especificala opción fs, el sistema tomará el sistema de archivos actual. Si se especifica -n, la etiquetadel volumen de fs se configura para el parámetro volumelabel. La longitud máxima delparámetro volumelabel es de 11 caracteres.

EjemplosPara 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 disk512 bytes in each allocation unit

Para cambiar la etiqueta de fs0:shell> vol fs0 –n help_testVolume 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 -dVolume has no label (rw) 1,457,664 bytes total disk space 220,160 bytes available on disk 512 bytes in each allocation unit

vol 69

Page 70: AttC5A3.Tmp

3 Ejecución y edición de secuencias de comandos de UEFIShell

La información siguiente describe las funciones de secuencias de comandos que proporciona UEFIShell.

Comandos de secuencias de comandos de UEFI Shell

EjemplosPara exportar todos los valores a un archivo:fs0:\> Sysconfig –export filename.txt

Para importar todos los valores en un archivo:fs0:\> Sysconfig –import filename.txt

Ejecución de secuencias de comandosEs posible llamar las secuencias de comandos de UEFI Shell de cualquiera de los dos métodossiguientes:

• «Habilitación del inicio automático de las secuencias de comandos de UEFI Shell» (página 70)

• «Ejecución manual de una secuencia de comandos de Shell» (página 70)

Habilitación del inicio automático de las secuencias de comandos de UEFI ShellLa ejecución automática de las secuencias de comandos de UEFI Shell predeterminadas se puedehabilitar o deshabilitar durante el inicio del shell. Cuando está habilitada, el shell busca el archivostartup.nsh en los sistemas de archivos FAT16 o FAT32 disponibles. HP recomienda tener unúnico archivo startup.nsh en un sistema de archivos.Para habilitar el inicio automático de secuencias de comandos de UEFI Shell:1. Obtenga acceso al menú System Utilities (Utilidades del sistema). Para obtener más

información, consulte «Acceso a las utilidades del sistema HP UEFI» (página 5).2. Desde la pantalla System Utilities (Utilidades del sistema), seleccione System

Configuration→BIOS/Platform Configuration (RBSU)→SystemOptions→UEFI Shell Options→UEFIShell Script Auto-Start (Configuración del sistema > BIOS/Configuración de plataforma [RBSU]> Opciones del sistema > Opciones de UEFI Shell > Inicio automático de secuencias decomandos de UEFI Shell) y, a continuación, pulse la tecla Intro.

3. Pulse la tecla F10 para guardar la selección.4. Vuelva a arrancar el servidor para que el cambio surta efecto.

Ejecución manual de una secuencia de comandos de ShellPara llamar manualmente una secuencia de comandos de Shell:1. Vaya a la ubicación del archivo de secuencia de comandos .nsh.2. Haga doble clic en el archivo o haga con el botón secundario sobre el archivo y, a

continuación, seleccione Open (Abrir).

Edición de secuencias de comandos de ShellPuede editar los archivos de secuencias de comandos sin conexión o en el Shell mediante elcomando edit. También puede utilizar el comando type para mostrar la secuencia de comandosen la pantalla.

70 Ejecución y edición de secuencias de comandos de UEFI Shell

Page 71: AttC5A3.Tmp

Ejemplos de secuencias de comandos de Shell

EjemplosLos siguientes ejemplos de secuencias de comandos muestran cómo capturar una configuración(exportar) para replicarla (importar) desde el archivo startup.nsh montado en un soporte virtualde iLO.

Ejemplo de exportación:fs0:\>

@echo -offclsset -v myfs 0if exist FS0:\* thenFS0:echo "FS0:\ Found!"goto FSFOUNDendifecho "FS0:\ not found in system"echo "Going to search first available file system from FS1, FS2,..., FS100"pausefor %a run (1 100)set -v myfs %aif exist FS%myfs%:\* thenFS%myfs%:echo "FS%myfs%:\ Found!"goto FSFOUNDendifendfor## No valid FS found in system, so exit nowecho "No valid File System (FS0, FS1,..., FS100) found in system"goto END:FSFOUNDif exist sysconfig_backup.txt thenecho ===========================================================================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 ===========================================================================pauserm sysconfig_backup.txtendifecho "Saving latest system configuration in sysconfig_backup.txt file."sysconfig -export sysconfig_backup.txt:ENDset -d myfs

Ejemplo de importación:fs0:\>

@echo -offclsset -v myfs 0if exist FS0:\sysconfig_backup.txt thenFS0:echo "FS0:\sysconfig_backup.txt Found!"goto FSFOUNDendifecho ===========================================================================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 ===========================================================================pausefor %a run (1 100)set -v myfs %a

Ejemplos de secuencias de comandos de Shell 71

Page 72: AttC5A3.Tmp

if exist FS%myfs%:\sysconfig_backup.txt thenFS%myfs%:echo "FS%myfs%:\sysconfig_backup.txt Found!"goto FSFOUNDendifendfor## No valid sysconfig_backup.txt found in system, so exit nowecho "No valid sysconfig_backup.txt found from File System (FS0, FS1,..., FS100)"goto END:FSFOUNDif exist sysconfig_backup.txt thenecho ===========================================================================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 ===========================================================================pausesysconfig -import sysconfig_backup.txtendif:ENDset -d myfs

72 Ejecución y edición de secuencias de comandos de UEFI Shell

Page 73: AttC5A3.Tmp

4 Uso del modelo de programación UEFIUEFI Shell ofrece una API de programación. Puede utilizar dicha API para escribir sus propiasaplicaciones UEFI para llamar a determinados protocolos o API de programación del Shell. Paraobtener más información, consulte la Especificación de UEFI Shell y EDK2. Tal como se muestraen la Tabla 12 (página 73), UEFI Shell dispone de una API de programación. La funciónEFI_SHELL_PROTOCOL proporciona servicios de shell a las aplicaciones UEFI. Esta funciónproporciona a las aplicaciones de UEFI Shell acceso a funciones shell de bajo nivel como, porejemplo, 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 shellde inicio.

Tabla 12 API de aplicaciones UEFI

DescripciónNombre de funciónTipo de función

Hace que el shell analice y ejecute la líneade comandos.

ExecuteEFI_SHELL_EXECUTE

Obtiene la variable de entorno.GetEnvEFI_SHELL_GET_ENV

Modifica una variable de entorno específica.SetEnvEFI_SHELL_SET_ENV

Recupera el alias de un comando shellespecífico.

GetAliasEFI_SHELL_GET_ALIAS

Añade o quita el alias de un comando shellespecífico.

SetAliasEFI_SHELL_SET_ALIAS

Devuelve información de ayuda sobre uncomando específico.

GetHelpTextEFI_SHELL_GET_HELP_TEXT

Devuelve la ruta del dispositivocorrespondiente a una asignación.

GetDevicePathFromMapEFI_SHELL_GET_DEVICE_PATH_FROM_MAP

Devuelve la asignación que corresponde auna ruta de dispositivo determinada.

GetMapFromDevicePathEFI_SHELL_GET_MAP_FROM_DEVICE_PATH

Convierte una ruta de archivo en una ruta dedispositivo, donde se han sustituido todas las

GetDevicePathFromFilePathEFI_SHELL_GET_DEVICE_PATH_FROM_FILE_PATH

asignaciones por las rutas de dispositivocorrespondientes.

Convierte una ruta de dispositivo en una rutade archivo, la parte de la ruta del dispositivo

GetFilePathFromDevicePathEFI_SHELL_GET_FILE_PATH_FROM_DEVICE_PATH

correspondiente a una de las asignacionesse sustituye por dicha asignación.

Crea/actualiza/elimina una asignación entreun dispositivo y una ruta de dispositivo.

SetMapEFI_SHELL_SET_MAP

Devuelve el directorio actual de undispositivo.

GetCurDirEFI_SHELL_GET_CUR_DIR

Cambia el directorio actual de un dispositivo.SetCurDirEFI_SHELL_SET_CUR_DIR

Abre los archivos que coinciden con el patrónde ruta especificado.

OpenFileListEFI_SHELL_OPEN_FILE_LIST

Libera la lista de archivos que se creómediante OpenFileList().

FreeFileListEFI_SHELL_FREE_FILE_LIST

Elimina los archivos duplicados de la lista dearchivos especificada.

RemoveDupInFileListEFI_SHELL_REMOVE_DUP_IN_FILE_LIST

Devuelve si se están procesando archivos desecuencias de comandos.

BatchIsActiveEFI_SHELL_BATCH_IS_ACTIVE

73

Page 74: AttC5A3.Tmp

Tabla 12 API de aplicaciones UEFI (continuación)

DescripciónNombre de funciónTipo de función

Determina si el shell activo es el shell raíz.IsRootShellEFI_SHELL_IS_ROOT_SHELL

Habilita el modo de visualización deresultados con saltos de página.

EnablePageBreakEFI_SHELL_ENABLE_PAGE_BREAK

Deshabilita el modo de visualización deresultados con saltos de página.

DisablePageBreakEFI_SHELL_DISABLE_PAGE_BREAK

Obtiene el estado de habilitación del modode visualización de resultados con saltos depágina.

GetPageBreakEFI_SHELL_GET_PAGE_BREAK

Obtiene el nombre del dispositivoespecificado por el identificador deldispositivo.

GetDeviceNameEFI_SHELL_GET_DEVICE_NAME

Devuelve información sobre un identificadorde archivo específico.

GetFileInfoEFI_SHELL_GET_FILE_INFO

Modifica la información sobre unidentificador de archivo específico.

SetFileInfoEFI_SHELL_SET_FILE_INFO

Abre un archivo y devuelve un identificadorde archivo a partir de un nombre de archivoespecífico.

OpenFileByNameEFI_SHELL_OPEN_FILE_BY_NAME

Cierra un archivo abierto.CloseFileEFI_SHELL_CLOSE_FILE

Crea un nuevo archivo.CreateFileEFI_SHELL_CREATE_FILE

Lee los datos de un archivo.ReadFileEFI_SHELL_READ_FILE

Escribe los datos en un archivo.WriteFileEFI_SHELL_WRITE_FILE

Elimina un archivo.DeleteFileEFI_SHELL_DELETE_FILE

Permite eliminar un archivo por nombre.DeleteFileByNameEFI_SHELL_DELETE_FILE_BY_NAME

Devuelve a la posición de lectura/escrituraactual dentro de un archivo.

GetFilePositionEFI_SHELL_GET_FILE_POSITION

Modifica la posición de lectura/escrituraactual dentro de un archivo.

SetFilePositionEFI_SHELL_SET_FILE_POSITION

Escribe todos los datos almacenados en búferen un archivo.

FlushFileEFI_SHELL_FLUSH_FILE

Devuelve todos los archivos que coincidancon un patrón en una lista de archivos.

FindFilesEFI_SHELL_FIND_FILES

Devuelve todos los archivos de un directorioespecificado en una lista de archivos.

FindFilesInDirEFI_SHELL_FIND_FILES_IN_DIR

Devuelve el tamaño de un archivo.GetFileSizeEFI_SHELL_GET_FILE_SIZE

Devuelve el directorio raíz de un sistema dearchivos.

OpenRootEFI_SHELL_OPEN_ROOT

Devuelve el directorio raíz de un sistema dearchivos en un identificador determinado.

OpenRootByHandleEFI_SHELL_OPEN_ROOT_BY_HANDLE

Evento que muestra UEFI Shell cuando elusuario pulsa CTRL + C para indicar que la

ExecutionBreakEFI_EVENT

ejecución del comando de UEFI Shell actualdebe interrumpirse.

Versión principal del entorno de shell.MajorVersionUINT32

Versión secundaria del entorno de shell.MinorVersionUINT32

74 Uso del modelo de programación UEFI

Page 75: AttC5A3.Tmp

Esta secuencia de comandos de ejemplo muestra algunas funciones de protocolo.

Ejemplos de secuencias de comandos de Shell

EjemplosLos siguientes ejemplos de secuencias de comandos muestran cómo capturar una configuración(exportar) para replicarla (importar) desde el archivo startup.nsh montado en un soporte virtualde iLO.

Ejemplofs0:\>

/** @file This is an example Shell Application. Note that there are other ways to add a command to the shell. This example demonstrates just one.

Copyright (c) 2013 Hewlett-Packard Development Company, L.P.

This software contains information confidential and proprietary to Hewlett-Packard Company. It shall not be reproduced in whole or in part, or transferred to other documents, or disclosed to third parties, or used for any purpose other than that for which it was obtained without the prior written consent of Hewlett-Packard Company.

**/

#include <Protocol/EfiShell.h>#include <Library/UefiLib.h>#include <Library/UefiBootServicesTableLib.h>

/** Implements simple shell HelloWorld Application that prints out the string "Hello World" to the screen and then display UEFI Shell revision and registered environment variables in system. This example demonstrates how a new UEFI Shell Application can be created to run at UEFI Shell Prompt.

@param ImageHandle Handle to the Image @param SystemTable Pointer to the System Table

@retval EFI_SUCCESS In all cases**/EFI_STATUSEFIAPIUefiMain ( IN EFI_HANDLE ImageHandle, IN EFI_SYSTEM_TABLE *SystemTable ){ EFI_SHELL_PROTOCOL *UefiShellProtocol; CONST CHAR16 *ConstEnvNameList; CONST CHAR16 *Value; EFI_STATUS Status;

Print (L"Hello World!\n");

// // Locate UEFI Shell Protocol // Status = gBS->OpenProtocol ( ImageHandle, &gEfiShellProtocolGuid, (VOID **)&UefiShellProtocol, ImageHandle, NULL, EFI_OPEN_PROTOCOL_GET_PROTOCOL );

if (EFI_ERROR(Status)) { // // Search for the shell protocol // Status = gBS->LocateProtocol ( &gEfiShellProtocolGuid, NULL, (VOID **)&UefiShellProtocol

Ejemplos de secuencias de comandos de Shell 75

Page 76: AttC5A3.Tmp

); if (EFI_ERROR(Status)) { UefiShellProtocol = NULL; return EFI_SUCCESS; } }

if (UefiShellProtocol != NULL) { // // Sample to read UEFI Shell Major and Minor Version Variables // Print (L"UEFI Shell Revision: %d.%d\n", UefiShellProtocol->MajorVersion, UefiShellProtocol->MinorVersion);

// // Sample to get list of all environment variables // ConstEnvNameList = UefiShellProtocol->GetEnv (NULL); if (ConstEnvNameList == NULL) { return EFI_SUCCESS; }

Print (L"\n"); Print (L"ENVIRONMENT VARIABLES:\n"); Print (L"\n");

// // Sample to get and display all environment variables // while (*ConstEnvNameList != CHAR_NULL){ Value = UefiShellProtocol->GetEnv (ConstEnvNameList); Print (L"%8s = %s\n", ConstEnvNameList, Value); ConstEnvNameList += StrLen (ConstEnvNameList)+1; } }

return EFI_SUCCESS;}

76 Uso del modelo de programación UEFI

Page 77: AttC5A3.Tmp

5 Códigos de estado de comandos de UEFI ShellLa Tabla 13 (página 77) muestra una lista de los códigos de estado que puede mostrar UEFI Shellal ejecutar un comando. Los códigos de varían según el comando.

Tabla 13 Códigos de estado de comandos de UEFI Shell

SignificadoCódigo

La acción se completó tal como se solicitó.SHELL_SUCCESS

No se pudo encontrar el archivo o conjunto de archivos de destino.SHELL_NOT_FOUND

La función no se puede realizar debido a una infracción de seguridad.Cuando esté activado el arranque seguro, las aplicaciones UEFI que no

SHELL_SECURITY_VIOLATION

estén firmadas digitalmente con uno de los certificados de arranque segurointegrados no podrán ejecutarse y el sistema mostrará el código de estadoSECURITY_VIOLATION.

Uno de los parámetros pasados tiene un formato incorrecto o tiene unque está fuera de los límites.

SHELL_INVALID_PARAMETER

No se pudo completar una solicitud para establecer una variable de formano volátil. La solicitud no volátil resultante se convierte en una solicitudvolátil.

SHELL_OUT_OF_RESOURCES

El soporte en el que se llevará a cabo la acción está protegido contraescritura.

SHELL_WRITE_PROTECTED

Error de hardware que impide la finalización de este comando.SHELL_DEVICE_ERROR

77

Page 78: AttC5A3.Tmp

6 Asistencia y otros recursosContacto con HP

Para obtener información de soporte técnico sobre todos los países, visite la página del Centrode soporte de HP:http://www.hp.com/go/hpscAntes de ponerse en contacto con HP, recopile la información siguiente:

• Nombre y número del modelo del producto

• Número de registro de asistencia técnica (si corresponde)

• Números de serie del producto

• Mensajes de error

• Tipo y revisión del sistema operativo

• Preguntas detalladas

Servicio de subscripciónInicie sesión en http://www.hp.com/go/myadvisory para recibir por correo electrónico, avisossobre comunicaciones de soporte de productos, actualizaciones de controladores, revisiones desoftware, actualizaciones de firmware o información sobre consumibles.Para cambiar las opciones de alertas de soporte que recibe actualmente, haga clic en el enlaceSign in (Iniciar sesión) de la derecha.

Información relacionadaLos documentos siguientes ofrecen información relacionada:

• HP UEFI System Utilities User Guide (Guía del usuario de las utilidades del sistema HP UEFI)

• HP UEFI Release Notes (Notas de la versión de HP UEFI)Estos documentos están disponibles en el siguiente sitio web:

http://www.hp.com/go/ProLiantUEFI/docs

Páginas web• Especificación de UEFI: http://www.uefi.org/specifications

• Recursos de aprendizaje UEFI: http://www.uefi.org/learning_center

• Proyecto UEFI EDK2 en SourceForge (descarga de especificaciones y código): http://sourceforge.net/apps/mediawiki/tianocore

Convenciones tipográficasTabla 14 Convenciones del documento

ElementoConvención

Texto azul: Tabla 14, «Convenciones deldocumento»

• Vínculos de referencia cruzada y direcciones de correoelectrónico

• Referencia cruzada a la definición del glosario deltérmino en texto azul

Direcciones de correo electrónicoTexto azul subrayado en negrita

Direcciones de páginas webAzul, texto subrayado: http://www.hp.com

78 Asistencia y otros recursos

Page 79: AttC5A3.Tmp

Tabla 14 Convenciones del documento (continuación)

ElementoConvención

Texto en Negrita • Teclas que se pulsan

• Texto escrito en un elemento de la interfaz gráfica delusuario, como por ejemplo un cuadro

• Elementos de la interfaz gráfica del usuario que seseleccionan o sobre los que se hace clic, como loselementos de menú y de listas, los botones, las fichas ylas casillas de verificación

Énfasis del textoTexto en cursiva

Texto monoespaciado • Nombres de archivos y directorios

• Salida del sistema

• Código

• Comandos, sus argumentos y valores de argumentos

Texto monoespaciado, en cursiva • Variables de código

• Variables de comando

Texto con fuente monoespaciada resaltadoTexto monoespaciado, en negrita

¡ADVERTENCIA! Indica que si no se siguen las instrucciones podrían producirse daños personaleso incluso la muerte.

ATENCIÓN: Indica que si no se siguen las instrucciones se pueden dañar los equipos o los datos.

IMPORTANTE: Proporciona información aclaratoria o instrucciones específicas.

NOTA: Proporciona información adicional.

SUGERENCIA: Proporciona sugerencias y accesos directos.

Software HP Insight Remote SupportHP recomienda registrar el dispositivo para obtener asistencia remota y habilitar la distribuciónmejorada de su garantía de HP, del servicio HP Care Pack o del acuerdo de asistencia contractualde HP. HP Insight Remote Support complementa su supervisión de manera continua para garantizarla máxima disponibilidad de sistema proporcionando diagnósticos de eventos inteligentes ypresentaciones automáticas y seguras de notificaciones de eventos de hardware a HP, que iniciaráuna resolución rápida y adecuada basándose en su nivel de servicio de producto. Las notificacionesse pueden enviar a su distribuidor del canal autorizado de HP para un servicio in situ, si estáconfigurado y disponible en su país.Para obtener más información, consulte HP Insight Remote Support and Insight Online Setup Guidefor ProLiant Gen8 Servers and BladeSystem c-Class Enclosures (Guía de configuración de HPInsight Remote Support e Insight Online para servidores ProLiant Gen8 y carcasas BladeSystemc-Class) en el sitio web de HP (http://www.hp.com/go/enterprise/docs). HP Insight RemoteSupport está disponible como parte de la garantía de HP, del servicio HP Care Pack Service odel acuerdo de soporte contractual de HP.

Software HP Insight Remote Support 79

Page 80: AttC5A3.Tmp

HP Insight OnlineHP Insight Online es una capacidad del portal Centro de soporte de HP. En combinación con laconexión central de HP Insight Remote o la conexión directa de HP Insight Online, añadeautomáticamente información sobre el estado del dispositivo, los activos y la compatibilidad juntocon información sobre el contrato y la garantía. Además, la centraliza en un único panel de controlpersonalizado que puede consultarse desde cualquier lugar y en cualquier momento. El panel decontrol organiza los datos de TI y de servicio técnico para ayudarle a entender esa informacióny a responder a ella más rápidamente. Con su autorización expresa, un distribuidor del canalautorizado de HP también puede consultar de forma remota su entorno de TI en HP Insight Online.Para obtener más información, consulte los siguientes documentos en el sitio w eb de HP (http://www.hp.com/go/insightremotesupport/docs):

• Guía de usuario de HP Insight Online

• Guía de configuración de HP Insight Remote Support e Insight Online para servidores HPProLiant y receptáculos BladeSystem de clase C)

80 Asistencia y otros recursos

Page 81: AttC5A3.Tmp

7 Comentarios sobre la documentaciónHP se compromete a proporcionar documentación que se adapte a sus necesidades. Paraayudarnos a mejorar la documentación, envíe cualquier error, sugerencia o comentario aComentarios sobre la documentación ([email protected]). Incluya en el mensaje el título deldocumento y el número de referencia, el número de versión o la URL.

81

Page 82: AttC5A3.Tmp

GlosarioACR Array Configuration Replication Utility (Utilidad de replicación de la configuración de array)ASR Automatic Server Recovery (Recuperación automática del servidor)BIOS Basic Input/Output System (Sistema básico de entrada y salida)CLI Command Line Interface (Interfaz de línea de comandos)CNA Converged network adapter (Adaptador de red convergente)CONREP Configuration Replication Utility (Utilidad de replicación de la configuración)ECC Error Checking and Correcting (Revisión y corrección de errores)ECP Extended Capabilities Port Mode (Modo de puerto con capacidades extendidas)EMS Emergency Management Services (Servicios de gestión de emergencias)EPP Enhanced Parallel Port Mode (Modo de puerto paralelo mejorado)IDE Integrated Drive Electronics (Electrónica de unidades integrada)iLO Integrated Lights-OutIMD Integrated Management Display (Visualización de gestión integrada)IOMMU I/O Memory Management Unit (Unidad de gestión de memoria de E/S)IPL Initial Program Load (Carga del programa inicial)IRQ Interrupt Request (Solicitud de interrupción)LPT Local Port (Puerto local)MEMBIST Memory Built-in Self Test (Autocomprobación integrada de memoria)MPS Multi-Processor Specification (Especificación de multiprocesador)NIC Network Interface Controller (Controlador de interfaz de red)NMI Non-Maskable Interrupt (Interrupción no enmascarable)NUMA Non-Uniform Memory Architecture (Arquitectura de memoria no uniforme)NVRAM Non-Volatile Memory (Memoria permanente)ORCA Option ROM Configuration for ArraysPCC Processor Clocking Control (Control de frecuencia de reloj del procesador)PCI Peripheral component interface (Interfaz de componentes periféricos)PCI-X Peripheral Component Interconnect Extended (Interconexión de componentes periféricos extendida)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)RAID Redundant Array of Inexpensive (or Independent) Disks (Array redundante de discos

independientes)RBSU ROM-Based Setup Utility (Utilidad de configuración basada en ROM)ROM Read-Only Memory (Memoria permanente)RTC Real-Time Clock (reloj de tiempo real)SPP Standard Parallel Port Mode (Modo de puerto paralelo estándar)TPM Trusted platform module (Módulo de plataforma de confianza)UEFI Unified Extensible Firmware Interface (Interfaz de firmware extensible unificada)VGA Video Graphics Array (Adaptador de gráficos de vídeo)VSP Virtual Serial Port (Puerto serie virtual)

82 Glosario

Page 83: AttC5A3.Tmp

Índice

Aacceso a UEFI Shell, 5acceso a UEFI Shell desde una conexión de consola de

serie, 11acceso a un sistema de archivos, 21aplicación, API, 73Archivo

acceder al sistema de archivos fs0 desde el shell, 21archivos nsh, 5arranque de UEFI Shell, 10arranque, lista de secuencia, 8ayuda, 17, 18

obtener, 78

Ccambio de la secuencia de arranque UEFI, 9Comandos de UEFI Shell, 21comandos y capacidades, 5confirmación, solicitud, 17contacto con HP, 78contraseñas, 55control del resultado de los comandos, 14convenciones

documento, 78símbolos en el texto, 79

convenciones tipográficas, 78

Ddocumentación

envío de comentarios sobre, 81sitio web de HP, 78

documentación relacionada, 78documento

convenciones, 78documentos

información relacionada, 78

Eedición, secuencias de comandos de Shell, 70ejecución de secuencias de comandos, 70ejemplo, secuencias de comandos de Shell, 71, 75eliminación de la solicitud de confirmación al usuario, 17

HHP

soporte técnico, 78suscripción, servicio, 78

HP Insight Online, 80

Llínea de comandos, autocompletado, 13

tecla, 13línea de comandos, ayuda, 17, 18

Mmanual, ejecución de secuencia de comandos de Shell,

70

Ppáginas web, 78pantalla HP ProLiant POST, 5primeros pasos, 13

Ssaltos de página globales, 15secuencias de comandos, comandos, 70serie, consola, conexión, 11servicio de suscripción, HP, 78Shell, ejecución manual de una secuencia de comandos,

70Shell, inicio automático de secuencias de comandosstartup.nsh, 70

Shell, referencia de comandossintaxis de comandos, ejemplos, 13

Shell, secuencias de comandosedición, 70ejecución manual, 70ejemplos, 71, 75

símbolos en el texto, 79sintaxis de la línea de comandos, 13sistema de archivos, 21sitios web

HP, servicio de suscripción, 78manuales de producto, 78

soporte técnico, 78HP, 78

sysconfig, atributos, 56

Ttexto, símbolos, 79

UUEFI Shell integrado

activar, 8adición a lista de secuencia de arranque, 8

UEFI Shell, códigos de estado de comandoscódigos de estado, 77

UEFI Shell, comandosalias, 22attrib, 23cd, 24cls, 25comp, 25cp, 26date, 28dblk, 29devices, 29devtree, 31dh, 32

83

Page 84: AttC5A3.Tmp

dh, detalles, 33dmem, 33drivers, 34echo, 35edit, 36eficompress, 37efidecompress, 37exit, 37fwupdate, 38getmtc, 38goto, 38help, 39ls, información del archivo, 42ls, información del volumen, 42ls/dir, 40map, 42map, detalles, 44memmap, 44memmap, detalles, 45mkdir, 45mode, 46mv, 47openinfo, 48parse, 48pause, 49pci, 50reset, 50rm/del, 51set, 52setsize, 53shift, 54smbiosview, 54stall, 55sysconfig, 55sysconfig, atributos, 56time, 66timezone, 67touch, 67type, 68ver, 68vol, 69

UEFI Shell, comandos de secuencias de comandos, 70UEFI Shell, estado de comandos

código de estado, estado, 77UEFI Shell, inicio automático de secuencias de comandos,

70UEFI Shell, referencia de comandos

línea de comandos, sintaxis, 13UEFI Shell, símbolo del sistema, 10UEFI, API de aplicación, 73UEFI, modelo de programación, 73UEFI, modo, 7UEFI, secuencia de arranque, 9único, arranque, menú, 10utilidades del sistema

acceder, 5

Vvisualización de la ayuda de los comandos, 17

comando ls, 19comandos que empiezan por un carácter determinado,

19todos los comandos, ayuda, 17

visualización de la ayuda de un comando específico, 18

84 Índice