Bagikan melalui


Mage.exe (Pembuatan Manifes dan Alat Pengeditan)

Alat Pengeditan dan Pembuatan Manifes (Mage.exe) adalah alat baris perintah yang mendukung pembuatan dan pengeditan manifes aplikasi dan penyebaran. Sebagai alat baris perintah, Mage.exe dapat dijalankan dari skrip batch dan aplikasi berbasis Windows lainnya, termasuk aplikasi ASP.NET.

Anda juga dapat menggunakan MageUI.exe, aplikasi grafik, sebagai ganti Mage.exe. Untuk informasi selengkapnya, lihat MageUI.exe (Alat Pengeditan dan Pembuatan Manifes, Klien Grafis).

Alat ini otomatis terpasang dengan Visual Studio. Untuk menjalankan alat, gunakan Prompt Perintah Pengembang Visual Studio atau PowerShell Pengembang Visual Studio.

Dua versi Mage.exe dan MageUI.exe disertakan dengan Visual Studio. Untuk melihat informasi versi, jalankan MageUI.exe, pilih Bantuan, dan pilih Tentang. Dokumentasi ini menjelaskan versi 4.0.xx dari Mage.exe dan MageUI.exe.

Sintaks

Mage [commands] [commandOptions]

Parameter

Tabel berikut menunjukkan perintah yang didukung oleh Mage.exe. Untuk informasi selengkapnya tentang opsi yang didukung oleh perintah ini, lihat Opsi perintah Baru dan Perbarui dan Opsi perintah tanda tangan.

Perintah Deskripsi
-cc, ClearApplicationCache Menghapus cache aplikasi yang diunduh dari semua aplikasi online saja.
-n, -New fileType [newOptions] Membuat file baru dari jenis yang diberikan. Jenis yang valid adalah:

- Deployment: Membuat manifes penyebaran baru.
- Application: Membuat manifes aplikasi baru.

Jika Anda tidak menentukan parameter tambahan apa pun dengan perintah ini, itu akan membuat file dengan jenis yang sesuai, dengan tag default dan nilai atribut yang sesuai.

Gunakan opsi -ToFile (lihat tabel berikut) untuk menentukan nama file dan jalur file baru.

Gunakan opsi -FromDirectory (lihat tabel berikut) untuk membuat manifes aplikasi dengan semua rakitan untuk aplikasi yang ditambahkan ke bagian <dependensi> manifes.
-u, -Update [filePath] [updateOptions] Membuat satu atau lebih perubahan pada file manifes. Anda tidak perlu menentukan jenis file yang sedang Anda edit. Mage.exe akan memeriksa file dengan menggunakan serangkaian heuristik dan menentukan manifes penyebaran atau manifes aplikasi.

Jika Anda telah menandatangani file dengan sertifikat, -Update akan menghapus blok tanda tangan kunci. Ini karena tanda tangan kunci berisi hash file, dan memodifikasi file membuat hash tidak valid.

Gunakan opsi -ToFile (lihat tabel berikut) untuk menentukan nama file dan jalur baru, bukan menimpa file yang ada.
-s, -Sign [signOptions] Menggunakan pasangan kunci atau sertifikat X509 untuk menandatangani file. Tanda tangan dimasukkan sebagai elemen XML di dalam file.

Anda harus tersambung ke Internet saat menandatangani manifes yang menetapkan nilai -TimestampUri.
-ver, -Verifikasi [manifest-filename] Memverifikasi bahwa manifes ditandatangani dengan benar. Tidak dapat digabungkan dengan perintah lain.

Tersedia dalam versi .NET Framework 4.7 dan yang lebih baru.
-h, -?, -Help [verbose] Menjelaskan semua perintah yang tersedia dan pilihannya. Tentukan verbose untuk mendapatkan bantuan terperinci.

Opsi perintah Baru dan Perbarui

Tabel berikut menunjukkan opsi yang didukung oleh -New dan -Update perintah:

Opsi Nilai Default Berlaku Untuk Deskripsi
-a, -Algorithm sha1RSA Manifes aplikasi.

Manifes penyebaran.
Menentukan algoritme untuk menghasilkan digest dependensi. Nilai harus "sha256RSA" atau "sha1RSA.

