Operaciones de línea de comandos

Puede usar la línea de comandos para ejecutar la herramienta Windows OS Optimization Tool for Omnissa Horizon.

Especifique los parámetros para controlar el comportamiento. Abra una ventana del símbolo del sistema como administrador.

A continuación se indican las principales opciones disponibles a través de la línea de comandos. Cada tarea principal cuenta con opciones de línea de comandos adicionales y una descripción detallada que se incluyen en las secciones siguientes.

Para ejecutar el comando, utilice el archivo EXE de Windows OS Optimization Tool, el cual descargó como se describe en Obtener Omnissa Windows OS Optimization Tool for Horizon.

Ejecute la línea de comandos como administrador y use las opciones adecuadas.

Opciones principales

Aquí, se utiliza la cadena optimization-tool.exe para representar el archivo EXE descargado. Cuando ejecute los comandos en su sistema, reemplace esa cadena por el nombre real de ese archivo EXE.

Importante: Para facilitar la lectura, las opciones se muestran en líneas separadas. Sin embargo, al ejecutar el comando, la línea de comandos no debe contener saltos de línea y debe introducirse como un único comando.

optimization-tool.exe [-h]

optimization-tool.exe [-v]

optimization-tool.exe [-optimize|-o]

optimization-tool.exe [-generalize|-g]

optimization-tool.exe [-finalize|-f]

optimization-tool.exe [-reboot|-shutdown]

donde

Parámetro	Descripción
-h	Muestra la ayuda de la línea de comandos.
-v	Habilita el modo detallado y muestra mensajes detallados.
-optimize|-o	Optimiza la imagen. Para obtener información sobre los parámetros de optimización que se deben usar con la opción -optimize, consulte la sección Optimizar los parámetros de la línea de comandos en esta página.
-generalize|-g	Generaliza Windows mediante la ejecución de sysprep.
-finalize|-f	Realiza tareas de limpieza y borra la información especificada.
-reboot	Reinicia el equipo después de que se hayan completado todas las operaciones.
-shutdown	Apaga el equipo después de que se hayan completado todas las operaciones.

Optimizar el funcionamiento de la línea de comandos

Puede utilizar los parámetros de la línea de comandos que se indican en la siguiente tabla al optimizar una imagen mediante la línea de comandos.

Importante: Antes de ejecutar el comando, asegúrese de que lo está haciendo en una de las versiones de sistema operativo Windows compatibles y que no intenta ejecutarlo en una versión de Windows incompatible.

[-r report_file_path_name]

[-o [no-item | all-item]]

[-applyoptimization settings_file.json]

[-t template]

[-reboot | -shutdown]

donde

Parámetro	Descripción
[-r report_file_path_name]	Guarda el informe de análisis como un archivo con el nombre especificado.
[-o [no-item | all-item]]	Optimiza los elementos con el nivel especificado y los superiores. Si no se especifica el parámetro -o, no se realizará ninguna optimización. -o all-item ejecuta todos los elementos de la plantilla predeterminada o seleccionada. -o no-item borra todas las selecciones de la plantilla. Si no se proporciona ningún valor después de -o, la herramienta utilizará las selecciones predeterminadas de la plantilla.
[-applyoptimization settings_file.json]	Aplica la optimización en función del archivo JSON especificado. El archivo JSON se crea mediante el botón Exportar selecciones de la pestaña Optimizar de la herramienta. Siga los pasos indicados en Optimizar imagen.
[-t template]	Especifica la plantilla que se utilizará para la optimización. La plantilla puede ser el nombre de una plantilla del repositorio de plantillas predeterminado o la ruta de acceso absoluta de un archivo de plantilla. Por ejemplo, -t "Omnissa Templates\Windows 10, 11 and Server 2019, 2022" Si no se especifica el parámetro -t, se utilizará la plantilla predeterminada.
[-reboot | -shutdown]	Reinicia o apaga el equipo después de que se hayan completado todas las operaciones.

Ejemplos de optimización

• Generar un informe de análisis sin realizar ninguna optimización

  optimization-tool.exe -r c:\reports\

• Optimizar la imagen mediante la plantilla predeterminada y los elementos seleccionados predeterminados para optimizar

  optimization-tool.exe -o

• Optimizar el uso de la plantilla predeterminada solo para los elementos recomendados y obligatorios. Mostrar mensajes detallados.

  optimization-tool.exe -o recommended -v

• Optimizar mediante la importación de las selecciones de optimización de un archivo JSON que contiene elementos seleccionados previamente

  optimization-tool.exe -o -v -applyoptimization my-settings.json

