Yardım İçerik Yöneticisi için komut satırı bağımsız değişkenleri
Yardım İçerik Yöneticisi (HlpCtntMgr.exe) için komut satırı bağımsız değişkenlerini kullanarak yerel Yardım içeriğinin nasıl dağıtılacağını ve yönetileceğini belirtebilirsiniz. Bu komut satırı aracı için yönetici izinlerine sahip betikler çalıştırmanız gerekir ve bu betikleri hizmet olarak çalıştıramazsınız. Bu aracı kullanarak aşağıdaki görevleri gerçekleştirebilirsiniz:
Diskten veya buluttan yerel Yardım içeriği ekleyin veya güncelleştirin.
Yerel Yardım içeriğini kaldırın.
Yerel Yardım içerik depoyu taşıyın.
Yerel Yardım içeriğini sessizce ekleyin, güncelleştirin, kaldırın veya taşıyın.
Söz dizimi:
HlpCtntmgr.exe /operation Value /catalogname CatalogName /locale Locale /sourceuri InstallationPoint
Örneğin:
hlpctntmgr.exe /operation install /catalogname VisualStudio15 /locale en-us /sourceuri d:\productDocumentation\HelpContentSetup.msha
Not
Katalog adı, hem Visual Studio 2017 hem de Visual Studio 2019 için VisualStudio15'tir. Bunun nedeni, her iki Visual Studio sürümü için de aynı Yardım Görüntüleyicisi'nin kullanılması olabilir.
Anahtarlar ve bağımsız değişkenler
Aşağıdaki tablo, Yardım İçerik Yöneticisi için komut satırı aracı için kullanabileceğiniz anahtarları ve bağımsız değişkenleri tanımlar:
Switch | Gerekli mi? | Bağımsız değişkenler |
---|---|---|
/Işlem | Yes | - Yükle--Belirtilen yükleme kaynağındaki kitapları yerel içerik deposuna ekler. Bu anahtar için /booklist bağımsız değişkeni, /sourceURI bağımsız değişkeni veya her ikisi gerekir. /sourceURI bağımsız değişkenini belirtmezseniz, yükleme kaynağı olarak varsayılan Visual Studio URI'sini kullanırsınız. /booklist bağımsız değişkenini belirtmezseniz, /sourceUri üzerindeki tüm kitaplar yüklenir. - Kaldır--Belirttiğiniz kitapları yerel içerik deposundan kaldırır. Bu anahtar için /booklist bağımsız değişkeni veya /sourceURI bağımsız değişkeni gerekir. /sourceURI bağımsız değişkenini belirtirseniz, tüm kitaplar kaldırılır ve /booklist bağımsız değişkeni yoksayılır. - Taşı--Yerel depoyu belirttiğiniz yola taşır. Varsayılan yerel depolama yolu %ProgramData% altında bir dizin olarak ayarlanır Bu anahtar için /locationPath ve /catalogName bağımsız değişkenleri gerekir. Geçerli olmayan bir yol belirtirseniz veya sürücü içeriği tutmak için yeterli boş alan içermiyorsa hata iletileri olay günlüğüne kaydedilir. - Yenile--Güncelleştirmeler yüklendikten veya en son güncelleştirildiklerinden bu yana değişen konular. Bu anahtar için /sourceURI bağımsız değişkeni gerekir. |
/Catalogname | Yes | İçerik kataloğunun adını belirtir. Visual Studio 2017 ve Visual Studio 2019 için bu, VisualStudio15'tir. |
/Yerel ayar | Hayır | Yardım görüntüleyicisinin geçerli örneğinin içeriğini görüntülemek ve yönetmek için kullanılan ürün yerel ayarını belirtir. Örneğin, İngilizce-Birleşik Devletler için belirtirsinizEN-US .Yerel ayar belirtmezseniz, işletim sisteminin yerel ayarı kullanılır. Bu yerel ayar belirlenemezse kullanılır EN-US .Geçerli olmayan bir yerel ayar belirtirseniz, olay günlüğüne bir hata iletisi kaydedilir. |
/e | Hayır | Geçerli kullanıcının yönetici kimlik bilgileri varsa, Yardım İçerik Yöneticisi'ni Yönetici istrative ayrıcalıklara yükseltir. |
/Sourceuri | Hayır | İçeriğin yüklendiği URL'yi (Hizmet API'si) veya içerik yükleme dosyasının (.msha) yolunu belirtir. URL, Visual Studio 2010 stil uç noktasında Ürün Grubu'na (en üst düzey düğüm) veya Ürün Kitapları'na (yaprak düzeyi düğüm) işaret edebilir. URL'nin sonuna eğik çizgi (/) eklemeniz gerekmez. Sondaki eğik çizgiyi eklerseniz, uygun şekilde işlenir. Bulunmayan, geçerli olmayan veya erişilebilir olmayan bir dosya belirtirseniz ya da içerik yönetilirken İnternet bağlantısı yoksa veya kesintiye uğrarsa, olay günlüğüne bir hata iletisi kaydedilir. |
/Satıcı | Hayır | Kaldırılacak ürün içeriğinin satıcısını belirtir (örneğin, Microsoft ). Bu anahtarın varsayılan bağımsız değişkeni Microsoft'tır. |
/Productname | Hayır | Kaldırılacak kitapların ürün adını belirtir. Ürün adı, içerikle birlikte gönderilen helpcontentsetup.msha veya books.html dosyalarında tanımlanır. Aynı anda yalnızca bir üründen kitap kaldırabilirsiniz. Birden çok üründen kitap kaldırmak için birden çok yükleme yapmanız gerekir. |
/booklist | Hayır | Yönetilecek kitapların adlarını boşluklarla ayırarak belirtir. Değerler, yükleme medyası üzerinde listelenen kitap adlarıyla eşleşmelidir. Bu bağımsız değişkeni belirtmezseniz, /sourceURI'de belirtilen ürün için önerilen tüm kitaplar yüklenir. Bir kitabın adı bir veya daha fazla boşluk içeriyorsa, listenin uygun şekilde sınırlandırılmış olması için onu çift tırnak (") ile çevreleyin. Geçerli olmayan veya ulaşılamayan bir /sourceURI belirtirseniz hata iletileri günlüğe kaydedilir. |
/skuId | Hayır | Yükleme kaynağından ürünün stok tutma birimini (SKU) belirtir ve /SourceURI anahtarının tanımladıkları kitapları filtreler. |
/Üyelik | Hayır | - Minimum-- /skuId anahtarını kullanarak belirttiğiniz SKU'ya göre en düşük Yardım içeriği kümesini yükler. SKU ile içerik kümesi arasındaki eşleme, Hizmet API'sinde kullanıma sunulur. - Önerilen—/skuId bağımsız değişkenini kullanarak belirttiğiniz SKU için bir dizi önerilen kitap yükler. Yükleme kaynağı hizmet API'si veya 'dir. MSHA. - Tam-- /skuId bağımsız değişkenini kullanarak belirttiğiniz SKU için tüm kitap kümesini yükler. Yükleme kaynağı hizmet API'si veya 'dir. MSHA. |
/locationpath | Hayır | Yerel Yardım içeriği için varsayılan klasörü belirtir. Bu anahtarı yalnızca içeriği yüklemek veya taşımak için kullanmanız gerekir. Bu anahtarı belirtirseniz /silent anahtarını da belirtmeniz gerekir. |
/silent | Hayır | Kullanıcıya sormadan veya durum bildirim alanındaki simge de dahil olmak üzere herhangi bir kullanıcı arabirimi görüntülemeden Yardım içeriğini yükler veya kaldırır. Çıkış , %Temp% dizinindeki bir dosyaya günlüğe kaydedilir. Önemli: İçeriği sessizce yüklemek için .mshc dosyalarını değil dijital olarak imzalanan .cab dosyalarını kullanmanız gerekir. |
/launchingApp | Hayır | Yardım görüntüleyicisi üst uygulama olmadan başlatıldığında uygulama ve katalog bağlamını tanımlar. Bu anahtarın bağımsız değişkenleri CompanyName, ProductName ve VersionNumber 'dır (örneğin, /launchingApp Microsoft,VisualStudio,16.0 ).Bu, /silent parametresiyle içerik yüklemek için gereklidir. |
/wait Saniye | Hayır | Yükleme, kaldırma ve yenileme işlemlerini duraklatır. Katalog için bir işlem zaten sürüyorsa, işlem devam etmek için verilen saniye sayısına kadar bekler. Süresiz olarak beklemek için 0 kullanın. |
/? | Hayır | Yardım İçerik Yöneticisi için komut satırı aracının anahtarlarını ve açıklamalarını listeler. |
Çıkış kodları
Yardım İçerik Yöneticisi için komut satırı aracını sessiz modda çalıştırdığınızda, aşağıdaki çıkış kodlarını döndürür:
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.)