Gunakan dengan opsi "-Perbarui". Opsi ini diabaikan saat menggunakan opsi "-Sign"
-appc, -AppCodeBase manifestReference Manifes penyebaran. Menyisipkan URL atau referensi jalur file ke file manifes aplikasi. Nilai ini harus berupa jalur lengkap ke manifes aplikasi.
-appm, -AppManifest manifestPath Manifes penyebaran. Menyisipkan referensi ke manifes aplikasi penyebaran ke dalam manifes penyebarannya.

Berkas yang ditunjukkan oleh manifestPath harus ada, atau Mage.exe akan menampilkan kesalahan. Jika file yang dirujuk oleh manifestPath bukan manifes aplikasi, Mage.exe akan menampilkan kesalahan.
-cf, -CertFile filePath Semua jenis file. Menentukan lokasi sertifikat digital X509 untuk menandatangani file manifes atau lisensi. Opsi ini dapat digunakan bersama dengan opsi -Kata Sandi jika sertifikat memerlukan kata sandi untuk berkas Pertukaran Informasi Pribadi (PFX). Mulai dari versi .NET Framework 4.7, jika file tidak berisi kunci privat, kombinasi opsi -CryptoProvider dan -KeyContainer diperlukan.

Mulai dari versi .NET Framework 4.6.2, tanda Mage.exe bermanifestasi dengan CNG serta sertifikat CAPI.
-ch, -CertHash hashSignature Semua jenis file. Hash sertifikat digital yang disimpan di penyimpanan sertifikat pribadi komputer klien. Ini sesuai dengan string Thumbprint dari sertifikat digital yang ditampilkan di Konsol Sertifikat Windows.

hashSignature dapat berupa huruf besar atau huruf kecil, dan dapat disediakan baik sebagai string tunggal, atau dengan setiap oktet Thumbprint dipisahkan oleh spasi dan seluruh Thumbprint yang diapit tanda kutip.
-csp, -CryptoProvider provider-name Semua jenis file. Menentukan nama penyedia layanan kriptografi (CSP) yang berisi kontainer kunci privat. Opsi ini memerlukan opsi -KeyContainer.

Opsi ini tersedia mulai dari .NET Framework 4.7.
-fd, -FromDirectory directoryPath Manifes aplikasi. Mengisi manifes aplikasi dengan deskripsi semua rakitan dan file yang ditemukan di directoryPath, termasuk semua subdirektori, di mana directoryPath adalah direktori yang berisi aplikasi yang ingin Anda sebarkan. Untuk setiap file dalam direktori, Mage.exe memutuskan apakah file tersebut adalah file rakitan atau statis. Jika merupakan rakitan, ini menambahkan tag <dependency> dan atribut installFrom ke aplikasi dengan nama rakitan, basis kode, dan versi. Jika itu adalah file statis, ini menambahkan tag <file>. Mage.exe juga akan menggunakan serangkaian heuristik sederhana untuk mendeteksi executable utama untuk aplikasi, dan akan menandainya sebagai titik masuk aplikasi ClickOnce dalam manifes.

Mage.exe tidak akan pernah secara otomatis menandai file sebagai file "data". Anda harus melakukan ini secara manual. Untuk informasi selengkapnya, lihat Cara: Menyertakan File Data dalam Aplikasi ClickOnce.

Mage.exe juga menghasilkan hash untuk setiap file berdasarkan ukurannya. ClickOnce menggunakan hash ini untuk memastikan bahwa tidak ada yang mengubah file penyebaran sejak manifes dibuat. Jika salah satu file dalam penyebaran Anda berubah, Anda dapat menjalankan Mage.exe dengan perintah -Update dan opsi -FromDirectory, dan itu akan memperbarui hash dan versi perakitan dari semua file yang direferensikan.

-FromDirectory akan menyertakan semua file di semua subdirektori yang ditemukan dalam directoryPath.