• Optimizar todos los elementos seleccionados predeterminados mediante una plantilla de Omnissa especificada.

  optimization-tool.exe -o -t "Omnissa Templates\Windows 10, 11 and Server 2022, 2025"

• Optimizar todos los elementos seleccionados predeterminados mediante una plantilla personalizada especificada.

  optimization-tool.exe -o -t "My Templates\My Windows Server 2022"

• Optimizar todos los elementos seleccionados predeterminados mediante la plantilla especificada, con la plantilla ubicada en la carpeta templates

  optimization-tool.exe -o -t templates

• Optimizar todos los elementos seleccionados predeterminados mediante el archivo de plantilla especificado

  optimization-tool.exe -o -t c:\temp\myTmpl.xml

• Optimizar el uso de la plantilla predeterminada y los elementos seleccionados de forma predeterminada. Escribir los resultados en un archivo

  optimization-tool.exe o -v > c:\temp\mylog.txt 2>&1

Controlar las opciones comunes de optimización

Puede especificar opciones comunes al ejecutar el comando optimize. (Puede consultar los elementos comparables de la interfaz de usuario en la sección Configurar los ajustes de Opciones comunes de la página Optimizar imagen.)

optimization-tool.exe -o

[-SyncHkcuToHku [enable | disable]]

[-visualeffect [performance | balanced | quality | enablehardwareacceleration]]

[-notification [enable | disable]]

[-windowsupdate [enable | disable]]

[-officeupdate [enable | disable]]

[-windowsSearch [enablecortana | searchboxasicon | searchboxasinputbox]]

