-cc, ClearApplicationCache

Borra la caché de aplicaciones descargada de todas las aplicaciones que sólo están disponibles en línea.

-n, -New fileType [newOptions]

Crea un nuevo archivo del tipo especificado. Los tipos válidos son:

• Deployment: Crea un nuevo manifiesto de implementación.

• Application: Crea un nuevo manifiesto de aplicación.

Si no especifica parámetros adicionales con este comando, se creará un archivo del tipo adecuado con etiquetas y valores de atributo predeterminados adecuados.

Utilice la opción –FromDirectory (ver tabla siguiente) para crear un manifiesto de aplicación con todos los ensamblados de una aplicación agregados a la sección <dependency> del manifiesto.

-u, -Update [filePath] [updateOptions]

Realiza uno o más cambios en un archivo de manifiesto. No es necesario especificar el tipo de archivo que está editando; Mage.exe analizará el archivo utilizando una serie de heurísticas y determinará si se trata de un manifiesto de implementación o de aplicación.

Si ya ha firmado un archivo con un certificado, -Update eliminará el bloque de firma clave. Esto se debe a que la firma clave contiene un hash del archivo, y al modificar el archivo se invalida el hash.

-s, -Sign [signOptions]

Utiliza un certificado para firmar un archivo. Las firmas se insertan como elementos XML dentro de los archivos.

-h, -Help

Describe todos los comandos disponibles y sus opciones.

-v, -Verbose

Ofrece más detalles sobre una operación durante la ejecución.

-appc, -AppCodeBase manifestReference

(Sólo manifiestos de implementación) Inserta una dirección URL o referencia de la ruta de acceso del archivo en el archivo de manifiesto de aplicación. Este archivo debe ser la ruta de acceso completa al manifiesto de aplicación.

-appm, -AppManifest manifestPath

(Sólo manifiestos de implementación) Inserta una referencia al manifiesto de aplicación de una implementación en su manifiesto de implementación.

El archivo indicado por manifestPath debe existir, o Mage.exe emitirá un error. Si el archivo al que se hace referencia mediante manifestPath no es un manifiesto de aplicación, Mage.exe emitirá un error.

-cf, -CertFile filePath

(Todos los tipos de archivo) Especifica la ubicación de un certificado digital para firmar un manifiesto. Esta opción se puede utilizar junto con la opción –Password si el certificado requiere una contraseña.

-ch, -CertHash hashSignature

(Todos los tipos de archivo) El hash de un certificado digital almacenado en el almacén de certificados personales del equipo cliente. Corresponde a la cadena de la huella digital de un certificado digital descrito en la consola de Certificados de Windows.

hashSignature puede ir en mayúsculas o minúsculas y puede proporcionarse como cadena única, o bien, separando cada octeto de la huella digital mediante espacios y entrecomillando toda la huella digital.

-fd, -FromDirectory directoryPath

(Sólo manifiestos de aplicación) Rellena el manifiesto de aplicación con descripciones de todos los ensamblados y archivos que se encuentran en directoryPath, donde directoryPath es el directorio que contiene la aplicación que desea implementar. Para cada archivo en el directorio, Mage.exe decide si el archivo es un ensamblado o un archivo estático. Si es un ensamblado, agrega una etiqueta <dependency> y un atributo installFrom a la aplicación con el nombre del ensamblado, base del código y versión. Si es un archivo estático, agrega una etiqueta <file>. Mage.exe también utiliza un sencillo conjunto heurístico para detectar el principal archivo ejecutable de la aplicación, y lo marcará como punto de entrada de la aplicación ClickOnce en el manifiesto.

Mage.exe nunca marca automáticamente un archivo como archivo de "datos"; debe realizarse manualmente. Para obtener más información, vea Cómo: Incluir un archivo de datos en una aplicación ClickOnce.

Mage.exe también genera un hash para cada archivo basado en su tamaño. ClickOnce utiliza estos hash para garantizar que nadie haya manipulado los archivos de implementación desde que se creó el manifiesto. Si se modifica uno de los archivos de implementación, puede ejecutar Mage.exe con el comando –Update y la opción –FromDirectory para actualizar los hash y las versiones del ensamblado de todos los archivos a los que se hace referencia.

-FromDirectory incluirá todos los archivos en todos los subdirectorios situados dentro de directoryPath.

Si utiliza –FromDirectory con el comando –Update, Mage.exe eliminará los archivos del manifiesto de aplicación que ya no existen en el directorio.

