Mage.exe (Narzędzie generowania manifestu i edytowania)

Narzędzie Narzędzie tworzenia i edycji manifestów (Mage.exe) to narzędzie wiersza polecenia, które obsługuje tworzenie i edytowanie manifestów aplikacji i wdrożenia. Narzędzie wiersza polecenia umożliwia uruchamianieMage.exeskryptów wsadowych i innych Windows opartych na aplikacjach, w tym ASP.NET aplikacji.

Można również użyć MageUI.exe, aplikacji graficznej, zamiast Mage.exe. Aby uzyskać więcej informacji, zobaczMageUI.exe (Narzędzie tworzenia i edycji manifestów, Graphical Client).

To narzędzie jest instalowane automatycznie z programem Visual Studio. Aby uruchomić narzędzie, użyj programu Visual Studio wiersz polecenia dla deweloperów lub Visual Studio Developer PowerShell.

Dwie wersje Mage.exe iMageUI.exe są dołączone do Visual Studio. Aby wyświetlić informacje o wersji, uruchom MageUI.exe, wybierz pozycję Pomoc i wybierz pozycję Informacje. W tej dokumentacji opisano wersję 4.0.x.x Mage.exei MageUI.exe.

Składnia

Mage [commands] [commandOptions]

Parametry

W poniższej tabeli przedstawiono polecenia obsługiwane przez program Mage.exe. Aby uzyskać więcej informacji na temat opcji obsługiwanych przez te polecenia, zobacz New and Update command options (Nowe i aktualizuj opcje poleceń) oraz Sign command options (Opcje polecenia podpisywania).

Polecenie Opis
-cc, ClearApplicationCache Czyści pamięć podręczną pobranych aplikacji ze wszystkich aplikacji działających tylko w trybie online.
-n, -NewfileType [newOptions] Tworzy nowy plik danego typu. Prawidłowymi typami są:

- Deployment: tworzy nowy manifest wdrożenia.
- Application: tworzy nowy manifest aplikacji.

Jeśli nie określono żadnych dodatkowych parametrów dla tego polecenia, zostanie utworzony plik odpowiedniego typu, z odpowiednimi domyślnymi tagami oraz wartościami atrybutów.

Użyj opcji -ToFile (zobacz w poniższej tabeli), aby określić nazwę i ścieżkę nowego pliku.

Użyj opcji -FromDirectory (zobacz w poniższej tabeli), aby utworzyć manifest > aplikacji ze wszystkimi zestawami dla aplikacji dodanymi do sekcji zależności manifestu.
-u, -Update[filePath] [updateOptions] Wprowadza co najmniej jedną zmianę w pliku manifestu. Nie trzeba określać typu edytowanego pliku. Program Mage.exe zbada plik za pomocą zestawu algorytmów heurystycznych i ustali, czy jest to manifest wdrożenia, czy aplikacji.

Jeśli plik został już podpisany za pomocą certyfikatu, - Update usunie blok podpisu klucza. Dzieje się tak dlatego, że podpis klucza zawiera skrót pliku i modyfikacja pliku spowoduje, że skrót będzie nieprawidłowy.

Użyj opcji -ToFile (zobacz w poniższej tabeli), aby określić nową nazwę pliku i ścieżkę, zamiast nadpisać istniejący plik.
-s, -Sign Używa pary kluczy lub certyfikatu X509 w celu podpisania pliku. Podpisy są wstawiane jako elementy XML wewnątrz plików.

Podczas podpisywania manifestu, który określa wartość -TimestampUri , musisz mieć połączenie z Internetem.
-ver, -Verify[manifest-filename] Sprawdza, czy manifest jest poprawnie podpisany. Nie można łączyć z innymi poleceniami.

Dostępne w .NET Framework 4.7 i nowszych.
-h, -?, -Help[verbose] Opisuje wszystkie z dostępnych poleceń i ich opcji. Określ, verbose aby uzyskać szczegółową pomoc.

Opcje poleceń Nowy i Aktualizuj

