Mage.exe (Narzędzie generowania manifestu i edytowania)
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 wdrażania. Jako narzędzie wiersza polecenia można uruchamiać Mage.exe zarówno ze skryptów wsadowych, jak i innych aplikacji opartych na systemie Windows, w tym aplikacji ASP.NET.
Można również użyć MageUI.exe, aplikacji graficznej, a nie Mage.exe. Aby uzyskać więcej informacji, zobacz MageUI.exe (Narzędzie tworzenia i edycji manifestów, klient graficzny).
To narzędzie jest instalowane automatycznie z programem Visual Studio. Aby uruchomić narzędzie, użyj wiersza polecenia dla deweloperów programu Visual Studio lub programu Visual Studio Developer PowerShell.
W programie Visual Studio są dołączone dwie wersje Mage.exe i MageUI.exe . 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.exe i MageUI.exe.
Składnia
Mage [commands] [commandOptions]
Parametry
W poniższej tabeli przedstawiono polecenia obsługiwane przez Mage.exe. Aby uzyskać więcej informacji na temat opcji obsługiwanych przez te polecenia, zobacz Opcje poleceń Nowy i Aktualizuj oraz Opcje polecenia Podpisywanie.
| Polecenie | opis |
|---|---|
| -cc, ClearApplicationCache | Czyści pamięć podręczną pobranych aplikacji ze wszystkich aplikacji działających tylko w trybie online. |
| -n, -New fileType [newOptions] | Tworzy nowy plik danego typu. Poprawne typy to: - 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ę pliku i ścieżkę nowego pliku. Użyj opcji -FromDirectory (zobacz w poniższej tabeli), aby utworzyć manifest aplikacji ze wszystkimi zestawami 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 przy użyciu certyfikatu, usługa -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 zastępować istniejący plik. |
-s, -Sign [signOptions] |
Używa pary kluczy lub certyfikatu X509 w celu podpisania pliku. Podpisy są wstawiane jako elementy XML wewnątrz plików. Podczas podpisywania manifestu określającego wartość -TimestampUri należy nawiązać połączenie z Internetem. |
| -ver, -Verify [manifest-filename] | Sprawdza, czy manifest jest poprawnie podpisany. Nie można połączyć z innymi poleceniami. Dostępne w programie .NET Framework 4.7 i nowszych wersjach. |
| -h, -?, -Pomoc [pełne] | Opisuje wszystkie z dostępnych poleceń i ich opcji. Określ, verbose aby uzyskać szczegółową pomoc. |
Nowe i aktualizuj opcje poleceń
W poniższej tabeli przedstawiono opcje obsługiwane przez -New polecenia 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 manifestReference |
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 manifestPath |
Manifesty wdrożenia. | Wstawia do manifestu wdrożenia odwołanie do manifestu wdrażanej aplikacji. Plik wskazany przez manifestPath musi istnieć lub Mage.exe spowoduje wystąpienie błędu. Jeśli plik, do których odwołuje się manifestPath plik, nie jest manifestem aplikacji, Mage.exe wystąpi błąd. |
|
-cf, -CertFile filePath |
Wszystkie typy plików. | Określa lokalizację certyfikatu cyfrowego X509 do podpisywania manifestu lub pliku licencji. Tej opcji można używać w połączeniu z opcją -Password , jeśli certyfikat wymaga hasła do plików wymiany informacji osobistych (PFX). Począwszy od programu .NET Framework 4.7, jeśli plik nie zawiera klucza prywatnego, wymagana jest kombinacja opcji -CryptoProvider i -KeyContainer . Począwszy od programu .NET Framework 4.6.2, Mage.exe podpisuje manifesty przy użyciu CNG, a także certyfikatów CAPI. |
|
-ch, -CertHash hashSignature |
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 może być wielką lub małą literą i można je podać jako pojedynczy ciąg lub z każdym oktetem odcisku palca oddzielonego spacjami i całym odciskiem palca ujętym w cudzysłów. |
|
-csp, -CryptoProvider provider-name |
Wszystkie typy plików. | Określa nazwę dostawcy usług kryptograficznych (CSP), który zawiera kontener klucza prywatnego. Ta opcja wymaga opcji -KeyContainer . Ta opcja jest dostępna od programu .NET Framework 4.7. |
|
-fd, -FromDirectory directoryPath |
Manifesty aplikacji. | Wypełnia manifest aplikacji opisami wszystkich zestawów i plików znalezionych w pliku , w directoryPathtym wszystkich podkatalogów, gdzie directoryPath jest katalog zawierający aplikację, którą chcesz wdrożyć. Dla każdego pliku w katalogu Mage.exe decyduje, czy plik jest zestawem, czy plikiem statycznym. Jeśli jest to zestaw, dodaje <dependency> tag i installFrom atrybut do aplikacji z nazwą zestawu, bazą kodu i wersją. Jeśli jest to plik statyczny, dodaje <file> tag. Mage.exe również użyje prostego zestawu heurystyki do wykrywania głównego pliku wykonywalnego dla aplikacji i oznaczy go jako punkt wejścia aplikacji ClickOnce w manifeście.Mage.exe nigdy nie będzie automatycznie oznaczać pliku jako "danych". Tę czynność należy wykonać ręcznie. Aby uzyskać więcej informacji, zobacz How to: Include a Data File in a ClickOnce Application (Instrukcje: dołączanie pliku danych do aplikacji ClickOnce). 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 w wdrożeniu ulegnie zmianie, możesz uruchomić Mage.exe za pomocą polecenia -Update i opcji -FromDirectory , a także zaktualizować skróty i wersje zestawów wszystkich plików, do których odwołuje się odwołanie. -FromDirectory będzie zawierać wszystkie pliki we wszystkich podkatalogach znalezionych w folderze directoryPath.Jeśli używasz -FromDirectory z poleceniem -Update , Mage.exe usunie wszystkie pliki w manifeście aplikacji, które już nie istnieją w katalogu. |
|
-if, -IconFile filePath |
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 url |
prawda | Manifesty wdrożenia. | Wskazuje, czy manifest wdrożenia zawiera wartość lokalizacji aktualizacji ustawioną przez -ProviderURL. |
-i, -Install willInstall |
prawda | Manifesty wdrożenia. | Wskazuje, czy aplikacja ClickOnce ma zostać zainstalowana na komputerze lokalnym, czy ma być uruchamiana z sieci Web. Zainstalowanie aplikacji daje aplikacji obecność w menu Start systemu Windows. 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 zainstalowanie aplikacji niezależnie od wartości przekazanej do -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 name |
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 programu .NET Framework 4.7. |
|
-mv, -MinVersion [version] |
Wersja wymieniona w manifeście wdrożenia ClickOnce 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 taką samą semantykę jak argument flagi -Version . |
-n, -Name nameString |
Wdróż | Wszystkie typy plików. | Nazwa, która jest używana do identyfikacji aplikacji. Funkcja ClickOnce użyje tej nazwy, aby zidentyfikować aplikację w menu Start (jeśli aplikacja jest skonfigurowana do samodzielnego zainstalowania) i w oknach dialogowych Podniesienie uprawnień. Uwaga: jeśli aktualizujesz istniejący manifest i nie określisz nazwy wydawcy za pomocą tej opcji, Mage.exe zaktualizować manifest o nazwie organizacji zdefiniowanej na komputerze. Aby użyć innej nazwy, należy użyć tej opcji i określić odpowiednią nazwę wydawcy. |
-pwd, -Password passwd |
Wszystkie typy plików. | Hasło używane do podpisywania manifestu za pomocą certyfikatu cyfrowego. Należy używać w połączeniu z opcją -CertFile . | |
-p, procesor processorValue |
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, , ia64x86i amd64. msil jest językiem pośrednim firmy Microsoft, co oznacza, że wszystkie zestawy są niezależne od platformy, a środowisko uruchomieniowe języka wspólnego (CLR) będzie kompilować je w czasie podczas pierwszego uruchomienia aplikacji. |
-pu, -ProviderURL url |
Manifesty wdrożenia. | Określa adres URL, pod którym technologia ClickOnce będzie szukać aktualizacji aplikacji. | |
-pub, -Publisher publisherName |
Manifesty aplikacji. Manifesty wdrożenia. |
Dodaje nazwę wydawcy do opisu elementu manifestu wdrożenia lub aplikacji. W przypadku użycia w manifeście aplikacji parametr -UseManifestForTrust musi być również określony z wartością "true" lub "t"; w przeciwnym razie ten parametr zgłosi błąd. | |
-s, -SupportURL url |
Manifesty aplikacji. Manifesty wdrożenia. |
Określa łącze, które pojawia się w aplecie Dodaj lub usuń programy dla aplikacji ClickOnce. | |
-ti, -TimestampUri uri |
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 Członkowie programu certyfikatów głównych systemu Windows. | |
-t, -ToFile filePath |
-Nowy: — Wdrażanie: 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 parametr -ToFile nie zostanie podany podczas używania parametru -New, dane wyjściowe są zapisywane w bieżącym katalogu roboczym. Jeśli parametr -ToFile nie zostanie podany podczas używania -Update, Mage.exe zapisze plik z powrotem do pliku wejściowego. |
-tr, -TrustLevel level |
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 willUseForTrust |
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 versionNumber |
1.0.0.0 | Manifesty aplikacji. Manifesty wdrożenia. |
Wersja wdrożenia. Argument musi być prawidłowym ciągiem wersji formatu "N.N.N.N.N.N.", gdzie "N" jest niepodpisaną 32-bitową liczbą całkowitą. |
-wpf, -WPFBrowserApp isWPFApp |
fałsz | Manifesty aplikacji. Manifesty wdrożenia. |
Użyj tej flagi tylko wtedy, gdy aplikacja jest aplikacją Windows Presentation Foundation (WPF), która będzie hostowana w przeglądarce i nie jest autonomicznym plikiem wykonywalnym. Prawidłowymi wartościami są „true” lub „t” oraz „false” lub „f”. W przypadku manifestów aplikacji wstawia hostInBrowser atrybut pod entryPoint elementem manifestu aplikacji.W przypadku manifestów wdrażania ustawia install atrybut elementu na deployment false i zapisuje manifest wdrożenia z rozszerzeniem xbap. Określenie tego argumentu wraz z argumentem -Install powoduje błąd, ponieważ aplikacja hostowana w przeglądarce nie może być zainstalowaną aplikacją offline. |
Opcje polecenia podpisywania
W poniższej tabeli przedstawiono opcje obsługiwane przez -Sign polecenie, które mają zastosowanie do wszystkich typów plików.
| Opcje | opis |
|---|---|
-cf, -CertFile filePath |
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 do plików wymiany informacji osobistych (PFX). Począwszy od programu .NET Framework 4.7, jeśli plik nie zawiera klucza prywatnego, wymagana jest kombinacja opcji -CryptoProvider i -KeyContainer . Począwszy od programu .NET Framework 4.6.2, Mage.exe podpisuje manifesty przy użyciu CNG, a także certyfikatów CAPI. |
-ch, -CertHash hashSignature |
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 może być wielkie lub małe i może być podane jako pojedynczy ciąg lub z każdym oktetem odcisku palca oddzielonego spacjami i całym odciskiem palca ujętym w cudzysłów. |
-csp, -CryptoProvider provider-name |
Określa nazwę dostawcy usług kryptograficznych (CSP), który zawiera kontener klucza prywatnego. Ta opcja wymaga opcji -KeyContainer . Ta opcja jest dostępna od programu .NET Framework 4.7. |
-kc, -KeyContainer name |
Określa kontener kluczy, który zawiera nazwę klucza prywatnego. Ta opcja wymaga opcji CryptoProvider . Ta opcja jest dostępna od programu .NET Framework 4.7. |
-pwd, -Password passwd |
Hasło używane do podpisywania manifestu za pomocą certyfikatu cyfrowego. Należy używać w połączeniu z opcją -CertFile . |
-t, -ToFile filePath |
Określa ścieżkę wyjściową utworzonego lub zmodyfikowanego pliku. |
Uwagi
Wszystkie argumenty Mage.exe są bez uwzględniania wielkości liter. Polecenia i opcje mogą być poprzedzone kreską (-) lub ukośnikiem (/).
Wszystkie argumenty używane w poleceniu -Sign mogą być używane w dowolnym momencie z poleceniami -New lub -Update . 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 programu .NET Framework w wersji 4.6.2, obsługiwane są również certyfikaty CNG.
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.
Jeśli używasz opcji -AppManifest do wypełnienia manifestu wdrożenia, Mage.exe zakłada, że manifest aplikacji będzie znajdować się w tym samym katalogu co manifest wdrożenia w podkatalogu o nazwie po 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ć alternatywną lokalizację.
Manifesty wdrożenia i aplikacji muszą zostać podpisane przed wdrożeniem aplikacji. Aby uzyskać wskazówki dotyczące manifestów podpisywania, zobacz Omówienie zaufanego wdrażania aplikacji.
Opcja -TrustLevel dla manifestów aplikacji opisuje zestaw uprawnień, który aplikacja wymaga uruchomienia na komputerze klienckim. Domyślnie aplikacje mają przypisany 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 środowiska CLR wyświetli użytkownikowi monit o podjęcie decyzji, czy chce udzielić tego 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średnio dodawania niestandardowej sekcji zaufania. Można go dodać przy użyciu edytora tekstów, analizatora XML lub narzędzia graficznego MageUI.exe. Aby uzyskać więcej informacji na temat używania MageUI.exe do dodawania niestandardowych sekcji zaufania, zobacz MageUI.exe (Narzędzie tworzenia i edycji manifestów, klient graficzny).
Program Visual Studio 2017 zawiera wersję 4.6.1 Mage.exe. Manifesty utworzone przy użyciu tej wersji Mage.exe docelowej platformy .NET Framework 4. Aby kierować do starszych wersji programu .NET Framework, użyj starszej wersji Mage.exe.
Podczas dodawania lub usuwania zestawów z istniejącego manifestu lub ponownego podpisywania istniejącego manifestu Mage.exe nie aktualizuje manifestu do docelowego programu .NET Framework 4.
W poniższych tabelach przedstawiono te 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 | Otwarcie | OK | OK |
| Zamknij | OK | OK | |
| Zapisz | OK | OK | |
| Ponowne podpisane | OK | OK | |
| Nowe | OK | Nieobsługiwane | |
| Aktualizacja (zobacz poniżej) | OK | OK | |
| Manifest dla aplikacji, których platforma docelowa to wersja 4 programu .NET Framework | Otwarcie | OK | OK |
| Zamknij | OK | OK | |
| Zapisz | OK | OK | |
| Ponowne podpisane | OK | OK | |
| Nowe | 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 przeznaczone dla profilu klienta programu .NET Framework 4. Aplikacje ClickOnce przeznaczone dla profilu klienta programu .NET Framework 4 mogą działać zarówno w profilu klienta programu .NET Framework 4, jak i w pełnej wersji programu .NET Framework 4. Jeśli aplikacja jest przeznaczona dla pełnej wersji programu .NET Framework 4 i nie może działać w profilu klienta programu .NET Framework 4, usuń element klienta <framework> przy użyciu edytora tekstów i ponownie podpisać manifest.
Poniżej przedstawiono przykładowy <framework> element przeznaczony dla profilu klienta programu .NET Framework 4:
<framework targetVersion="4.0" profile="client" supportedRuntime="4.0.20506" />
Przykłady
W poniższym przykładzie zostanie otwarty interfejs użytkownika programu 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, jak utworzyć parę manifestów na potrzeby wdrażania aplikacji WPF, która będzie hostowana w przeglądarce.
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 i podpisów.
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 roboczym.
mage -Sign deploy.application -CertFile cert.pfx -KeyContainer keyfile.snk -CryptoProvider "Microsoft Enhanced Cryptographic Provider v1.0"