-I, -Install willInstall

(Sólo manifiestos de implementación) Indica si la aplicación ClickOnce debe instalarse en el equipo local o si debe ejecutarse desde el Web. Instalar una aplicación hace presente dicha aplicación en el menú Inicio de Windows. Los valores válidos son "true" o "t", y "false" o "f". Si no se especifica, el valor predeterminado es "true".

Si se especifica la opción –RequiredUpdate, obligará la instalación de la aplicación, sin tener en cuenta el valor que se pasa a -Install.

-mv, -MinVersion [version]

(Sólo manifiestos de implementación) La versión mínima de esta aplicación que un usuario puede ejecutar. Este indicador indica la necesidad de actualizar la versión con nombre de la aplicación; si lanza una versión del producto con un cambio importante o un error crítico de seguridad, puede utilizar este indicador para especificar que se debe instalar esta actualización y que el usuario no puede continuar ejecutando las versiones anteriores.

Si no se especifica ninguna versión, Mage.exe utilizará la versión mostrada en el manifiesto de implementación ClickOnce especificada por el indicador -Version.

version tiene la misma semántica que el argumento del indicador -Version.

-n, -Name nameString

(Todos los tipos de archivo) El nombre utilizado para identificar la aplicación. ClickOnce utilizará este nombre para identificar la aplicación en el menú Inicio (si la aplicación se ha configurado para instalarse automáticamente) y los cuadros de diálogo Permisos y Elevación. Si no se proporciona ningún nombre, el valor predeterminado es "implementar."

-pwd, -Password passwd

(Todos los tipos de archivo) La contraseña utilizada para firmar un manifiesto con un certificado digital. Se debe utilizar conjuntamente con la opción –CertFile.

-p, Processor processorValue

(Sólo manifiestos de implementación y de aplicación) La arquitectura del microprocesador en la que esta distribución se ejecutará. Se requiere este valor si está preparando una o varias instalaciones cuyos ensamblados se han precompilado para un microprocesador concreto. Los valores válidos incluyen msil, x86, ia64 y amd64. El valor predeterminado es msil, o Lenguaje intermedio de Microsoft, lo que significa que todos sus ensamblados dependen de la plataforma y que el Common Language Runtime (CLR) los compilará just-in-time cuando ejecute la aplicación por primera vez.

-pu, -ProviderUrl url

(Sólo manifiestos de implementación) Especifica la dirección URL que ClickOnce examinará para buscar actualizaciones de la aplicación.

-tr, -TrustLevel level

(Sólo manifiestos de aplicación) El nivel de confianza que se concederá a la aplicación en los equipos cliente. Los valores incluyen "Internet", "Intranet" y "FullTrust." Cuando se crea un nuevo manifiesto de aplicación, el valor predeterminado es "Intranet".

-tf, -ToFile filePath

(Todos los tipos de archivo) Especifica la ruta de acceso de salida del archivo que se ha creado o modificado.

Si no se suministra –ToFile cuando se utiliza –New, el resultado se escribe en el directorio de trabajo actual con un nombre predeterminado, y el nombre exacto dependerá del tipo de archivo que ha creado:

• Implementación: deploy.application

• Aplicación: application.exe.manifest

Si no se proporciona –ToFile cuando se utiliza –Update, Mage.exe volverá a escribir el archivo en el archivo de entrada.

-v, -Version versionNumber

(Sólo manifiestos de implementación y de aplicación) La versión de la implementación. El argumento debe ser una cadena de la versión válida con el formato "N.N.N.N", donde "N" es un entero de 32 bits sin signo. El valor predeterminado es "1.0.0.0".

-cf, -CertFile filePath

Especifica la ubicación de un certificado digital para firmar un manifiesto. Esta opción se puede utilizar junto con la opción –Password.

-ch, -CertHash hashSignature

El hash de un certificado digital guardado en el almacén de certificados personales del equipo cliente. Corresponde a la propiedad de la huella digital de un certificado digital descrito en la consola de Certificados de Windows.

hashSignature puede ir en mayúsculas o minúsculas y puede proporcionarse como cadena única, o bien, separando cada octeto de la huella digital mediante espacios y entrecomillando toda la huella digital.

-p, -Password passwd

La contraseña utilizada para firmar un manifiesto con un certificado digital. Se debe utilizar conjuntamente con la opción –CertFile.

-t, -ToFile filePath

Especifica la ruta de acceso de salida del archivo que se ha creado o modificado.