W poniższej tabeli przedstawiono opcje obsługiwane przez polecenia -New i -Update :

Opcje Wartość domyślna Dotyczy: Opis
-a, -Algorithm sha1RSA Manifesty aplikacji.

Manifesty wdrożenia.
Określa algorytm, za pomocą którego zostaną wygenerowane skróty zależności. Wartością musi być „sha256RSA” lub „sha1RSA”.

Należy używać z opcją „-Update”. Ta opcja jest ignorowana, gdy używana jest opcja „-Sign”.
-appc, -AppCodeBase Manifesty wdrożenia. Wstawia odwołanie do adresu URL lub ścieżki pliku do pliku manifestu aplikacji. Ta wartość musi być pełną ścieżką do manifestu aplikacji.
-appm, -AppManifest Manifesty wdrożenia. Wstawia do manifestu wdrożenia odwołanie do manifestu wdrażanej aplikacji.

Plik wskazany przez element manifestPath musi istnieć lub manifestPath spowoduje błąd. Jeśli plik, do których odwołuje się element , manifestPath nie jest manifestem aplikacji, manifestPath spowoduje błąd.
-cf, -CertFile Wszystkie typy plików. Określa lokalizację certyfikatu cyfrowego X509 do podpisywania pliku manifestu lub licencji. Tej opcji można używać w połączeniu z opcją -Password, jeśli certyfikat wymaga hasła dla plików z informacjami osobistymi Exchange (PFX). Począwszy od .NET Framework 4.7, jeśli plik nie zawiera klucza prywatnego, wymagana jest kombinacja opcji -CryptoProvider i -KeyContainer.

Począwszy od .NET Framework 4.6.2 ,Mage.exe podpisuje manifesty przy użyciu CNG, a także certyfikatów CAPI.
-ch, -CertHash Wszystkie typy plików. Skrót certyfikatu cyfrowego przechowywanego w osobistym magazynie certyfikatów na komputerze klienta. Odpowiada on ciągowi odcisku palca certyfikatu cyfrowego wyświetlanego w konsoli certyfikatów systemu Windows.

hashSignature Mogą być wielkie lub małe i mogą być podane jako pojedynczy ciąg lub z każdym oktetem odcisku palca oddzielonym spacjami i całym odciskiem palca ujętym w znaki cudzysłowu.
-csp, -CryptoProvider Wszystkie typy plików. Określa nazwę dostawcy usług kryptograficznych (CSP), który zawiera kontener kluczy prywatnych. Ta opcja wymaga opcji -KeyContainer .

Ta opcja jest dostępna od wersji .NET Framework 4.7.
-fd, -FromDirectory Manifesty aplikacji. Wypełnia manifest aplikacji directoryPathopisami wszystkich zestawów i plików znalezionych w pliku , w tym wszystkich podkatalogów, directoryPath gdzie to katalog zawierający aplikację, którą chcesz wdrożyć. Dla każdego pliku w kataloguMage.exe, czy plik jest zestawem, czy plikiem statycznym. Jeśli jest to zestaw, dodaje tag installFrom i <dependency> atrybut do aplikacji z nazwą zestawu, bazą kodu i wersją. Jeśli jest to plik statyczny, dodaje <file> tag. Mage.exe również użyć prostego zestawu heurystycznych do wykrywania głównego pliku wykonywalnego dla aplikacji i oznaczy go jako punkt wejścia aplikacji ClickOnce w manifeście.

Mage.exe nigdy nie oznaczy automatycznie pliku jako pliku "danych". Tę czynność należy wykonać ręcznie. Aby uzyskać więcej informacji, zobacz How to: Include a Data File in a ClickOnce Application (Jak uwzględnić plik danych w ClickOnce aplikacji).

