Mage.exe (hulpprogramma voor het genereren en bewerken van manifesten)
Het hulpprogramma voor het genereren en bewerken van manifesten (Mage.exe) is een opdrachtregelprogramma dat ondersteuning biedt voor het maken en bewerken van toepassings- en implementatiemanifesten. Als opdrachtregelprogramma kan Mage.exe worden uitgevoerd vanuit zowel batchscripts als andere Windows-toepassingen, waaronder ASP.NET toepassingen.
U kunt ook MageUI.exe, een grafische toepassing, gebruiken in plaats van Mage.exe. Zie MageUI.exe (Manifest Generation and Editing Tool, Graphical Client) voor meer informatie.
Dit hulpprogramma wordt automatisch geïnstalleerd met Visual Studio. Als u het hulpprogramma wilt uitvoeren, gebruikt u de Visual Studio Developer-opdrachtprompt of Visual Studio Developer PowerShell.
Er zijn twee versies van Mage.exe en MageUI.exe opgenomen in Visual Studio. Als u versiegegevens wilt bekijken, voert u MageUI.exe uit, selecteert u Help en selecteert u Over. In deze documentatie wordt versie 4.0.x.x van Mage.exe en MageUI.exe beschreven.
Syntaxis
Mage [commands] [commandOptions]
Parameters
In de volgende tabel ziet u de opdrachten die worden ondersteund door Mage.exe. Zie voor meer informatie over de opties die door deze opdrachten worden ondersteund de opdrachtopties Nieuw en Bijwerken en Opdrachtopties ondertekenen.
| Opdracht | Beschrijving |
|---|---|
| -cc, ClearApplicationCache | Hiermee wist u de gedownloade toepassingscache van alle onlinetoepassingen. |
| -n, -New fileType [newOptions] | Hiermee maakt u een nieuw bestand van het opgegeven type. Geldige typen zijn: - Deployment: Hiermee maakt u een nieuw implementatiemanifest.- Application: Hiermee maakt u een nieuw toepassingsmanifest.Als u met deze opdracht geen extra parameters opgeeft, wordt er een bestand van het juiste type gemaakt, met de juiste standaardtags en kenmerkwaarden. Gebruik de optie -ToFile (zie in de volgende tabel) om de bestandsnaam en het pad van het nieuwe bestand op te geven. Gebruik de optie -FromDirectory (zie in de volgende tabel) om een toepassingsmanifest te maken met alle assembly's voor een toepassing die is toegevoegd aan de <afhankelijkheidssectie> van het manifest. |
| -u, -Update [filePath] [updateOptions] | Brengt een of meer wijzigingen aan in een manifestbestand. U hoeft niet het type bestand op te geven dat u bewerkt. Mage.exe onderzoekt het bestand met behulp van een set heuristieken en bepaalt of het een implementatiemanifest of een toepassingsmanifest is. Als u al een bestand met een certificaat hebt ondertekend, verwijdert -Update het handtekeningblok van de sleutel. Dit komt doordat de sleutelhandtekening een hash van het bestand bevat en als u het bestand wijzigt, wordt de hash ongeldig weergegeven. Gebruik de optie -ToFile (zie in de volgende tabel) om een nieuwe bestandsnaam en een nieuw pad op te geven in plaats van het bestaande bestand te overschrijven. |
-s, -Sign [signOptions] |
Gebruikt een sleutelpaar of X509-certificaat om een bestand te ondertekenen. Handtekeningen worden ingevoegd als XML-elementen in de bestanden. U moet zijn verbonden met internet wanneer u een manifest ondertekent dat een -TimestampUri-waarde aangeeft. |
| -ver, -Verifiëren [manifest-bestandsnaam] | Controleert of het manifest juist is ondertekend. Kan niet worden gecombineerd met andere opdrachten. Beschikbaar in .NET Framework 4.7 en nieuwere versies. |
| -h, -?, -Help [uitgebreid] | Beschrijft alle beschikbare opdrachten en de bijbehorende opties. Geef verbose op om gedetailleerde hulp te krijgen. |
Nieuwe en bijwerkopdrachtopties
In de volgende tabel ziet u de opties die worden ondersteund door de -New en -Update opdrachten:
| Opties | Standaardwaarde | Van toepassing op | Beschrijving |
|---|---|---|---|
| -a, -Algorithm | sha1RSA | Toepassingsmanifesten. Implementatiemanifesten. |
Hiermee geeft u het algoritme waarmee afhankelijkheidssamenvatingen worden gegenereerd. De waarde moet 'sha256RSA' of 'sha1RSA' zijn. Gebruik deze optie met de optie '-Bijwerken'. Deze optie wordt genegeerd wanneer u de optie -Sign gebruikt |
-appc, -AppCodeBase manifestReference |
Implementatiemanifesten. | Hiermee voegt u een URL- of bestandspadreferentie in naar het manifestbestand van de toepassing. Deze waarde moet het volledige pad naar het toepassingsmanifest zijn. | |
-appm, -AppManifest manifestPath |
Implementatiemanifesten. | Hiermee voegt u een verwijzing naar het toepassingsmanifest van een implementatie in het implementatiemanifest in. Het bestand dat wordt manifestPath aangegeven, moet bestaan of Mage.exe geeft een fout op. Als het bestand waarnaar wordt verwezen manifestPath geen toepassingsmanifest is, geeft Mage.exe een fout op. |
|
-cf, -CertFile filePath |
Alle bestandstypen. | Hiermee geeft u de locatie van een X509 digitaal certificaat voor het ondertekenen van een manifest of licentiebestand. Deze optie kan worden gebruikt in combinatie met de optie -Password als voor het certificaat een wachtwoord is vereist voor PFX-bestanden (Personal Information Exchange). Vanaf .NET Framework 4.7 is een combinatie van de opties -CryptoProvider en -KeyContainer vereist als het bestand geen persoonlijke sleutel bevat. Vanaf .NET Framework 4.6.2 ondertekent Mage.exe manifesten met CNG en CAPI-certificaten. |
|
-ch, -CertHash hashSignature |
Alle bestandstypen. | De hash van een digitaal certificaat dat is opgeslagen in het persoonlijke certificaatarchief van de clientcomputer. Dit komt overeen met de vingerafdruktekenreeks van een digitaal certificaat dat wordt weergegeven in de Windows-certificaatconsole.hashSignature kan hoofdletters of kleine letters zijn en kunnen worden opgegeven als één tekenreeks, of met elke octet van de vingerafdruk gescheiden door spaties en de volledige vingerafdruk tussen aanhalingstekens. |
|
-csp, -CryptoProvider provider-name |
Alle bestandstypen. | Hiermee geeft u de naam op van een cryptografische serviceprovider (CSP) die de container met persoonlijke sleutels bevat. Voor deze optie is de optie -KeyContainer vereist. Deze optie is beschikbaar vanaf .NET Framework 4.7. |
|
-fd, -FromDirectory directoryPath |
Toepassingsmanifesten. | Vult het toepassingsmanifest met beschrijvingen van alle assembly's en bestanden in directoryPath, inclusief alle submappen, waar directoryPath de map is die de toepassing bevat die u wilt implementeren. Voor elk bestand in de map bepaalt Mage.exe of het bestand een assembly of een statisch bestand is. Als het een assembly is, wordt er een <dependency> tag en installFrom kenmerk toegevoegd aan de toepassing met de naam, de codebasis en de versie van de assembly. Als het een statisch bestand is, wordt er een <file> tag toegevoegd. Mage.exe gebruikt ook een eenvoudige set heuristieken om het belangrijkste uitvoerbare bestand voor de toepassing te detecteren en markeert deze als het toegangspunt van de ClickOnce-toepassing in het manifest.Mage.exe een bestand nooit automatisch markeert als een 'gegevensbestand'. U moet dit handmatig doen. Zie Instructies voor meer informatie : Een gegevensbestand opnemen in een ClickOnce-toepassing. Mage.exe genereert ook een hash voor elk bestand op basis van de grootte. ClickOnce gebruikt deze hashes om ervoor te zorgen dat niemand met de bestanden van de implementatie heeft geknoeid sinds het manifest is gemaakt. Als een van de bestanden in uw implementatie wordt gewijzigd, kunt u Mage.exe uitvoeren met de opdracht -Update en de optie -FromDirectory. De hashes en assemblyversies van alle bestanden waarnaar wordt verwezen, worden bijgewerkt. -FromDirectory bevat alle bestanden in alle submappen die zijn gevonden in directoryPath.Als u -FromDirectory gebruikt met de opdracht -Update , verwijdert Mage.exe bestanden in het toepassingsmanifest dat niet meer in de map bestaat. |
|
-if, -IconFile filePath |
Toepassingsmanifesten. | Hiermee geeft u het volledige pad naar een . ICO-pictogrambestand. Dit pictogram wordt weergegeven naast de naam van uw toepassing in het menu Start en in de vermelding Programma's toevoegen of verwijderen. Als er geen pictogram is opgegeven, wordt er een standaardpictogram gebruikt. | |
-ip, -IncludeProviderURL url |
true | Implementatiemanifesten. | Geeft aan of het implementatiemanifest de waarde voor de updatelocatie bevat die is ingesteld door -ProviderURL. |
-i, -Install willInstall |
true | Implementatiemanifesten. | Hiermee wordt aangegeven of de ClickOnce-toepassing moet worden geïnstalleerd op de lokale computer of of deze vanaf het web moet worden uitgevoerd. Als u een toepassing installeert, krijgt deze toepassing een aanwezigheid in het menu Start van Windows. Geldige waarden zijn 'true' of 't' en 'false' of 'f'. Als u de optie -MinVersion opgeeft en een gebruiker een versie heeft die kleiner is dan -MinVersion , wordt de toepassing gedwongen te installeren, ongeacht de waarde die u doorgeeft aan -Install. Deze optie kan niet worden gebruikt met de optie -BrowserHosted . Als u probeert beide voor hetzelfde manifest op te geven, treedt er een fout op. |
-kc, -KeyContainer name |
Alle bestandstypen. | Hiermee geeft u de sleutelcontainer die de naam van de persoonlijke sleutel bevat. Voor deze optie is de optie CryptoProvider vereist. Deze optie is beschikbaar vanaf .NET Framework 4.7. |
|
-mv, -MinVersion [version] |
De versie die wordt vermeld in het ClickOnce-implementatiemanifest zoals opgegeven door de vlag -Version . | Implementatiemanifesten. | De minimale versie van deze toepassing die een gebruiker kan uitvoeren. Met deze vlag wordt de benoemde versie van uw toepassing een vereiste update. Als u een versie van uw product vrijgeeft met een update naar een wijziging die fouten veroorzaken of een kritieke beveiligingsfout, kunt u deze vlag gebruiken om op te geven dat deze update moet worden geïnstalleerd en dat de gebruiker geen eerdere versies kan blijven uitvoeren.version heeft dezelfde semantiek als het argument voor de vlag -Version . |
-n, -Naam nameString |
Implementeren | Alle bestandstypen. | De naam die wordt gebruikt om de toepassing te identificeren. ClickOnce gebruikt deze naam om de toepassing te identificeren in het menu Start (als de toepassing is geconfigureerd om zichzelf te installeren) en in het dialoogvenster Machtigingstoezetting. Opmerking: als u een bestaand manifest bijwerkt en u geen uitgevernaam opgeeft met deze optie, Mage.exe het manifest bijwerken met de organisatienaam die is gedefinieerd op de computer. Als u een andere naam wilt gebruiken, moet u deze optie gebruiken en de gewenste uitgevernaam opgeven. |
-pwd, -Password passwd |
Alle bestandstypen. | Het wachtwoord dat wordt gebruikt voor het ondertekenen van een manifest met een digitaal certificaat. Moet worden gebruikt in combinatie met de optie -CertFile . | |
-p, Processor processorValue |
Msil | Toepassingsmanifesten. Implementatiemanifesten. |
De microprocessorarchitectuur waarop deze distributie wordt uitgevoerd. Deze waarde is vereist als u een of meer installaties voorbereidt waarvan de assembly's vooraf zijn gecompileerd voor een specifieke microprocessor. Geldige waarden zijn onder andere msil, x86, ia64en amd64. msil is een tussenliggende taal van Microsoft, wat betekent dat al uw assembly's platformonafhankelijk zijn en dat de Common Language Runtime (CLR) deze just-in-time compileert wanneer uw toepassing voor het eerst wordt uitgevoerd. |
-pu, -ProviderURL url |
Implementatiemanifesten. | Hiermee geeft u de URL op die ClickOnce zal onderzoeken voor toepassingsupdates. | |
-pub, -Publisher publisherName |
Toepassingsmanifesten. Implementatiemanifesten. |
Hiermee voegt u de naam van de uitgever toe aan het beschrijvingselement van het implementatie- of toepassingsmanifest. Wanneer deze wordt gebruikt in een toepassingsmanifest, moet -UseManifestForTrust ook worden opgegeven met de waarde 'true' of 't'. Anders wordt met deze parameter een fout gegenereerd. | |
-s, -SupportURL url |
Toepassingsmanifesten. Implementatiemanifesten. |
Hiermee geeft u de koppeling op die wordt weergegeven in Programma's toevoegen of verwijderen voor de ClickOnce-toepassing. | |
-ti, -TimestampUri uri |
Toepassingsmanifesten. Implementatiemanifesten. |
De URL van een digitale tijdstempelservice. Met timestamping van de manifesten voorkomt u dat u de manifesten opnieuw moet ondertekenen als uw digitale certificaat verloopt voordat u de volgende versie van uw toepassing implementeert. Zie leden van het Windows-basiscertificaatprogramma voor meer informatie. | |
-t, -ToFile filePath |
-Nieuw: - Implementatie: deploy.application - Toepassing: application.exe.manifest -Update: - Het invoerbestand. |
Alle bestandstypen. | Hiermee geeft u het uitvoerpad op van het bestand dat is gemaakt of gewijzigd. Als -ToFile niet wordt opgegeven wanneer u -New gebruikt, wordt de uitvoer naar de huidige werkmap geschreven. Als -ToFile niet wordt opgegeven wanneer u -Update gebruikt, schrijft Mage.exe het bestand terug naar het invoerbestand. |
-tr, -TrustLevel level |
Op basis van de zone waarin de TOEPASSINGs-URL zich bevindt. | Toepassingsmanifesten. | Het vertrouwensniveau voor het verlenen van de toepassing op clientcomputers. Waarden zijn internet, intranet en FullTrust. |
-um, -UseManifestForTrust willUseForTrust |
Onwaar | Toepassingsmanifesten. | Hiermee geeft u op of de digitale handtekening van het toepassingsmanifest wordt gebruikt voor het nemen van vertrouwensbeslissingen wanneer de toepassing wordt uitgevoerd op de client. Als u 'true' of 't' opgeeft, wordt aangegeven dat het toepassingsmanifest wordt gebruikt voor vertrouwensbeslissingen. Als u 'false' of 'f' opgeeft, wordt aangegeven dat de handtekening van het implementatiemanifest wordt gebruikt. |
-v, -Version versionNumber |
1.0.0.0 | Toepassingsmanifesten. Implementatiemanifesten. |
De versie van de implementatie. Het argument moet een geldige versietekenreeks van de notatie N.N.N.N zijn, waarbij 'N' een niet-ondertekend 32-bits geheel getal is. |
-wpf, -WPFBrowserApp isWPFApp |
false | Toepassingsmanifesten. Implementatiemanifesten. |
Gebruik deze vlag alleen als de toepassing een WPF-toepassing (Windows Presentation Foundation) is die in een browser wordt gehost en geen zelfstandig uitvoerbaar bestand is. Geldige waarden zijn 'true' of 't' en 'false' of 'f'. Voor toepassingsmanifesten voegt u het hostInBrowser kenmerk in onder het entryPoint element van het toepassingsmanifest.Voor implementatiemanifesten stelt u het install kenmerk van het deployment element in op false en slaat u het implementatiemanifest op met de extensie .xbap. Als u dit argument samen met het argument -Install opgeeft, wordt er een fout gegenereerd, omdat een door een browser gehoste toepassing geen geïnstalleerde, offlinetoepassing kan zijn. |
Opties voor de opdracht Ondertekenen
In de volgende tabel ziet u de opties die worden ondersteund door de -Sign opdracht, die van toepassing zijn op alle typen bestanden.
| Opties | Beschrijving |
|---|---|
-cf, -CertFile filePath |
Hiermee geeft u de locatie van een digitaal certificaat voor het ondertekenen van een manifest. Deze optie kan worden gebruikt in combinatie met de optie -Password als voor het certificaat een wachtwoord is vereist voor PFX-bestanden (Personal Information Exchange). Vanaf .NET Framework 4.7 is een combinatie van de opties -CryptoProvider en -KeyContainer vereist als het bestand geen persoonlijke sleutel bevat. Vanaf .NET Framework 4.6.2 ondertekent Mage.exe manifesten met CNG en CAPI-certificaten. |
-ch, -CertHash hashSignature |
De hash van een digitaal certificaat dat is opgeslagen in het persoonlijke certificaatarchief van de clientcomputer. Dit komt overeen met de vingerafdrukeigenschap van een digitaal certificaat dat wordt weergegeven in de Windows-certificatenconsole.hashSignature kan hoofdletters of kleine letters zijn en kunnen worden opgegeven als één tekenreeks of met elke octet van de vingerafdruk gescheiden door spaties en de volledige vingerafdruk tussen aanhalingstekens. |
-csp, -CryptoProvider provider-name |
Hiermee geeft u de naam op van een cryptografische serviceprovider (CSP) die de container met persoonlijke sleutels bevat. Voor deze optie is de optie -KeyContainer vereist. Deze optie is beschikbaar vanaf .NET Framework 4.7. |
-kc, -KeyContainer name |
Hiermee geeft u de sleutelcontainer die de naam van de persoonlijke sleutel bevat. Voor deze optie is de optie CryptoProvider vereist. Deze optie is beschikbaar vanaf .NET Framework 4.7. |
-pwd, -Password passwd |
Het wachtwoord dat wordt gebruikt voor het ondertekenen van een manifest met een digitaal certificaat. Moet worden gebruikt in combinatie met de optie -CertFile . |
-t, -ToFile filePath |
Hiermee geeft u het uitvoerpad op van het bestand dat is gemaakt of gewijzigd. |
Opmerkingen
Alle argumenten voor Mage.exe zijn niet hoofdlettergevoelig. Opdrachten en opties kunnen worden voorafgegaan door een streepje (-) of een slash (/).
Alle argumenten die worden gebruikt met de opdracht -Sign kunnen op elk gewenst moment worden gebruikt met de opdrachten -New of -Update . De volgende opdrachten zijn equivalent.
mage -Sign c:\HelloWorldDeployment\HelloWorld.deploy -CertFile cert.pfx
mage -Update c:\HelloWorldDeployment\HelloWorld.deploy -CertFile cert.pfx
Notitie
Vanaf .NET Framework versie 4.6.2 worden CNG-certificaten ook ondersteund.
Ondertekening is de laatste taak die u moet uitvoeren, omdat een ondertekend document een hash van het bestand gebruikt om te controleren of de handtekening geldig is voor het document. Als u wijzigingen aanbrengt in een ondertekend bestand, moet u het opnieuw ondertekenen. Als u een document ondertekent dat eerder is ondertekend, vervangt Mage.exe de oude handtekening door de nieuwe.
Wanneer u de optie -AppManifest gebruikt om een implementatiemanifest te vullen, gaat Mage.exe ervan uit dat uw toepassingsmanifest zich in dezelfde map bevindt als het implementatiemanifest in een submap die is vernoemd naar de huidige implementatieversie en uw implementatiemanifest op de juiste manier configureert. Als uw toepassingsmanifest zich ergens anders bevindt, gebruikt u de optie -AppCodeBase om de alternatieve locatie in te stellen.
Uw implementatie- en toepassingsmanifest moet zijn ondertekend voordat u uw toepassing implementeert. Zie Overzicht van implementatie van vertrouwde toepassingen voor hulp bij ondertekeningsmanifesten.
De optie -TrustLevel voor toepassingsmanifesten beschrijft de machtigingenset die een toepassing moet uitvoeren op de clientcomputer. Standaard wordt aan toepassingen een vertrouwensniveau toegewezen op basis van de zone waarin de URL zich bevindt. Toepassingen die via een bedrijfsnetwerk worden geïmplementeerd, worden over het algemeen in de intranetzone geplaatst, terwijl toepassingen die via internet worden geïmplementeerd, in de internetzone worden geplaatst. In beide beveiligingszones worden beperkingen ingesteld voor de toegang van de toepassing tot lokale resources, waarbij de intranetzone iets meer permissief is dan de internetzone. De FullTrust-zone biedt toepassingen volledige toegang tot de lokale bronnen van een computer. Als u de optie -TrustLevel gebruikt om een toepassing in deze zone te plaatsen, wordt de gebruiker door het vertrouwensbeheeronderdeel van de CLR gevraagd om te bepalen of hij of zij dit hogere vertrouwensniveau wil verlenen. Als u uw toepassing implementeert via een bedrijfsnetwerk, kunt u de implementatie van vertrouwde toepassingen gebruiken om het vertrouwensniveau van de toepassing te verhogen zonder de gebruiker te vragen.
Toepassingsmanifesten ondersteunen ook aangepaste vertrouwenssecties. Dit helpt uw toepassing te voldoen aan het beveiligingsprincipe van het aanvragen van minimale machtigingen, omdat u het manifest zo kunt configureren dat alleen die specifieke machtigingen worden aangevraagd die de toepassing nodig heeft om uit te voeren. Mage.exe biedt geen rechtstreekse ondersteuning voor het toevoegen van een aangepaste vertrouwenssectie. U kunt er een toevoegen met behulp van een teksteditor, een XML-parser of het grafische hulpprogramma MageUI.exe. Zie MageUI.exe (Manifest Generation and Editing Tool, Graphical Client) voor meer informatie over het gebruik van MageUI.exe om aangepaste vertrouwenssecties toe te voegen.
Visual Studio 2017 bevat versie 4.6.1 van Mage.exe. Manifesten die zijn gemaakt met deze versie van Mage.exe doel .NET Framework 4. Als u oudere versies van .NET Framework wilt gebruiken, gebruikt u een eerdere versie van Mage.exe.
Wanneer u assembly's toevoegt aan of verwijdert uit een bestaand manifest of een bestaand manifest opnieuw ondertekent, werkt Mage.exe het manifest niet bij naar .NET Framework 4.
In de volgende tabellen worden deze functies en beperkingen weergegeven:
| Manifestversie | Operation | Mage v2.0 | Mage v4.0 |
|---|---|---|---|
| Manifest voor toepassingen die gericht zijn op versie 2.0 of 3.x van .NET Framework | Startkoers | OK | OK |
| Sluiten | OK | OK | |
| Opslaan | OK | OK | |
| Opnieuw ondertekenen | OK | OK | |
| Nieuw | OK | Niet ondersteund | |
| Bijwerken (zie hieronder) | OK | OK | |
| Manifest voor toepassingen die gericht zijn op versie 4 van .NET Framework | Startkoers | OK | OK |
| Sluiten | OK | OK | |
| Opslaan | OK | OK | |
| Opnieuw ondertekenen | OK | OK | |
| Nieuw | Niet ondersteund | OK | |
| Bijwerken (zie hieronder) | Niet ondersteund | OK |
| Manifestversie | Details van bewerking bijwerken | Mage v2.0 | Mage v4.0 |
|---|---|---|---|
| Manifest voor toepassingen die gericht zijn op versie 2.0 of 3.x van .NET Framework | Een assembly wijzigen | OK | OK |
| Een assembly toevoegen | OK | OK | |
| Een assembly verwijderen | OK | OK | |
| Manifest voor toepassingen die gericht zijn op versie 4 van .NET Framework | Een assembly wijzigen | Niet ondersteund | OK |
| Een assembly toevoegen | Niet ondersteund | OK | |
| Een assembly verwijderen | Niet ondersteund | OK |
Mage.exe maakt nieuwe manifesten die gericht zijn op het .NET Framework 4-clientprofiel. ClickOnce-toepassingen die zijn gericht op het .NET Framework 4-clientprofiel, kunnen worden uitgevoerd op zowel het .NET Framework 4-clientprofiel als de volledige versie van .NET Framework 4. Als uw toepassing is gericht op de volledige versie van .NET Framework 4 en niet kan worden uitgevoerd op het .NET Framework 4-clientprofiel, verwijdert u het clientelement <framework> met behulp van een teksteditor en ondertekent u het manifest opnieuw.
Hier volgt een voorbeeldelement <framework> dat is gericht op het .NET Framework 4-clientprofiel:
<framework targetVersion="4.0" profile="client" supportedRuntime="4.0.20506" />
Voorbeelden
In het volgende voorbeeld wordt de gebruikersinterface voor Mage (MageUI.exe) geopend.
mage
In de volgende voorbeelden wordt een standaardimplementatiemanifest en toepassingsmanifest gemaakt. Deze bestanden worden allemaal gemaakt in de huidige werkmap en hebben respectievelijk de naam deploy.application en application.exe.manifest.
mage -New Deployment
mage -New Application
In het volgende voorbeeld wordt een toepassingsmanifest gemaakt dat is gevuld met alle assembly's en resourcebestanden uit de huidige map.
mage -New Application -FromDirectory . -Version 1.0.0.0
In het volgende voorbeeld wordt het vorige voorbeeld voortgezet door de implementatienaam en doelmicroprocessor op te geven. Er wordt ook een URL opgegeven waarmee ClickOnce op updates moet controleren.
mage -New Application -FromDirectory . -Name "Hello, World! Application" -Version 1.0.0.0 -Processor "x86" -ProviderUrl http://internalserver/HelloWorld/
In het volgende voorbeeld ziet u hoe u een paar manifesten maakt voor het implementeren van een WPF-toepassing die wordt gehost in een browser.
mage -New Application -FromDirectory . -Version 1.0.0.0 -WPFBrowserApp true
mage -New Deployment -AppManifest 1.0.0.0\application.manifest -WPFBrowserApp true
In het volgende voorbeeld wordt een toepassingsmanifest gemaakt dat is gevuld met alle assembly's en resourcebestanden uit de huidige map en tekens.
mage -New Application -FromDirectory . -Version 1.0.0.0 -KeyContainer keypair.snk -CryptoProvider "Microsoft Enhanced Cryptographic Provider v1.0"
In het volgende voorbeeld wordt een implementatiemanifest bijgewerkt met informatie uit een toepassingsmanifest en wordt de codebasis ingesteld voor de locatie van het toepassingsmanifest.
mage -Update HelloWorld.deploy -AppManifest 1.0.0.0\application.manifest -AppCodeBase http://internalserver/HelloWorld.deploy
In het volgende voorbeeld wordt het implementatiemanifest bewerkt om een update van de geïnstalleerde versie van de gebruiker af te dwingen.
mage -Update c:\HelloWorldDeployment\HelloWorld.deploy -MinVersion 1.1.0.0
In het volgende voorbeeld wordt het implementatiemanifest verteld om het toepassingsmanifest op te halen uit een andere map.
mage -Update HelloWorld.deploy -AppCodeBase http://anotherserver/HelloWorld/1.1.0.0/
In het volgende voorbeeld wordt een bestaand implementatiemanifest ondertekend met behulp van een digitaal certificaat in de huidige werkmap.
mage -Sign deploy.application -CertFile cert.pfx -Password <passwd>
In het volgende voorbeeld wordt een bestaand implementatiemanifest ondertekend met behulp van een digitaal certificaat en een persoonlijke sleutel in de huidige werkmap.
mage -Sign deploy.application -CertFile cert.pfx -KeyContainer keyfile.snk -CryptoProvider "Microsoft Enhanced Cryptographic Provider v1.0"