Jika Anda menggunakan -FromDirectory dengan perintah -Update, Mage.exe akan menghapus semua file dalam manifes aplikasi yang tidak ada lagi di direktori.
-if, -IconFile filePath Manifes aplikasi. Menentukan jalur lengkap ke file ikon .ICO. Ikon ini muncul di samping nama aplikasi Anda di menu start, dan di entri Tambah-atau-Hapus Program. Jika tidak ada ikon yang disediakan, ikon default akan digunakan.
-ip, -IncludeProviderURL url benar Manifes penyebaran. Menunjukkan apakah manifes penyebaran menyertakan nilai lokasi pembaruan yang ditetapkan oleh -ProviderURL.
-i, -Install willInstall benar Manifes penyebaran. Menunjukkan apakah aplikasi ClickOnce harus diinstal ke komputer lokal atau tidak, atau harus dijalankan dari Web. Memasang aplikasi membuat aplikasi itu muncul di menu Start Windows. Nilai yang valid adalah "true" atau "t", dan "false" atau "f".

Jika Anda menentukan opsi -MinVersion, dan pengguna memiliki versi kurang dari -MinVersion yang terinstal, itu akan memaksa aplikasi untuk menginstal, terlepas dari nilai yang Anda berikan ke -Instal.

Opsi ini tidak dapat digunakan dengan opsi -BrowserHosted. Mencoba menentukan keduanya untuk manifes yang sama akan menimbulkan kesalahan.
-kc, -KeyContainer name Semua jenis file. Menentukan kontainer kunci yang berisi nama kunci privat. Opsi ini memerlukan opsi CryptoProvider.

Opsi ini tersedia mulai dari .NET Framework 4.7.
-mv, -MinVersion [version] Versi yang tercantum dalam manifes penyebaran ClickOnce sebagaimana ditentukan oleh bendera -Version. Manifes penyebaran. Pengguna dapat menjalankan versi minimum aplikasi ini. Bendera ini membuat versi aplikasi Anda yang sudah diberi nama menjadi pembaruan yang diperlukan. Jika Anda merilis versi produk Anda dengan pembaruan untuk perubahan yang melanggar atau kelemahan keamanan kritis, Anda dapat menggunakan tanda ini untuk menentukan bahwa pembaruan ini harus diinstal, dan bahwa pengguna tidak dapat terus menjalankan versi sebelumnya.

version memiliki semantik yang sama dengan argumen ke bendera -Version.
-n, -Nama nameString Sebarkan Semua jenis file. Nama yang digunakan untuk mengidentifikasi aplikasi. ClickOnce akan menggunakan nama ini untuk mengidentifikasi aplikasi di menu Start (jika aplikasi dikonfigurasi untuk menginstal sendiri) dan di kotak dialog Permission Elevation. Catatan: Jika Anda memperbarui manifes yang sudah ada dan tidak menentukan nama penerbit dengan opsi ini, Mage.exe memperbarui manifes dengan nama organisasi yang ditentukan di komputer. Untuk menggunakan nama yang berbeda, pastikan untuk menggunakan opsi ini dan tentukan nama penerbit yang diinginkan.
-pwd, -Password passwd Semua jenis file. Kata sandi yang digunakan untuk menandatangani manifes dengan sertifikat digital. Harus digunakan bersama dengan opsi -CertFile.
-p, Prosesor processorValue Msil Manifes aplikasi.

Manifes penyebaran.
Arsitektur mikroprosesor di mana distribusi ini akan berjalan. Nilai ini diperlukan jika Anda sedang mempersiapkan satu atau lebih instalasi yang rakitannya telah dikompilasi sebelumnya untuk mikroprosesor tertentu. Nilai yang valid meliputi msil, x86, ia64, dan amd64. msil adalah bahasa perantara Microsoft, yang berarti semua rakitan Anda independen platform, dan runtime bahasa umum (CLR) akan mengkompilasinya tepat waktu saat aplikasi Anda pertama kali dijalankan.
-pu, -ProviderURL url Manifes penyebaran. Menentukan URL yang akan diperiksa oleh ClickOnce untuk pembaruan aplikasi.
-pub, -Publisher publisherName Manifes aplikasi.

Manifes penyebaran.
Menambahkan nama penerbit ke elemen deskripsi penyebaran atau manifes aplikasi. Saat digunakan pada manifes aplikasi, -UseManifestForTrust juga harus ditentukan dengan nilai "true" atau "t"; jika tidak, parameter ini akan memunculkan kesalahan.
-s, -SupportURL url Manifes aplikasi.