Mage.exe generuje również skrót dla każdego pliku na podstawie jego rozmiaru. Technologia ClickOnce używa tych skrótów, aby zagwarantować, że nikt nie ingerował w pliki wdrożenia od czasu utworzenia manifestu. Jeśli którykolwiek z plików we wdrożeniu zmieni się, możesz uruchomić programMage.exeza pomocą polecenia -Update i opcji -FromDirectory. Spowoduje to zaktualizowanie skrótów i wersji zestawu wszystkich plików, do których się odwołujesz.

-FromDirectory będzie zawierać wszystkie pliki we wszystkich podkatalogach znalezionych w .

Jeśli używasz -FromDirectory z -Update polecenia,Mage.exe usunie wszystkie pliki w manifeście aplikacji, które już nie istnieją w katalogu.
-if, -IconFile Manifesty aplikacji. Określa pełną ścieżkę do pliku ikony ICO. Ta ikona pojawia się obok nazwy aplikacji w menu Start oraz we wpisie w aplecie Dodaj lub usuń programy. Jeśli nie zostanie dostarczona ikona, będzie używana ikona domyślna.
-ip, -IncludeProviderURL true Manifesty wdrożenia. Wskazuje, czy manifest wdrożenia zawiera wartość lokalizacji aktualizacji ustawioną przez -ProviderURL.
-i, -Install true Manifesty wdrożenia. Wskazuje, czy aplikacja ClickOnce ma zostać zainstalowana na komputerze lokalnym, czy ma być uruchamiana z sieci Web. Zainstalowanie aplikacji zapewnia tej aplikacji obecność w Windows Start. Prawidłowymi wartościami są „true” lub „t” oraz „false” lub „f”.

Jeśli określisz opcję -MinVersion , a użytkownik ma zainstalowaną wersję mniejszą niż -MinVersion , wymusi to zainstalowanie aplikacji, niezależnie od wartości, która zostanie przekazać do opcji -Install.

Tej opcji nie można używać z opcją -BrowserHosted . Próba określenia obu tych opcji dla jednego manifestu spowoduje błąd.
-kc, -KeyContainer Wszystkie typy plików. Określa kontener kluczy, który zawiera nazwę klucza prywatnego. Ta opcja wymaga opcji CryptoProvider .

Ta opcja jest dostępna od wersji .NET Framework 4.7.
-mv, -MinVersion Wersja wymieniona w manifeście ClickOnce wdrażania określona przez flagę -Version. Manifesty wdrożenia. Minimalna wersja aplikacji, jaką może uruchomić użytkownik. Ta flaga powoduje, że nazwana wersja aplikacji staje się wymaganą aktualizacją. Jeśli zostanie wydana wersja produktu z aktualizacją dotyczącą ważnej zmiany lub krytycznej wady zabezpieczeń, można użyć tej flagi, aby określić, że ta aktualizacja musi zostać zainstalowana, a użytkownik nie może kontynuować używania wcześniejszych wersji.

version ma tę samą semantykę co argument version .
-n, -Name Wdróż Wszystkie typy plików. Nazwa, która jest używana do identyfikacji aplikacji. ClickOnce będzie używać tej nazwy do identyfikowania aplikacji w menu Start (jeśli aplikacja jest skonfigurowana do samej instalacji) i w oknach dialogowych Podniesienie uprawnień. Uwaga: Jeśli aktualizujesz istniejący manifest i nie określisz nazwy wydawcy za pomocą tej opcji, program Mage.exeaktualizuje manifest przy użyciu nazwy organizacji zdefiniowanej na komputerze. Aby użyć innej nazwy, należy użyć tej opcji i określić odpowiednią nazwę wydawcy.
-pwd, -Password Wszystkie typy plików. Hasło używane do podpisywania manifestu za pomocą certyfikatu cyfrowego. Musi być używany w połączeniu z -CertFile opcji.
-p, procesor Msil Manifesty aplikacji.