[-storeapp [keep-all | remove-all [--exclude [Alarms | ScreenSketch | Camera | SoundRecorder | Calculator | StickyNotes | Paint3D | Photos | WebExtension | MSTeams]]]

[-background [#000000 | enablecustomization | disablecustomization]]

[-firewall [enable | disable]]

[-antivirus [enable | disable]]

[-securitycenter [enable | disable]]

[-Smartscreen [enable | disable]]

[-HVCI [enable | disable]

[-OneDrive [enable | disable]]

donde

Área	Parámetro	Descripción
SyncHkcuToHku	[-SyncHkcuToHku [enable | disable]]	Especifica si se debe habilitar o deshabilitar la sincronización de las claves de registro HKU (usuario actual) con el subárbol del registro de usuario predeterminado. El registro de usuario predeterminado se utiliza para crear nuevos perfiles de usuario. Este parámetro está habilitado de forma predeterminada.
Efecto visual	[-visualeffect [performance | balanced | quality | enablehardwareacceleration | disablehardwareacceleration]]	Especifica el nivel de efectos visuales. performance desactiva todos los ajustes de efectos visuales para priorizar el rendimiento. balanced desactiva todos los ajustes de efectos visuales aparte de los ajustes de Windows Suavizar bordes para las pantallas de fuentes y Usar sombra paralela en las etiquetas de iconos del escritorio. quality activa todos los ajustes de efectos visuales. Esto prioriza la experiencia del usuario, pero consume más recursos. enablehardwareacceleration habilita la aceleración de hardware para las aplicaciones. Esta opción se recomienda cuando se utilizan tarjetas GPU en máquinas virtuales de servidor host. disablehardwareacceleration deshabilita la aceleración de hardware para las aplicaciones. Utilice esta opción cuando la aceleración por GPU no esté disponible, no sea necesaria o provoque problemas de compatibilidad o de visualización. Ejemplo: Optimice utilizando la plantilla predeterminada con los elementos seleccionados por defecto y configurando las opciones comunes de visual effect en performance. OmnissaHorizonOSOptimizationTool.exe -o -visualeffect performance
Notificación	[-notification [enable | disable]]	Especifica si las notificaciones del sistema están habilitadas o deshabilitadas. Entre estas se incluyen sugerencias de globo, notificación de pantalla de bloqueo, y notificaciones de seguridad y mantenimiento. Ejemplo: Optimice utilizando la plantilla predeterminada con los elementos seleccionados por defecto y deshabilitando las notificaciones del sistema. OmnissaHorizonOSOptimizationTool.exe -o -notification disable
Windows Update	[-windowsupdate [enable | disable]]	Especifica si Windows Update está habilitado o deshabilitado. Cuando está habilitada, se descargan e instalan las actualizaciones de Windows. Con los escritorios no persistentes, se recomienda deshabilitar las actualizaciones de Windows y controlar las actualizaciones a través de imagen maestra y actualizar el grupo en Horizon. Ejemplo: Optimice utilizando la plantilla predeterminada con los elementos seleccionados por defecto pero dejando habilitadas las actualizaciones de Windows. OmnissaHorizonOSOptimizationTool.exe -o -windowsupdate enable
Actualización de Office	[-officeupdate [enable | disable]]	Especifica si desea activar el servicio de actualización para Office 365, 2016 y 2019 (Click-to-Run).
Windows Search	[-windowsSearch [enablecortana | searchboxasicon]]	Especifica si desea habilitar Cortana y cambiar la entrada de la barra de tareas de Cortana a una lupa. enablecortana mantiene disponible Cortana y su función de búsqueda. Searchboxasicon muestra el cuadro de búsqueda como un icono de lupa en la barra de tareas y no como un campo de entrada. Ejemplo: Optimice utilizando la plantilla predeterminada con los elementos seleccionados por defecto, pero dejando Cortana activada y mostrando el cuadro de búsqueda como un icono de lupa en la barra de tareas de Windows. OmnissaHorizonOSOptimizationTool.exe -o -windowssearch enablecortana searchboxasicon
Aplicaciones de Store	[-storeapp [keep-all | remove-all [--exclude [Alarms | ScreenSketch | Camera | SoundRecorder | Calculator | StickyNotes | Paint3D | Photos | WebExtension | MSTeams]]]	Especifica las aplicaciones de la Tienda Windows que se eliminarán. keep-all retiene todas las aplicaciones de Microsoft Store. remove-all elimina todas las aplicaciones de Microsoft Store. --exclude se utiliza junto con el parámetro remove-all para conservar ciertas aplicaciones. Ejemplo: Optimice utilizando la plantilla predeterminada con los elementos seleccionados por defecto y eliminando todas las aplicaciones de Microsoft Store, excepto las de alarma y calculadora. OmnissaHorizonOSOptimizationTool.exe -o -storeapp remove-all --exclude alarms calculator
Fondo	[-background [#000000 | enablecustomization | disablecustomization]]	Establece el fondo (fondo de pantalla) en un color sólido donde #000000 es el valor hexadecimal del color. Consulte https://htmlcolorcodes.com/color-names/ para obtener una lista de los posibles colores y los valores hexadecimales correspondientes. enablecustomization permite personalizar el fondo. disablecustomization impide que se pueda personalizar el fondo. Ejemplo: Optimice utilizando la plantilla predeterminada con los elementos seleccionados por defecto y estableciendo el fondo en azul cielo. OmnissaHorizonOSOptimizationTool.exe -o -background #87CEEB Ejemplo: Optimice utilizando la plantilla predeterminada con los elementos seleccionados por defecto y estableciendo el fondo en azul cielo. OmnissaHorizonOSOptimizationTool.exe -o -background #87CEEB
Firewall	[-firewall [enable | disable]]	Especifica si se debe habilitar el firewall de Windows. Esta configuración está habilitada de forma predeterminada.
Antivirus	[-antivirus [enable | disable]]	Especifica si se activa el antivirus integrado en el sistema operativo. Esta configuración está habilitada de forma predeterminada.
Centro de seguridad	[-securitycenter [enable | disable]]	Especifica si se debe habilitar el centro de seguridad. Esta configuración está habilitada de forma predeterminada.
SmartScreen	[-smartscreen [enable | disable]]	Especifica si se debe habilitar Windows SmartScreen. Este ajuste está deshabilitado de forma predeterminada.
HVCI	[-hvci [enable | disable]]	Especifica si se debe habilitar la integridad del código protegida por el hipervisor (HVCI). Este ajuste está deshabilitado de forma predeterminada.
OneDrive	[-onedrive [enable | disable]]	Especifica si se debe habilitar OneDrive. Esta configuración está habilitada de forma predeterminada.

Generalizar el funcionamiento de la línea de comandos

La generalización de la imagen de Windows elimina la información específica del equipo para que la imagen se pueda clonar e implementar de forma segura en toda la empresa. Esta acción realiza un Sysprep con el archivo de respuesta proporcionado: unattend.

OmnissaHorizonOSOptimizationTool.exe -g \[answerfile\] \[-reboot | -shutdown\]

Donde:

• answerfile- El archivo de respuesta de Sysprep. Si no se proporciona ninguno, se utiliza el archivo de respuesta de sysprep integrado.

Notas:

• La operación de generalización requiere que Windows esté en modo de auditoría.
• Será necesario reiniciar Windows una vez finalizada la operación de generalización.
• Una operación de generalización puede realizarse al mismo tiempo que una operación de optimización.
• Una operación de generalización no puede realizarse al mismo tiempo que una operación de finalización.

Ejemplos

Generalizar utilizando un archivo de respuesta unattend de Sysprep proporcionado: OmnissaHorizonOSOptimizationTool.exe -g "C:\\unattend.xml"

Generalizar utilizando el archivo de respuesta unattend de Sysprep incorporado: OmnissaHorizonOSOptimizationTool.exe -generalize

Generalizar utilizando el archivo de respuesta unattend de Sysprep incorporado y reiniciar al terminar: OmnissaHorizonOSOptimizationTool.exe -generalize -reboot

Finalizar el funcionamiento de la línea de comandos

Al finalizar la máquina virtual, se realizan tareas para limpiar el sistema y borrar la información. Por lo general, se recomienda ejecutar estas tareas como el último paso antes de apagarlas para utilizar la imagen maestra preparada en Horizon. También deben utilizarse tras una actualización de la imagen de Windows que incluya la instalación o actualización de aplicaciones, o tras un proceso de actualización de Windows.

OmnissaHorizonOSOptimizationTool.exe -f \[all |0 |1 |2 |3 |4 |5 |6 |7 |8 |9 |10 |11\] \[-reboot | -shutdown\]

Donde:

• all - Ejecuta todas las tareas a continuación.
• 0 - Generador de imágenes nativo (NGEN). Optimiza .NET Framework. Debe ejecutarse después de una actualización de .NET Framework.
• 1 - Limpieza de componentes en paralelo (DISM). Reduce el tamaño de la carpeta WinSxS mediante la desinstalación y la eliminación de paquetes con componentes que han sido reemplazados por otros componentes con versiones más recientes. Debe ejecutarse después de una actualización de Windows.
• 2 - Compacto. Permite a CompactOS comprimir archivos específicos del sistema Windows para liberar espacio. Puede tardar varios minutos en ejecutarse.
• 3 - Limpieza de disco. Elimina los archivos temporales e innecesarios.
• 4 - Borra registros de eventos del sistema.
• 5 - Deshabilita el servicio Superfetch.
• 6 - Borra el perfil de usuario predeterminado.
• 7 - Sobrescribir con ceros espacio de disco vacío (para habilitar esta opción, copie SDelete64.exe en Windows\System32 o en el directorio del usuario actual).
• 8 - Crea directivas de grupo locales (para habilitar esta opción, copie el archivo LGPO.exe en el directorio Windows\System32 o en el directorio del usuario actual).
• 9 - Borra la configuración de KMS.
• 10 - Vacía la caché de DNS.
• 11 - Libera la dirección IP.

Ejemplos

Finalizar ejecutando todas las tareas: OmnissaHorizonOSOptimizationTool.exe -f all

Finalizar ejecutando NGEN para optimizar .NET Framework y DISM para realizar una limpieza de componentes en paralelo: OmnissaHorizonOSOptimizationTool.exe -f 0 1

Combinación de parámetros de línea de comandos

Puede combinar las distintas opciones de optimización y las opciones comunes, junto con los parámetros de generalización o finalización, en un único comando.

Tenga en cuenta que: No es posible combinar una operación de generalización y una operación de finalización en un solo comando, ya que tras una operación de generalización es necesario reiniciar el sistema.

El siguiente ejemplo optimiza (aplicando los elementos seleccionados por defecto) y:

• Deshabilita las notificaciones del sistema.
• Elimina todas las aplicaciones de Microsoft Store excepto la aplicación Fotos.
• Ejecuta la operación de generalización mediante un archivo de respuesta de Sysprep proporcionado.

OmnissaHorizonOSOptimizationTool.exe -o -v -notification disable -windowsupdate enable -storeapp remove-all --exclude photos -g c:\\unattend.xml

El siguiente ejemplo optimiza (aplicando los elementos recomendados) y:

• Deshabilita las notificaciones del sistema.
• Configura los efectos visuales para optimizar el rendimiento.
• Deja habilitada la función Windows Update.
• Elimina todas las aplicaciones de Microsoft Store, excepto las aplicaciones Paint3D y la calculadora.
• Establece el fondo en verde claro.
• Ejecuta todas las tareas de finalización.

OmnissaHorizonOSOptimizationTool.exe -o recommended -v -notification disable -visualeffect performance -windowsupdate enable -storeapp remove-all --exclude paint3d calculator -background #20B2AA -f all