Manifes penyebaran.
Menentukan tautan yang muncul di Tambah atau Hapus Program untuk aplikasi ClickOnce.
-ti, -TimestampUri uri Manifes aplikasi.

Manifes penyebaran.
URL layanan stempel waktu digital. Pemberian stempel waktu pada manifes mencegah Anda dari keharusan menandatangani ulang manifes jika sertifikat digital Anda kedaluwarsa sebelum Anda menyebarkan versi aplikasi berikutnya. Untuk informasi selengkapnya lihat Anggota program sertifikat akar Windows.
-t, -ToFile filePath - Baru:
- Penerapan: deploy.application
- Aplikasi: application.exe.manifest
- Memperbarui:
- Berkas masukan.
Semua jenis file. Menentukan jalur keluaran dari file yang telah dibuat atau dimodifikasi.

Jika -ToFile tidak disertakan saat Anda menggunakan -New, output ditulis ke direktori kerja saat ini. Jika -ToFile tidak disertakan saat Anda menggunakan -Update, Mage.exe akan menulis file kembali ke file input.
-tr, -TrustLevel level Berdasarkan zona tempat URL aplikasi berada. Manifes aplikasi. Tingkat kepercayaan untuk memberikan aplikasi pada komputer klien. Nilai termasuk "Internet", "Intranet", dan "FullTrust".
-um, -UseManifestForTrust willUseForTrust Salah Manifes aplikasi. Menentukan apakah tanda tangan digital dari manifes aplikasi akan digunakan untuk membuat keputusan kepercayaan saat aplikasi berjalan di klien. Menentukan "true" atau "t" menunjukkan bahwa manifes aplikasi akan digunakan untuk keputusan kepercayaan. Menentukan "false" atau "f" menunjukkan bahwa tanda tangan dari manifes penerapan akan digunakan.
-v, -Version versionNumber 1.0.0.0 Manifes aplikasi.

Manifes penyebaran.
Versi penyebaran. Argumen harus berupa string versi yang valid dengan format "N.N.N.N", dengan "N" adalah bilangan bulat 32-bit yang tidak ditandatangani.
-wpf, -WPFBrowserApp isWPFApp salah Manifes aplikasi.

Manifes penyebaran.
Gunakan bendera ini hanya jika aplikasi adalah aplikasi Windows Presentation Foundation (WPF) yang akan dihosting di dalam browser, dan bukan aplikasi yang dapat dieksekusi sendiri. Nilai yang valid adalah "true" atau "t", dan "false" atau "f".

Untuk manifes aplikasi, sisipkan atribut hostInBrowser di bawah elemen entryPoint dari manifes aplikasi.

Untuk manifes penyebaran, atur atribut install pada elemen deployment ke false, dan simpan manifes penyebaran dengan ekstensi .xbap. Menentukan argumen ini bersama dengan argumen -Install akan menyebabkan kesalahan, karena aplikasi yang dihosting browser tidak dapat menjadi aplikasi offline yang diinstal.

Tanda tangani opsi perintah

Tabel berikut menunjukkan opsi yang didukung oleh perintah -Sign, yang berlaku untuk semua jenis file.

Opsi Deskripsi
-cf, -CertFile filePath Menentukan Lokasi sertifikat digital untuk menandatangani manifes. Opsi ini dapat digunakan bersama dengan opsi -Kata Sandi jika sertifikat memerlukan kata sandi untuk berkas Pertukaran Informasi Pribadi (PFX). Mulai dari versi .NET Framework 4.7, jika file tidak berisi kunci privat, kombinasi opsi -CryptoProvider dan -KeyContainer diperlukan.

Mulai dari versi .NET Framework 4.6.2, tanda Mage.exe bermanifestasi dengan CNG serta sertifikat CAPI.
-ch, -CertHash hashSignature Hash sertifikat digital yang disimpan di penyimpanan sertifikat pribadi komputer klien. Ini terkait dengan properti Thumbprint dari sertifikat digital yang ditampilkan di Konsol Sertifikat Windows.

hashSignature dapat berupa huruf besar atau huruf kecil, dan dapat disediakan baik sebagai string tunggal, atau dengan setiap oktet Thumbprint dipisahkan oleh spasi dan seluruh Thumbprint yang diapit tanda kutip.
-csp, -CryptoProvider provider-name Menentukan nama penyedia layanan kriptografi (CSP) yang berisi kontainer kunci privat. Opsi ini memerlukan opsi -KeyContainer.