Manifesty wdrożenia.
Architektura mikroprocesora, na której będzie uruchomiona dystrybucja. Ta wartość jest wymagana, jeśli jest przygotowywanych kilka instalacji, których zestawy są wstępnie kompilowane dla określonego mikroprocesora. Prawidłowe wartości to msil, x86, ia64i amd64. msil to język pośredni firmy Microsoft, co oznacza, że wszystkie zestawy są niezależne od platformy, a środowisko uruchomieniowe języka wspólnego (CLR) skompiluje je dokładnie na czas podczas pierwszego uruchomienia aplikacji.
-pu,-ProviderURL Manifesty wdrożenia. Określa adres URL, pod którym technologia ClickOnce będzie szukać aktualizacji aplikacji.
-pub, -Publisher Manifesty aplikacji.

Manifesty wdrożenia.
Dodaje nazwę wydawcy do opisu elementu manifestu wdrożenia lub aplikacji. W przypadku użycia w manifeście aplikacji należy również określić wartość -UseManifestForTrust z wartością "true" lub "t"; W przeciwnym razie ten parametr zwniesie błąd.
-s, -SupportURL Manifesty aplikacji.

Manifesty wdrożenia.
Określa łącze, które pojawia się w aplecie Dodaj lub usuń programy dla aplikacji ClickOnce.
-ti, -TimestampUri Manifesty aplikacji.

Manifesty wdrożenia.
Adres URL usługi cyfrowego oznaczania znacznikami czasu. Oznaczenie manifestu znacznikiem czasu zapobiega konieczności ponownego podpisania manifestu, jeśli certyfikat cyfrowy wygaśnie przed wdrożeniem następnej wersji aplikacji. Aby uzyskać więcej informacji, zobacz Windows członków programu certyfikatów głównych.
-t, -ToFile - Nowe:
— Wdrożenie: deploy.application
- Aplikacja: application.exe.manifest
— Aktualizacja:
— plik wejściowy.
Wszystkie typy plików. Określa ścieżkę wyjściową utworzonego lub zmodyfikowanego pliku.

Jeśli -ToFile nie zostanie podany podczas korzystania z -New, dane wyjściowe są zapisywane w bieżącym katalogu roboczego. Jeśli -ToFile nie zostanie podany podczas korzystania z -Update, Mage.exe zapisze plik z powrotem do pliku wejściowego.
-tr, -TrustLevel Wartość określana na podstawie strefy, w której znajduje się adres URL aplikacji. Manifesty aplikacji. Poziom zaufania, który zostanie przyznany aplikacji na komputerach klientów. Dostępne wartości to Internet, Intranet i FullTrust.
-um, -UseManifestForTrust Fałsz Manifesty aplikacji. Określa, czy podpis cyfrowy manifestu aplikacji będzie używany do podejmowania decyzji dotyczących zaufania, gdy aplikacja zostanie uruchomiona na komputerze klienckim. Określenie wartości „true” lub „t” wskazuje, że manifest aplikacji zostanie użyty do podejmowania decyzji dotyczących zaufania. Określenie wartości „false” lub „f” wskazuje, że zostanie użyty podpis manifestu wdrożenia.
-v, -Version 1.0.0.0 Manifesty aplikacji.

Manifesty wdrożenia.
Wersja wdrożenia. Argument musi być prawidłowym ciągiem wersji w formacie "N.N.N.N", gdzie "N" jest niepodpisaną 32-bitową liczbą całkowitą.
-wpf, -WPFBrowserApp fałsz Manifesty aplikacji.

Manifesty wdrożenia.
Tej flagi należy używać tyko wtedy, gdy aplikacja jest aplikacją programu Windows Presentation Foundation (WPF), która będzie obsługiwana wewnątrz programu Internet Explorer i nie jest autonomicznym plikiem wykonywalnym. Prawidłowymi wartościami są „true” lub „t” oraz „false” lub „f”.

W przypadku manifestów aplikacji atrybut jest wstawiany hostInBrowser w entryPoint elemencie manifestu aplikacji.

