Geração e edição (Mage.exe) ferramenta de manifesto
A ferramenta de edição (Mage.exe) e geração de manifesto é uma ferramenta de linha de comando que oferece suporte a criação e edição de manifestos de aplicativo e implantação. sistema autônomo uma ferramenta de linha de comando, Mage.exe pode ser executado a partir de scripts lote e outros aplicativos baseados no baseado no Windows, incluindo ASP.NET aplicativos.
Você também pode usar MageUI.exe, um aplicativo gráfico, em vez de Mage.exe. Para obter mais informações, consulte Ferramenta editando, gráfica cliente (MageUI.exe) e geração de manifesto.
Mage.exe e MageUI.exe estão disponível em vários locais, incluindo o seguinte:
O .NET estrutura 2.0 SDK. O SDK do .NET estrutura 2.0 está disponível sistema autônomo um componente da instalação do Visual Studio 2005 ou pode ser baixado do centralizar de baixar da Microsoft.
O Windows SDK para Windows Vista. O Windows SDK para Windows Vista pode ser baixado do centralizar de baixar da Microsoft.
Visual Studio 2008. Versões posteriores do Mage.exe e MageUI.exe são incluídas sistema autônomo um componente do Visual Studio 2008 instalação.
Mage [commands] [commandOptions]
Parâmetros
A tabela a seguir mostra os comandos suportados pelo Mage.exe. Para obter mais informações sobre as opções aceitas por esses comandos, consulte Novo e opções de comando atualização and Opções de comando do sinal.
Comando |
Descrição |
|---|---|
-cc, ClearApplicationCache |
Limpa o cache de aplicativo baixado de todos os aplicativos online somente. |
-n, -New tipo_de_arquivo [newOptions] |
Cria um novo arquivo de determinado tipo. Tipos válido são:
Se você não especificar nenhum parâmetro adicional com este comando, ele criará um arquivo do tipo apropriado, com Rótulos de formatação padrão apropriado e valores de atributo. Use the –ToFile option (see in the following table) to specify the file name and path of the new file. Use the –FromDirectory option (see in the following table) to create an application manifest with all of the assemblies for an application added to the <dependency> section of the manifest. |
-u, -Update [filePath] [updateOptions] |
Faz uma ou mais alterações a um arquivo de manifesto. Não é necessário especificar o tipo de arquivo que você está editando. Mage.exe irá examinar o arquivo usando um conjunto de heurística e determine se é um manifesto de implantação ou um manifesto do aplicativo. Se você já tiver entrado um arquivo com um certificado, -Update o <a0></a0> removerá o bloco de assinatura de chave. Isso ocorre porque a assinatura de chave contém um hash do arquivo e modificá-lo processa o hash inválido. Use the –ToFile option (see in the following table) to specify a new file name and path instead of overwriting the existing file. |
-s, -Sign [signOptions] |
Usa um certificado para assinar um arquivo. sistema autônomo assinaturas são inseridas sistema autônomo elementos XML dentro dos arquivos. |
-h, -?, -Help[verbose] |
Descreve todos os comandos disponível e suas opções. Especificar verbose Para obter ajuda detalhada. |
Novo e atualizar as opções de comando
The following table shows the options supported by the –New and –Update commands.
Opções |
Valor padrão |
Aplicável a |
Descrição |
|---|---|---|---|
-appc, -AppCodeBase manifestReference |
Manifestos de implantação. |
Insere uma referência de caminho URL ou arquivo para o arquivo de manifesto do aplicativo. Este arquivo deve ser o caminho completo para o manifesto do aplicativo. |
|
-appm, -AppManifest manifestPath |
Manifestos de implantação. |
Insere uma referência a manifesto do aplicativo de uma implantação em seu manifesto de implantação. O arquivo indicado por manifestPath deve existir ou Mage.exe emitirá um erro. Se o arquivo referenciado por manifestPath não é um aplicativo manifesto, Mage.exe emitirá um erro. |
|
-cf, -CertFile filePath |
Todos os tipos de arquivos. |
Especifica o local de um certificado digital para assinar um manifesto. This option can be used in conjunction with the –Password option, if the certificate requires a password. |
|
-ch, -CertHash hashSignature |
Todos os tipos de arquivos. |
O hash de um certificado digital armazenado no armazenamento de certificados pessoais do computador cliente. Isso corresponde à seqüência de impressão digital de um certificado digital exibido no console certificados do Windows. hashSignature pode ser tanto maiúsculas ou em minúsculas e pode ser fornecido sistema autônomo uma única cadeia de caracteres ou com cada octeto da impressão digital separado por espaços e a impressão digital inteira entre aspas. |
|
-fd, -FromDirectory directoryPath |
Manifestos de aplicativos. |
Preenche o manifesto do aplicativo com descrições de todos os assemblies e arquivos encontrados em directoryPath, onde directoryPath é o diretório que contém o aplicativo que você deseja implantar. Para cada arquivo no diretório, Mage.exe decide se o arquivo é um assembly ou um arquivo estático. Se for um assembly, ele adicionará um <dependency> marca e installFrom o atributo para o aplicativo com versão, base de código e nome do assembly. Se for um arquivo estático, ele adicionará um <file> marca. Mage.exe também usarão um conjunto simples de heurística para detectar o arquivo principal executável do aplicativo e marcará sistema autônomo ponto de entrada do aplicativo ClickOnce no manifesto. Mage.exe nunca automaticamente irá marcar um arquivo sistema autônomo um arquivo de "dados". Você deve fazer isso manualmente. Para obter mais informações, consulte Como: Incluir um arquivo de dados em um aplicativo ClickOnce. Mage.exe também gera um hash para cada arquivo com base em seu dimensionar. ClickOnce usa esses hashes para garantir que ninguém ter adulterado arquivos da implantação desde o manifesto foi criado. If any of the files in your deployment change, you can run Mage.exe with the –Update command and the –FromDirectory option, and it will update the hashes and assembly versions of all referenced files. -FromDirectory incluirá todos os arquivos em todos os subdiretórios encontrados dentro directoryPath. If you use –FromDirectory with the –Update command, Mage.exe will remove any files in the application manifest that no longer exist in the directory. |
|
-i, -Install willInstall |
True |
Manifestos de implantação. |
Indica se o aplicativo ClickOnce deve instalar no computador local ou se ele deve ser executado da Web. Instalar um aplicativo permite que esse aplicativo uma presença no Windows Iniciar menu. Os valores válido são "true" ou "t" e "false" ou "f". If you specify the –MinVersion option, and a user has a version less than -MinVersion installed, it will force the application to install, regardless of the value that you pass to -Install. Essa opção não pode ser usada com o -BrowserHosted opção. Tentar especificar ambos para obter o manifesto mesmo resultará em erro. |
-mv, -MinVersion [version] |
A versão listada no manifesto de implantação ClickOnce, conforme especificado pelo -Version sinalizar. |
Manifestos de implantação. |
Versão mínima do aplicativo que pode ser executado por um usuário. Este sinalizar torna a versão nome do seu aplicativo uma atualização necessária. Se você soltar uma versão do seu produto com uma atualização para uma alterar significativa ou uma falha crítica de segurança, você pode usar esse sinalizar para especificar que essa atualização deve ser instalada e que o usuário não pode continuar a execução de versões anteriores. version tem a mesma semântica sistema autônomo argumento para o -Version sinalizar. |
-n, -Name nameString |
implantar |
Todos os tipos de arquivos. |
O nome que é usado para identificar o aplicativo. ClickOnce utilizarão esse nome para identificar o aplicativo no Iniciar menu (se o aplicativo está configurado para se instalar) e nas caixas de diálogo de elevação de permissões. |
-pwd, -Password passwd |
Todos os tipos de arquivos. |
A senha usada para assinar um manifesto com um certificado digital. Must be used in conjunction with the –CertFile option. |
|
-p, Processor processorValue |
MSIL |
Manifestos de aplicativos. Manifestos de implantação. |
A arquitetura de microprocessador em que essa distribuição será executado. Esse valor é necessário se você estiver preparando um ou mais instalações cujos assemblies tiverem sido pré-compilados para um microprocessador específico. Os valores válido incluem MSIL, x86, IA64, and AMD64. MSIL é Microsoft linguagem intermediária, que significa que todos os seus assemblies são independentes de plataforma e o common language tempo de execução (CLR) será just-in-time compilá-los quando seu aplicativo é executado pela primeira vez. |
-pu, -ProviderUrl url |
Manifestos de implantação. |
Especifica a URL que ClickOnce irá examinar as atualizações do aplicativo. |
|
-pub, -Publisher publisherName |
Manifestos de aplicativos. Manifestos de implantação. Novo no .NET estrutura 3.5. |
Adiciona o nome do publicador para o elemento de descrição de manifesto de implantação ou aplicativo. Quando usado em um manifesto do aplicativo, -UseManifestForTrusttambém deve ser especificado com um valor de "true" ou "t"; caso contrário, esse parâmetro irá gerar um erro. |
|
-ti, -TimestampUri uri |
Manifestos de aplicativos. Manifestos de implantação. |
A URL de um serviço de carimbo de data/hora digital. Timestamping os manifestos impede que você precise assinar novamente os manifestos deve seu certificado digital expirar antes de implantar a próxima versão do seu aplicativo. Atualmente, apenas VeriSign ofereça suporte ao serviço de carimbo de data/hora. O URI fornecido sistema autônomo o argumento deve ser "http://carimbo de data/hora.verisign.com/scripts/timstamp.dll". |
|
-tr, -TrustLevel level |
Intranet |
Manifestos de aplicativos. |
O nível de confiança para conceder ao aplicativo nos computadores clientes. Os valores incluem "Internet", "Intranet" e "FullTrust". |
-t, -ToFile filePath |
|
Todos os tipos de arquivos. |
Especifica o caminho de saída do arquivo que foi criado ou modificado. If –ToFile is not supplied when you use –New, the output is written to the current working directory. If –ToFile is not supplied when you use –Update, Mage.exe will write the file back to the input file. |
-u, -UseManifestForTrust willUseForTrust |
False |
Manifestos de aplicativos. Novo no .NET estrutura 3.5. |
Especifica se a assinatura digital do manifesto do aplicativo será usada para tomar decisões de confiança quando o aplicativo é executado no cliente. Especificando "true" ou "t" indica que o manifesto do aplicativo será usado para decisões de confiança. Especificar "false" ou "f" indica que a assinatura de manifesto de implantação será usada. |
-v, -Version versionNumber |
1.0.0.0 |
Manifestos de aplicativos. Manifestos de implantação. |
A versão da implantação. O argumento deve ser um válido seqüência de caracteres de versão do formato "N.N.N.N", onde"N "é um inteiro de 32 bit sem sinal. |
-wpf, -WPFBrowserApp isWPFApp |
False |
Manifestos de aplicativos. Manifestos de implantação. Novo no .NET estrutura 3.5. |
Use este sinalizar somente se o aplicativo é um aplicativo Windows Presentation Foundation (WPF) que será hospedado dentro do Internet Explorer e não é um executável autônomo. Os valores válido são "true" ou "t" e "false" ou "f". Manifestos de aplicativo, é inserido o hostInBrowser atributo sob a entryPoint elemento de manifesto do aplicativo. Para os manifestos de implantação, define o install atributo na deployment elemento para falso e economiza manifesto da implantação com uma extensão .xbap. A especificação desse argumento junto com o -Install argumento produz um erro, porque um aplicativo hospedado por navegador não pode ser um aplicativo instalado, off-line. |
Opções de comando do sinal
The following table shows the options supported by the –Sign command, which apply to all types of files.
Opções |
Descrição |
|---|---|
-cf, -CertFile filePath |
Especifica o local de um certificado digital para assinar um manifesto. This option can be used in conjunction with the –Password option. |
-ch, -CertHash hashSignature |
O hash de um certificado digital armazenado no armazenamento de certificados pessoais do computador cliente. Isso corresponde à propriedade de impressão digital de um certificado digital exibido no console certificados do Windows. hashSignature pode ser tanto maiúsculas ou em minúsculas e pode ser fornecido sistema autônomo uma única cadeia de caracteres ou com cada octeto da impressão digital separado por espaços e a impressão digital inteira entre aspas. |
-p, -Password passwd |
A senha usada para assinar um manifesto com um certificado digital. Must be used in conjunction with the –CertFile option. |
-t, -ToFile filePath |
Especifica o caminho de saída do arquivo que foi criado ou modificado. |
Comentários
Todos os argumentos para Mage.exe fazem distinção entre maiúsculas e minúsculas. Comandos e opções podem ser prefixadas com um traço (-) ou uma barra / / (/).
All of the arguments used with the –Sign command can be used at any time with the –New or –Update commands as well. Os seguintes comandos são equivalentes.
mage –Sign c:\HelloWorldDeployment\HelloWorld.deploy –CertFile cert.pfx
mage –Update c:\HelloWorldDeployment\HelloWorld.deploy –CertFile cert.pfx
Assinatura é a última tarefa que você deve executar como um documento assinado usa um hash do arquivo para verificar se a assinatura é válida para o documento. Se você fizer alterações em um arquivo assinado, você deve entrá-lo novamente. Se você assinar um documento que anteriormente foi assinado, Mage.exe substituirá a antiga assinatura com o novo.
When you use the –AppManifest option to populate a deployment manifest, Mage.exe will assume that your application manifest will reside in the same directory as the deployment manifest within a subdirectory named after the current deployment version, and will configure your deployment manifest appropriately. If your application manifest will reside elsewhere, use the –AppCodeBase option to set the alternate location.
Manifesto de implantação e o aplicativo deve ser assinado antes de implantar seu aplicativo. Para obter orientação sobre como assinar os manifestos, consulte Visão geral sobre implantação de Aplicativo Confiável.
The –TrustLevel option for application manifests describes the permission set an application requires to run on the client computer. Por padrão, aplicativos recebem um nível de confiança com base na zona no qual reside o URL. Aplicativos implantados em uma rede corporativa geralmente são colocados na zona da intranet, enquanto aqueles implantados através da Internet são colocados na zona da Internet. As duas zonas de segurança colocam restrições no acesso do aplicativo aos recursos locais, com um pouco mais permissivo que a zona Internet de zona da intranet. A zona FullTrust oferece aplicativos completo acesso a recursos locais do computador. If you use the –TrustLevel option to place an application in this zone, the Trust Manager component of the CLR will prompt the user to decide whether he or she wants to grant this higher level of trust. Se você estiver implantando seu aplicativo em uma rede corporativa, você pode usar a implantação de aplicativos confiáveis para elevar o nível de confiança do aplicativo sem avisar o usuário.
Manifestos de aplicativo também oferece suporte a seções de confiança personalizado. Isso ajuda a seu aplicativo obedecer o princípio de segurança de solicitar permissão menor, sistema autônomo você pode configurar o manifesto de exigem somente sistema autônomo permissões específicas necessárias para executar o aplicativo. Mage.exe não suporta diretamente a adição de uma seção de confiança personalizado. Você pode adicionar uma usando um editor de texto, um analisador XML ou a ferramenta gráfica MageGUI.exe. For more information about how to use MageGUI.exe to add custom trust sections, see Ferramenta editando, gráfica cliente (MageUI.exe) e geração de manifesto.
Exemplos
O exemplo a seguir abre a interface do usuário para Mage (MageUI.Exe).
mage
Os exemplos a seguir criar um manifesto de implantação padrão e o manifesto do aplicativo. Esses arquivos todas são criados no diretório de trabalho corrente e são chamados implantar.aplicativo e aplicativo.exe.manifesto, respectivamente.
mage –New Deployment
mage –New Application
mage –New TrustLicense
O exemplo a seguir cria um manifesto do aplicativo preenchido com todos os assemblies e arquivos de recurso do Diretório de aplicativo HelloWorld.
mage –New Application –FromDirectory \bin -Version 1.0.0.0
O exemplo a seguir continua do exemplo anterior, especificando o microprocessador nome e o destino de implantação. Ela também especifica uma URL que ClickOnce deve verificar as atualizações.
mage –New Application –FromDirectory \bin -Name "Hello, World! Application" –Version 1.0.0.0 –Processor "x86" –ProviderUrl http://internalserver/HelloWorld/
O exemplo a seguir demonstra como criar um emparelhar de manifestos de implantação de um aplicativo do WPF será hospedado no Internet Explorer.
mage –New Application –FromDirectory \bin -Version 1.0.0.0 -WPFBrowserApp true
mage -New Deployment -AppManifest 1.0.0.0\application.manifest -WPFBrowserApp true
O exemplo a seguir atualiza um manifesto de implantação com informações de um manifesto de aplicativo e define o código de base para o local do manifesto do aplicativo.
mage –Update HelloWorld.deploy –AppManifest 1.0.0.0\application.manifest –AppCodeBase http://internalserver/HelloWorld.deploy
O exemplo a seguir edita o manifesto de implantação para forçar uma atualização da versão instalada do usuário.
mage –Update c:\HelloWorldDeployment\HelloWorld.deploy –MinVersion 1.1.0.0
O exemplo a seguir informa o manifesto de implantação para recuperar o manifesto do aplicativo de outro diretório.
mage –Update HelloWorld.deploy –AppCodeBase http://anotherserver/HelloWorld/1.1.0.0/
O exemplo a seguir assina um manifesto de implantação existente usando um certificado digital no diretório de trabalho corrente.
mage –Sign deploy.application –CertFile cert.pfx –Password <passwd>
Consulte também
Tarefas
Demonstra Passo a passo: Implantando manualmente um aplicativo ClickOnce
Conceitos
Visão geral sobre implantação de Aplicativo Confiável
Referência
Ferramenta editando, gráfica cliente (MageUI.exe) e geração de manifesto