Opsi ini tersedia mulai dari .NET Framework 4.7.
-kc, -KeyContainer name Menentukan kontainer kunci yang berisi nama kunci privat. Opsi ini memerlukan opsi CryptoProvider.

Opsi ini tersedia mulai dari .NET Framework 4.7.
-pwd, -Password passwd Kata sandi yang digunakan untuk menandatangani manifes dengan sertifikat digital. Harus digunakan bersama dengan opsi -CertFile.
-t, -ToFile filePath Menentukan jalur keluaran dari file yang telah dibuat atau dimodifikasi.

Keterangan

Semua argumen untuk Mage.exe tidak peka huruf besar/kecil. Perintah dan opsi dapat diawali dengan tanda hubung (-) atau garis miring teruskan (/).

Semua argumen yang digunakan dengan perintah -Sign dapat digunakan kapan saja dengan perintah -New atau -Update. Perintah berikut setara.

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

Catatan

Mulai dari .NET Framework versi 4.6.2, sertifikat CNG juga didukung.

Penandatanganan adalah tugas terakhir yang harus Anda lakukan, karena dokumen yang ditandatangani menggunakan hash file untuk memverifikasi tanda tangan valid untuk dokumen tersebut. Jika Anda membuat perubahan apa pun pada file yang ditandatangani, Anda harus menandatanganinya lagi. Jika Anda menandatangani dokumen yang telah ditandatangani sebelumnya, Mage.exe akan mengganti tanda tangan lama dengan yang baru.

Saat Anda menggunakan opsi -AppManifest untuk mengisi manifes penyebaran, Mage.exe akan menganggap bahwa manifes aplikasi Anda akan berada di direktori yang sama dengan manifes penerapan dalam subdirektori yang dinamai menurut versi penyebaran saat ini, dan akan mengonfigurasi manifes penerapan Anda dengan tepat. Jika manifes aplikasi Anda akan berada di tempat lain, gunakan opsi -AppCodeBase untuk mengatur lokasi alternatif.

Penyebaran dan manifes aplikasi Anda harus ditandatangani sebelum Anda menyebarkan aplikasi. Untuk panduan tentang manifes penandatanganan, lihat Gambaran Umum Penyebaran Aplikasi Tepercaya.

Opsi -TrustLevel untuk manifes aplikasi menjelaskan serangkain izin yang diperlukan aplikasi untuk berjalan di komputer klien. Secara default, aplikasi ditetapkan tingkat kepercayaan berdasarkan zona tempat URL mereka. Aplikasi yang disebarkan melalui jaringan perusahaan umumnya ditempatkan di zona Intranet, sedangkan yang disebarkan melalui Internet ditempatkan di zona Internet. Kedua zona keamanan membatasi akses aplikasi ke sumber daya lokal, dengan zona Intranet sedikit lebih permisif daripada zona Internet. Zona FullTrust memberi aplikasi akses lengkap ke sumber daya lokal komputer. Jika Anda menggunakan opsi -TrustLevel untuk menempatkan aplikasi di zona ini, komponen Trust Manager dari CLR akan meminta pengguna untuk memutuskan apakah mereka ingin memberikan tingkat kepercayaan yang lebih tinggi. Jika Anda menyebarkan aplikasi Anda melalui jaringan perusahaan, Anda dapat menggunakan Penyebaran Aplikasi Tepercaya untuk meningkatkan tingkat kepercayaan aplikasi tanpa meminta pengguna.

Manifes aplikasi juga mendukung bagian kepercayaan khusus. Ini membantu aplikasi Anda mematuhi prinsip keamanan permintaan izin paling sedikit, karena Anda dapat mengonfigurasi manifes untuk hanya meminta izin khusus yang diperlukan aplikasi untuk dijalankan. Mage.exe tidak secara langsung mendukung penambahan bagian kepercayaan kustom. Anda dapat menambahkannya menggunakan editor teks, pengurai XML, atau alat grafik MageUI.exe. Untuk informasi selengkapnya tentang cara menggunakan MageUI.exe untuk menambahkan bagian kepercayaan khusus, lihat MageUI.exe (Alat Pengeditan dan Pembuatan Manifes, Klien Grafis).