W przypadku manifestów wdrażania atrybut install elementu deployment jest ustawiany na wartość false, a manifest wdrożenia jest zapisywany z rozszerzeniem xbap. Określenie tego argumentu wraz z argumentem -Install powoduje błąd, ponieważ aplikacja hostowana w przeglądarce nie może być aplikacją zainstalowaną w trybie offline.

Opcje polecenia podpisywania

W poniższej tabeli przedstawiono opcje obsługiwane przez polecenie -Sign , które mają zastosowanie do wszystkich typów plików.

Opcje Opis
-cf, -CertFile Określa lokalizację certyfikatu cyfrowego używanego do podpisania manifestu. Tej opcji można używać w połączeniu z opcją -Password, jeśli certyfikat wymaga hasła dla plików pfx (personal information Exchange). Począwszy od .NET Framework 4.7, jeśli plik nie zawiera klucza prywatnego, wymagana jest kombinacja opcji -CryptoProvider i -KeyContainer.

Począwszy od .NET Framework 4.6.2 ,Mage.exe podpisuje manifesty przy użyciu CNG, a także certyfikatów CAPI.
-ch, -CertHash Skrót certyfikatu cyfrowego przechowywanego w osobistym magazynie certyfikatów na komputerze klienta. Odpowiada właściwości odcisku palca certyfikatu cyfrowego wyświetlanego na konsoli certyfikatów systemu Windows.

hashSignature Mogą być wielkie lub małe i mogą być podane jako pojedynczy ciąg lub z każdym oktetem odcisku palca oddzielonym spacjami i całym odciskiem palca ujętym w znaki cudzysłowu.
-csp, -CryptoProvider Określa nazwę dostawcy usług kryptograficznych (CSP), który zawiera kontener kluczy prywatnych. Ta opcja wymaga opcji -KeyContainer .

Ta opcja jest dostępna od wersji .NET Framework 4.7.
-kc, -KeyContainer Określa kontener kluczy, który zawiera nazwę klucza prywatnego. Ta opcja wymaga opcji CryptoProvider .

Ta opcja jest dostępna od wersji .NET Framework 4.7.
-pwd, -Password Hasło używane do podpisywania manifestu za pomocą certyfikatu cyfrowego. Musi być używany w połączeniu z -CertFile opcji.
-t, -ToFile Określa ścieżkę wyjściową utworzonego lub zmodyfikowanego pliku.

Uwagi

Wszystkie argumenty Mage.exe są bez uwzględniania liter. Polecenia i opcje mogą być poprzedzone kreską (-) lub ukośnikiem (/).

Wszystkie argumenty używane z -Sign polecenia mogą być używane w dowolnym momencie z -New lub -Update polecenia. Poniższe polecenia są równoważne.

mage -Sign c:\HelloWorldDeployment\HelloWorld.deploy -CertFile cert.pfx
mage -Update c:\HelloWorldDeployment\HelloWorld.deploy -CertFile cert.pfx

Uwaga

Począwszy od .NET Framework wersji 4.6.2, certyfikaty CNG są również obsługiwane.

Podpisywanie jest ostatnim zadaniem, które należy wykonać, ponieważ podpisany dokument używa skrótu pliku w celu weryfikacji, czy podpis jest prawidłowy dla dokumentu. W przypadku wprowadzenia jakiejkolwiek zmiany w podpisanym pliku należy podpisać go ponownie. Jeśli podpiszesz wcześniej podpisany dokument,Mage.exe zastąpi stary podpis nowym.

W przypadku użycia opcji -AppManifest w celu wypełnienia manifestu wdrożenia program Mage.exe zakłada, że manifest aplikacji będzie znajdować się w tym samym katalogu co manifest wdrożenia w podkatalogu o nazwie od bieżącej wersji wdrożenia i odpowiednio skonfiguruje manifest wdrożenia. Jeśli manifest aplikacji będzie znajdować się w innym miejscu, użyj opcji -AppCodeBase , aby ustawić lokalizację alternatywną.

Manifesty wdrożenia i aplikacji muszą zostać podpisane przed wdrożeniem aplikacji. Aby uzyskać wskazówki dotyczące podpisywania manifestów, zobacz Omówienie wdrażania zaufanych aplikacji.

