Argumen baris perintah untuk Manajer Konten Bantuan
Anda dapat menentukan cara menyebarkan dan mengelola konten Bantuan lokal dengan menggunakan argumen baris perintah untuk Manajer Konten Bantuan (HlpCtntMgr.exe). Anda harus menjalankan skrip untuk alat baris perintah ini dengan izin administrator, dan Anda tidak dapat menjalankan skrip ini sebagai layanan. Anda dapat melakukan tugas-tugas berikut menggunakan alat ini:
Menambahkan atau memperbarui konten Bantuan lokal dari disk atau cloud.
Menghapus konten Bantuan lokal.
Memindahkan penyimpanan konten Bantuan lokal.
Menambah, memperbarui, menghapus, atau memindahkan konten Bantuan lokal secara diam-diam.
Sintaks:
HlpCtntmgr.exe /operation Value /catalogname CatalogName /locale Locale /sourceuri InstallationPoint
Contoh:
hlpctntmgr.exe /operation install /catalogname VisualStudio15 /locale en-us /sourceuri d:\productDocumentation\HelpContentSetup.msha
Catatan
Nama katalognya adalah VisualStudio15 untuk Visual Studio 2017 dan Visual Studio 2019. Ini mungkin tidak terduga, tetapi ini karena Penampil Bantuan yang sama digunakan untuk kedua versi Visual Studio.
Switch dan argumen
Tabel berikut menentukan switch dan argumen yang dapat Anda gunakan untuk alat baris perintah untuk Manajer Konten Bantuan:
| Mengalihkan | Wajib diisi? | Argumen |
|---|---|---|
| /operation | Ya | - Instal--Menambahkan buku dari sumber penginstalan yang ditentukan ke penyimpanan konten lokal. Switch ini memerlukan argumen /booklist, argumen /sourceURI, atau keduanya. Jika Anda tidak menentukan argumen /sourceURI, URI Visual Studio default digunakan sebagai sumber penginstalan. Jika Anda tidak menentukan argumen /booklist, semua buku di /sourceUri akan diinstal. - Hapus instalan--Menghapus buku yang Anda tentukan dari penyimpanan konten lokal. Switch ini memerlukan argumen /booklist atau argumen /sourceURI. Jika Anda menentukan argumen /sourceURI, semua buku dihapus, dan argumen /booklist diabaikan. - Pindahkan--Memindahkan penyimpanan lokal ke jalur yang Anda tentukan. Jalur penyimpanan lokal default diatur sebagai direktori di bagian %ProgramData% Switch ini membutuhkan argumen /locationPath dan /catalogName. Pesan kesalahan akan dicatat dalam log peristiwa jika Anda menentukan jalur yang tidak valid atau jika drive tidak berisi cukup ruang kosong untuk menyimpan konten. - Refresh--Memperbarui topik yang telah berubah sejak diinstal atau yang paling baru diperbarui. Switch ini membutuhkan argumen /sourceURI. |
| /catalogName | Ya | Menentukan nama katalog konten. Untuk Visual Studio 2017 dan Visual Studio 2019, ini adalah VisualStudio15. |
| /locale | No | Menentukan lokal produk yang digunakan untuk melihat dan mengelola konten untuk instans saat ini dari penampil Bantuan. Misalnya, Anda menentukan EN-US untuk bahasa Inggris-Amerika Serikat.Jika Anda tidak menentukan lokal, lokal sistem operasi akan digunakan. Jika lokal tersebut tidak dapat ditentukan, EN-US digunakan.Jika Anda menentukan lokal yang tidak valid, pesan kesalahan akan dicatat di log peristiwa. |
| /e | No | Meningkatkan Manajer Konten Bantuan ke hak istimewa Administratif jika pengguna saat ini memiliki mandat administratif. |
| /sourceURI | No | Menentukan URL tempat konten diinstal (API Layanan) atau jalur ke file penginstalan konten (.msha). URL dapat mengarah ke Grup Produk (simpul tingkat atas) atau ke Buku Produk (node tingkat leaf) di titik akhir gaya Visual Studio 2010. Anda tidak perlu menyertakan garis miring (/) di akhir URL. Jika Anda menyertakan garis miring, itu akan ditangani dengan tepat. Pesan kesalahan dicatat di log peristiwa jika Anda menentukan file yang tidak ditemukan, tidak valid, atau tidak dapat diakses atau jika koneksi ke internet tidak tersedia atau terputus saat konten sedang dikelola. |
| /vendor | No | Menentukan vendor untuk konten produk yang akan dihapus (misalnya, Microsoft). Argumen default untuk switch ini adalah Microsoft. |
| /productName | No | Menentukan nama produk untuk buku yang akan dihapus. Nama produk diidentifikasi dalam file helpcontentsetup.msha atau books.html yang dikirimkan bersama konten. Anda dapat menghapus buku hanya dari satu produk dalam satu waktu. Untuk menghapus buku dari beberapa produk, Anda harus melakukan beberapa penginstalan. |
| /booklist | No | Menentukan nama-nama buku yang akan dikelola, dipisahkan dengan spasi. Nilai harus sesuai dengan nama buku seperti yang tercantum pada media penginstalan. Jika Anda tidak menentukan argumen ini, semua buku yang direkomendasikan untuk produk yang ditentukan di /sourceURI akan diinstal. Jika nama buku berisi satu spasi atau lebih, beri tanda kutip ganda (") agar daftar dibatasi dengan tepat. Pesan kesalahan akan dicatat jika Anda menentukan /sourceURI yang tidak valid atau tidak dapat dijangkau. |
| /skuId | No | Menentukan unit penyimpanan stok (SKU) produk dari sumber penginstalan, dan memfilter buku yang diidentifikasi oleh switch /SourceURI. |
| /membership | No | - Minimum-- Menginstal kumpulan konten Bantuan minimum berdasarkan SKU yang Anda tentukan menggunakan switch /skuId. Pemetaan antara SKU dan kumpulan konten diekspos di API Layanan. - Direkomendasikan—Menginstal kumpulan buku yang direkomendasikan untuk SKU yang Anda tentukan menggunakan argumen /skuId. Sumber Penginstalan adalah API layanan atau . MSHA. - Penuh—Menginstal seluruh kumpulan buku untuk SKU yang Anda tentukan dengan menggunakan argumen /skuId. Sumber Penginstalan adalah API layanan atau . MSHA. |
| /locationpath | No | Menentukan folder default untuk konten Bantuan lokal. Anda harus menggunakan switch ini hanya untuk menginstal atau memindahkan konten. Jika Anda menentukan switch ini, Anda juga harus menentukan switch /silent. |
| /silent | No | Menginstal atau menghapus konten Bantuan tanpa meminta pengguna atau menampilkan antarmuka pengguna apa pun, termasuk ikon di area notifikasi status. Output dicatat ke file di direktori %Temp %. Penting: Untuk menginstal konten secara diam-diam, Anda harus menggunakan file .cab yang ditandatangani secara digital, bukan file .mshc. |
| /launchingApp | No | Menentukan konteks aplikasi dan katalog saat penampil Bantuan diluncurkan tanpa aplikasi induk. Argumen untuk switch ini adalah CompanyName, ProductName, dan VersionNumber (misalnya, /launchingApp Microsoft,VisualStudio,16.0).Ini diperlukan untuk menginstal konten dengan parameter /silent. |
| /wait Detik | No | Menjeda operasi penginstalan, penghapusan instalan, dan refresh. Jika operasi sudah berlangsung untuk katalog, proses akan menunggu hingga beberapa detik untuk melanjutkan. Gunakan 0 untuk menunggu tanpa batas. |
| /? | No | Mencantumkan switch dan deskripsinya untuk alat baris perintah untuk Manajer Konten Bantuan. |
Kode keluar
Saat Anda menjalankan alat baris perintah untuk Manajer Konten Bantuan dalam mode senyap, ini mengembalikan kode keluar berikut ini:
Success = 0,
FailureToElevate = 100
InvalidCmdArgs = 101,
FailOnFetchingOnlineContent = 110,
FailOnFetchingContentFromDisk = 120,
FailOnFetchingInstalledBooks = 130,
NoBooksToUninstall = 200,
NoBooksToInstall = 300,
FailOnUninstall = 400,
FailOnInstall = 500,
FailOnMove = 600,
FailOnUpdate = 700,
FailOnRefresh = 800,
Cancelled = 900,
Others = 999,
ContentManagementDisabled = 1200,
OnlineHelpPreferenceDisabled = 1201
UpdateAlreadyRunning = 1300 - (Signals that the update didn't run because another was in progress.)