Visual Studio 2017 menyertakan versi 4.6.1 Mage.exe. Manifes yang dibuat dengan versi Mage.exe ini menargetkan .NET Framework 4. Untuk menargetkan versi .NET Framework yang lebih lama, gunakan versi Mage.exe sebelumnya.

Saat Anda menambah atau menghapus rakitan dari manifes yang ada, atau menandatangani ulang manifes yang ada, Mage.exe tidak memperbarui manifes ke target .NET Framework 4.

Tabel berikut menunjukkan fitur dan batasan ini:

Versi manifes Operasi Mage v2.0 Mage v4.0
Manifes untuk aplikasi yang menargetkan versi 2.0 atau 3.x dari .NET Framework Buka OK OK
Tutup OK OK
Simpan OK OK
Tanda tangani ulang OK OK
Baru OK Tidak didukung
Perbarui (lihat di bawah) OK OK
Manifes untuk aplikasi yang menargetkan versi 4 .NET Framework Buka OK OK
Tutup OK OK
Simpan OK OK
Tanda tangani ulang OK OK
Baru Tidak didukung OK
Perbarui (lihat di bawah) Tidak didukung OK
Versi manifes Perbarui Detail Operasi Mage v2.0 Mage v4.0
Manifes untuk aplikasi yang menargetkan versi 2.0 atau 3.x dari .NET Framework Memodifikasi perakitan OK OK
Tambahkan perakitan OK OK
Hapus perakitan OK OK
Manifes untuk aplikasi yang menargetkan versi 4 .NET Framework Memodifikasi perakitan Tidak didukung OK
Tambahkan perakitan Tidak didukung OK
Hapus perakitan Tidak didukung OK

Mage.exe membuat manifes baru yang menargetkan Profil Klien .NET Framework 4. Aplikasi ClickOnce yang menargetkan Profil Klien .NET Framework 4 dapat berjalan di Profil Klien .NET Framework 4 dan versi lengkap .NET Framework 4. Jika aplikasi Anda menargetkan versi lengkap .NET Framework 4 dan tidak dapat berjalan di Profil Klien .NET Framework 4, hapus elemen <framework> klien dengan menggunakan editor teks dan tanda tangani ulang manifes.

Berikut ini adalah contoh elemen <framework> yang menargetkan Profil Klien .NET Framework 4:

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

Contoh

Contoh berikut membuka antarmuka pengguna untuk Mage (MageUI.exe).

mage

Contoh berikut membuat manifes penerapan dan manifes aplikasi default. Semua file ini dibuat di direktori kerja saat ini dan masing-masing dinamai deploy.application dan application.exe.manifest.

mage -New Deployment
mage -New Application

Contoh berikut membuat manifes aplikasi yang diisi dengan semua rakitan dan file sumber daya dari direktori saat ini.

mage -New Application -FromDirectory . -Version 1.0.0.0

Contoh berikut melanjutkan contoh sebelumnya dengan menentukan nama penyebaran dan mikroprosesor target. Itu juga menentukan URL yang harus diperiksa oleh ClickOnce untuk pembaruan.

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

Contoh berikut menunjukkan cara membuat sepasang manifes untuk menyebarkan aplikasi WPF yang akan dihosting di browser.

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

Contoh berikut membuat manifes aplikasi yang diisi dengan semua rakitan dan file sumber daya dari direktori dan tanda saat ini.

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

Contoh berikut memperbarui manifes penyebaran dengan informasi dari manifes aplikasi, dan mengatur basis kode untuk lokasi manifes aplikasi.

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

Contoh berikut mengedit manifes penyebaran untuk memaksa pembaruan versi yang diinstal pengguna.

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

Contoh berikut memberi tahu manifes penyebaran untuk mengambil manifes aplikasi dari direktori lain.

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

Contoh berikut menandatangani manifes penyebaran yang ada menggunakan sertifikat digital di direktori kerja saat ini.

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

Contoh berikut menandatangani manifes penyebaran yang ada menggunakan sertifikat digital dan kunci privat di direktori kerja saat ini.

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

Lihat juga