Opcja -TrustLevel manifestów aplikacji opisuje zestaw uprawnień wymagany przez aplikację do uruchomienia na komputerze klienckim. Domyślnie aplikacjom jest przypisywany poziom zaufania na podstawie strefy, w której znajduje się ich adres URL. Aplikacje wdrożone przez sieć firmową są zazwyczaj umieszczane w strefie Intranet, podczas gdy te wdrożone przez Internet umieszczane są w strefie Internet. Obie strefy zabezpieczeń nakładają na aplikację ograniczenia w zakresie dostępu do lokalnych zasobów, przy czym strefa Intranet ma nieco łagodniejsze ograniczenia niż strefa Internet. Strefa FullTrust udziela aplikacji pełnego dostępu do lokalnych zasobów komputera. Jeśli używasz opcji -TrustLevel , aby umieścić aplikację w tej strefie, składnik Menedżera zaufania clr wyświetli użytkownikowi monit o podjęcie decyzji, czy chce udzielić wyższego poziomu zaufania. Jeśli aplikacja jest wdrażana przez sieć firmową, można użyć narzędzia Wdrażanie zaufanych aplikacji, aby podnieść poziom zaufania aplikacji bez monitowania użytkownika.

Manifesty aplikacji obsługują także niestandardowe sekcje zaufania. Pomaga to aplikacji przestrzegać reguły zabezpieczeń, zgodnie z którą należy żądać jak najniższych uprawnień, ponieważ można skonfigurować manifest do żądania tylko tych określonych uprawnień, których aplikacja wymaga do działania. Mage.exe nie obsługuje bezpośredniego dodawania niestandardowej sekcji zaufania. Można go dodać za pomocą edytora tekstu, parsera XML lub narzędzia graficznego MageUI.exe. Aby uzyskać więcej informacji na temat używania usługi MageUI.exe do dodawania niestandardowych sekcji zaufania, zobacz MageUI.exe (Narzędzie tworzenia i edycji manifestów, Graphical Client).

Visual Studio 2017 zawiera wersję 4.6.1 Mage.exe. Manifesty utworzone za pomocą tej wersjiMage.exe docelowego .NET Framework 4. Aby korzystać ze starszych wersji .NET Framework, użyj starszej wersji programu Mage.exe.

W przypadku dodawania lub usuwania zestawów z istniejącego manifestu lub ponownego podpisywania istniejącego manifestu program Mage.exe aktualizować manifestu do docelowego .NET Framework 4.

W poniższych tabelach przedstawiono następujące funkcje i ograniczenia:

Wersja manifestu Operacja Mage w wersji 2.0 Mage w wersji 4.0
Manifest dla aplikacji, których platforma docelowa to wersja 2.0 lub 3.x programu .NET Framework Otwórz OK OK
Zamknij OK OK
Zapisz OK OK
Ponowne podpisane OK OK
Nowy OK Nieobsługiwane
Aktualizacja (zobacz poniżej) OK OK
Manifest dla aplikacji, których platforma docelowa to wersja 4 programu .NET Framework Otwórz OK OK
Zamknij OK OK
Zapisz OK OK
Ponowne podpisane OK OK
Nowy Nieobsługiwane OK
Aktualizacja (zobacz poniżej) Nieobsługiwane OK
Wersja manifestu Szczegóły operacji aktualizacji Mage w wersji 2.0 Mage w wersji 4.0
Manifest dla aplikacji, których platforma docelowa to wersja 2.0 lub 3.x programu .NET Framework Modyfikacja zestawu OK OK
Dodanie zestawu OK OK
Usunięcie zestawu OK OK
Manifest dla aplikacji, których platforma docelowa to wersja 4 programu .NET Framework Modyfikacja zestawu Nieobsługiwane OK
Dodanie zestawu Nieobsługiwane OK
Usunięcie zestawu Nieobsługiwane OK

Mage.exe tworzy nowe manifesty, które są .NET Framework profilu klienta programu .NET Framework 4. ClickOnce, które są celem profilu klienta programu .NET Framework 4, można uruchamiać zarówno w profilu klienta programu .NET Framework 4, jak i w pełnej wersji .NET Framework 4. Jeśli aplikacja jest przeznaczony dla pełnej wersji programu .NET Framework 4 i nie można jej uruchomić w profilu klienta programu .NET Framework 4, <framework> usuń element klienta przy użyciu edytora tekstów i ponownie podpisz manifest.

Poniżej przedstawiono przykładowy element przeznaczony <framework> dla profilu .NET Framework 4:

<framework targetVersion="4.0" profile="client" supportedRuntime="4.0.20506" />

Przykłady

Poniższy przykład otwiera interfejs użytkownika dla Mage (MageUI.exe).

mage

W poniższym przykładzie są tworzone domyślne manifesty wdrożenia i aplikacji. Wszystkie te pliki są tworzone w bieżącym katalogu roboczym i są nazwane odpowiednio deploy.application i application.exe.manifest.

mage -New Deployment
mage -New Application

Poniższy przykład tworzy manifest aplikacji wypełniony wszystkimi zestawami i plikami zasobów z bieżącego katalogu.

mage -New Application -FromDirectory . -Version 1.0.0.0

W poniższym przykładzie jest kontynuowany poprzedni przykład i jest określana nazwa wdrożenia oraz docelowy mikroprocesor. Określany jest także adres URL, pod którym technologia ClickOnce będzie sprawdzać dostępność aktualizacji.

mage -New Application -FromDirectory . -Name "Hello, World! Application" -Version 1.0.0.0 -Processor "x86" -ProviderUrl http://internalserver/HelloWorld/

W poniższym przykładzie pokazano sposób tworzenia pary manifestów dla wdrożenia aplikacji programu WPF, która będzie obsługiwana w programie Internet Explorer.

mage -New Application -FromDirectory . -Version 1.0.0.0 -WPFBrowserApp true
mage -New Deployment -AppManifest 1.0.0.0\application.manifest -WPFBrowserApp true

Poniższy przykład tworzy manifest aplikacji wypełniony wszystkimi zestawami i plikami zasobów z bieżącego katalogu oraz podpisami.

mage -New Application -FromDirectory . -Version 1.0.0.0 -KeyContainer keypair.snk -CryptoProvider "Microsoft Enhanced Cryptographic Provider v1.0"

W poniższym przykładzie manifest wdrożenia jest aktualizowany informacjami z manifestu aplikacji, a także jest ustawiana podstawa kodu dla lokalizacji manifestu aplikacji.

mage -Update HelloWorld.deploy -AppManifest 1.0.0.0\application.manifest -AppCodeBase http://internalserver/HelloWorld.deploy

W poniższym przykładzie manifest wdrożenia jest edytowany w celu wymuszenia aktualizacji zainstalowanej wersji użytkownika.

mage -Update c:\HelloWorldDeployment\HelloWorld.deploy -MinVersion 1.1.0.0

W poniższym przykładzie manifest wdrożenia otrzymuje instrukcję pobrania manifestu aplikacji z innego katalogu.

mage -Update HelloWorld.deploy -AppCodeBase http://anotherserver/HelloWorld/1.1.0.0/

W poniższym przykładzie istniejący manifest wdrożenia jest podpisywany przy użyciu certyfikatu cyfrowego w bieżącym katalogu roboczym.

mage -Sign deploy.application -CertFile cert.pfx -Password <passwd>

Poniższy przykład podpisuje istniejący manifest wdrożenia przy użyciu certyfikatu cyfrowego i klucza prywatnego w bieżącym katalogu pracy.

mage -Sign deploy.application -CertFile cert.pfx -KeyContainer keyfile.snk -CryptoProvider "Microsoft Enhanced Cryptographic Provider v1.0"

Zobacz też