SQL Server Management Studio'yu yüklemek için komut satırı parametrelerini kullanma

Şunlar için geçerlidir:SQL ServerAzure SQL VeritabanıAzure SQL Yönetilen ÖrneğiAzure Synapse Analytics

SQL Server Management Studio 22, SQL Server örneklerini, Azure SQL veritabanlarını ve Azure SQL yönetilen örneklerini yönetmek için güçlü bir araçtır. Bu makalede, SQL Server Management Studio 22'yi yüklemek için komut satırı parametrelerinin nasıl kullanılacağına ilişkin ayrıntılı yönergeler ve daha özelleştirilmiş ve otomatik bir yükleme işlemi sağlanır. SQL Server Management Studio 22'yi ilk kez yüklerken veya mevcut bir yüklemeyi güncelleştirirken, bu yönergeler hedeflerinize ulaşmak için gerekli adımları sağlar.

Komut satırı parametreleri

SQL Server Management Studio'yu (SSMS) program aracılığıyla veya komut isteminden yüklediğinizde, aşağıdaki eylemleri gerçekleştirmek üzere yüklemeyi denetlemek veya özelleştirmek için çeşitli komut satırı parametreleri kullanabilirsiniz:

• Belirli seçenekler ve davranışlar önceden seçilmiş olarak istemcide yüklemeyi başlatın.
• Yükleme veya güncelleştirme işlemini otomatikleştirin.
• İstemci makinelerini yüklemek veya güncelleştirmek için ürün dosyalarının ağ düzenini oluşturun veya koruyun.

Aşağıdaki komut satırı fiilleri ve parametreleri aşağıdaki yürütülebilir dosya veya programlarla kullanılabilir:

• İndirme sürecini ve başlangıç kurulumunu başlatan küçük (yaklaşık 5 MB) dosya olan kurulum başlatıcısı, örneğin vs_SSMS.exe.
• Makinede zaten yüklü olabilecek ve klasöründe C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exebulunan Visual Studio yükleyicisi. Yükleyiciyi, yükleyicinin bulunduğu farklı bir dizinden program aracılığıyla başlatmanız gerekir. Yükleyici genellikle güncelleştirme veya değiştirme komutları için kullanılır.

Tüm komutlar veya parametreler bu durumların her birinde çalışmaz ve özel uyarılar veya istisnalar belgelenmiştir. Ayrıca, bazı senaryolarda daha önce açıklanan bu yürütülebilir dosyalara erişiminiz olmayabilir. Örneğin, istemci makinelerinde yükleyici yalnızca SSMS bir düzen aracılığıyla yüklendiyse programlı yürütme için kullanılabilir olabilir.

SQL Server Management Studio 22'de her zaman seçili kanalın en son sürümünü yükleyen en son önyükleyicileri almak için aşağıdaki tabloda yer alan dosyalardan birini indirin. Alternatif olarak, SQL Server Management Studio 22'nin belirli bir sürümünü veya belirli bir kanalını yüklemek için bkz. SQL Server Management Studio sürüm geçmişi. Bu makalede, her bakım sürümü için sabit sürüm önyükleyicilerinin bağlantıları bulunur.

Kanal	Sürüm	Önyükleyici
Salıverme	22.1.0	SQL Server Management Studio

Tavsiye

Daha önce bir önyükleyici dosyası indirdiyseniz, yüklemeyi denemeden önce sürümü doğrulayabilirsiniz. Dosya Gezgini'ni açın, önyükleyici dosyasına sağ tıklayın, Özellikler'i ve ardından Ayrıntılar sekmesini seçin. Ürün sürümü alanında önyükleyicinin yüklediği kanal ve sürüm açıklanır. Sürüm numarası daima "belirtilen öğenin en son hizmet sürümü" olarak okunmalı ve aksi belirtilmedikçe kanal olarak Varsayılan Yayın kullanılır. SQL Server Management Studio 22 yazan bir ürün sürümüne sahip önyükleyici, YAYıN kanalından SQL Server Management Studio 22'nin en son sürümünü yükler.

Komutları ve komut satırı parametrelerini yükleme, güncelleştirme, değiştirme, onarma, kaldırma ve dışarı aktarma

SSMS önyükleyicisi veya yükleyici program aracılığıyla çağrıldığında, ürünü yüklemek veya düzeni korumak için:

• İlk parametre, gerçekleştirilecek işlemi açıklayan komutudur (fiil).
• İki tire (--) ile başlayan tüm isteğe bağlı komut satırı parametreleri, bu işlemin nasıl gerçekleşmesi gerektiğini daha ayrıntılı olarak tanımlar.

Tüm SSMS komut satırı parametreleri büyük/küçük harfe duyarlı değildir.

Söz dizimi örneği: vs_SSMS.exe [command] <optional parameters>...

Komut	Açıklama
(boş)	Varsayılan komut hem ürünü yükler hem de tüm düzen bakım işlemleri için kullanılır.
modify	Yüklü bir ürünü değiştirir.
update	Yüklü bir ürünü güncelleştirir.
updateall	Yüklü tüm ürünleri sıralı olarak güncelleştirir. --quiet ve --passive parametreleriyle çalışır.
repair	Yüklü bir ürünü onarıyor.
uninstall	Yüklü bir ürünü kaldırır.
export	Yükleme yapılandırmasını bir *.vsconfig dosyaya aktarır.

Önemli

Birden çok farklı iş yükü, bileşen veya dil belirtirken, her öğe için --add veya --remove komut satırı anahtarını yinelemeniz gerekir.

Parametreler	Açıklama
--installPath <dir>	Varsayılan yükleme komutu için bu parametre İsteğe bağlıdır ve örneğin istemci makinesinde nereye yüklendiğini açıklar. Güncelleştirme veya değiştirme gibi diğer komutlar için bu parametre Gerekli'dir ve örneğin üzerinde işlem görmesi için yükleme dizinini belirtir.
--productId <id>	İsteğe bağlı: değiştirilen ve ile --channelIdkullanılan ürün örneğinin kimliği. productId şeklindedirMicrosoft.VisualStudio.Product.SSMS.
--channelUri	İsteğe bağlı: Güncelleştirme komutu sırasında, güncelleştirme ayarları konumunu değiştirmek için yeni --channelUri bir ileti iletebilirsiniz. Hangi SSMS örneğini yapılandırdığınızın açıkça belirtilmesi için parametresiyle --installPath eşleştirmenizi öneririz. Bkz. söz dizimi örnekleri --channelUri
--channelId <id>	Kanalın kimliği, örneğin, SSMS.22.SSMS.Release. channelId değiştirme işlemleri için, --productId veya --installPath yanında gereklidir.
--add <one or more workload or component IDs>	İsteğe bağlı: Yükleme veya değiştirme komutu sırasında, bu yinelenebilir parametre eklenecek bir veya daha fazla iş yükü veya bileşen kimliği belirtir. Yapıtın gerekli bileşenleri yüklenir, ancak önerilen veya isteğe bağlı bileşenler yüklenmez. --includeRecommended ve/veya --includeOptional parametrelerini kullanarak diğer bileşenleri genel olarak denetleyebilirsiniz. Birden çok iş yükü veya bileşen eklemek için komutunu yineleyin --add (örneğin, --add Workload1 --add Workload2). Daha ayrıntılı denetim için, kimliğin sonuna ;includeRecommended veya ;includeOptional ekleyebilirsiniz (örneğin, --add Workload1;includeRecommended veya --add Workload2;includeRecommended;includeOptional).
--all	İsteğe bağlı: Yükleme veya değiştirme komutu sırasında bu parametre, ürünün tüm iş yüklerinin ve bileşenlerinin yüklenmesine neden olur.
--allWorkloads	İsteğe bağlı: Yükleme veya değiştirme komutu sırasında bu parametre tüm iş yüklerini ve bileşenleri yükler, ancak önerilen veya isteğe bağlı bileşen yoktur.
--includeRecommended	İsteğe bağlı: Yükleme veya değiştirme komutu sırasında, bu parametre yüklü tüm iş yükleri için önerilen bileşenleri içerir. İsteğe bağlı bileşenleri içermez. İş yükleri, ya --allWorkloads ya da --add ile belirtilir. parametresini --includeRecommended kullanarak , "güncelleştirmede yüklü iş yükleri için önerilen bileşenleri eklemek" için Güncelleştirme Ayarları iletişim kutunuzu etkinleştirirsiniz. Bu ayarları değiştirmek için bkz. Güncelleştirme ayarlarını özelleştirme.
--includeOptional	İsteğe bağlı: Yükleme veya değiştirme komutu sırasında, bu parametre yüklü tüm iş yükleri için isteğe bağlı bileşenleri içerir. Önerilen bileşenleri içermez. İş yükleri, ya --allWorkloads ya da --add ile belirtilir.
--addProductLang <language-locale>	İsteğe bağlı: Yükleme veya değiştirme komutu sırasında bu yinelenebilir parametre, ürünle birlikte yüklenmesi gereken kullanıcı arabirimi dil paketlerini belirtir. Yoksa, kurulum, bilgisayarın yerel ayarına karşılık gelen dil paketini kullanır. Daha fazla bilgi için bkz. [Dil yerel ayarları listesi]
--remove <one or more workload or component IDs>	İsteğe bağlı: Değiştirme komutu sırasında, bu yinelenebilir parametre kaldırılacak bir veya daha fazla iş yükü veya bileşen kimliği belirtir. --add parametresini tamamlar ve ona benzer şekilde davranır.
--addProductLang <language-locale>	İsteğe bağlı: Yükleme veya değiştirme komutu sırasında bu yinelenebilir parametre, ürünle birlikte yüklenmesi gereken kullanıcı arabirimi dil paketlerini belirtir. Yoksa, kurulum, bilgisayarın yerel ayarına karşılık gelen dil paketini kullanır. Daha fazla bilgi için bu makalenin Dil yerel ayarları listesi bölümüne bakın.
--removeProductLang <language-locale>	İsteğe bağlı: Yükleme veya değiştirme komutu sırasında bu yinelenebilir parametre, üründen kaldırılması gereken kullanıcı arabirimi dil paketlerini belirler. --addProductLang parametresini tamamlar ve ona benzer şekilde davranır.
--in <path>	İsteğe bağlı: Yapılandırma ayarlarını içerebilen URI veya yanıt dosyasının yolu.
--quiet	İsteğe bağlı: Bu parametre, herhangi bir komutla kullanıldığında, komut yürütülürken herhangi bir kullanıcı arabiriminin görüntülenmesini engeller. AllowStandardUserControl ilkesinin nasıl ayarlandığından bağımsız olarak standart kullanıcıların programatik olarak kullanılamaz.
--passive, -p	İsteğe bağlı: Bu parametre, kullanıcı arabiriminin etkileşimli olmayan bir şekilde görüntülenmesine neden olur. Bu parametre, --quiet parametresi ile karşılıklı olarak birbirini dışlar (ve aslında onu geçersiz kılar). Ayrıca AllowStandardUserControl ilkesinin nasıl ayarlandıklarından bağımsız olarak standart kullanıcılar tarafından program aracılığıyla kullanılamaz.
--norestart	İsteğe bağlı: Bu parametre veya --passive parametreleriyle --quiet eşlenmelidir. Yükleme, güncelleştirme veya değiştirme komutu sırasında parametresinin --norestart eklenmesi gerekli tüm yeniden başlatmaları geciktirmektedir.
--force	İsteğe bağlı: Bu parametre, herhangi bir SSMS işlemi kullanılıyor olsa bile SSMS'yi kapanmaya zorlar. SSMS'yi kapanmaya zorlamak iş kaybına neden olabilir, bu nedenle dikkatli kullanın.
--installWhileDownloading	İsteğe bağlı: Yükleme, güncelleştirme veya değiştirme komutu sırasında. Bu parametre SSMS'nin ürünü paralel olarak indirmesine ve yüklemesine olanak tanır. Bu varsayılan deneyimdir.
--downloadThenInstall	İsteğe bağlı: Yükleme, güncelleştirme veya değiştirme komutu sırasında, bu parametre SSMS'yi yüklemeden önce tüm dosyaları indirmeye zorlar. --installWhileDownloading parametresiyle karşılıklı olarak dışlanır.
--nickname <name>	İsteğe bağlı: Yükleme komutu sırasında, bu parametre yüklü bir ürüne atanacak takma adı tanımlar. Takma ad 10 karakterden uzun olamaz.
--removeOos true	İsteğe bağlı: Yükleme, güncelleştirme veya değiştirme komutu sırasında, bu parametre ve ardından true veya falsekomutu, Visual Studio Yükleyicisi destek dışı duruma geçirilmiş tüm yüklü bileşenlerin kaldırılıp kaldırılmayacağını bildirir. Bu davranış tek bir olay için geçerlidir. Bu davranışı kalıcı hale getirmek istiyorsanız, bu parametreyi modifySettings daha sonra açıklanan komuta uygulayın veya genel ilkeyi removeOOS yapılandırın. Makinenin güvenli kalmasına yardımcı olmak için kullanışlıdır.
--config <path to *.vsconfig file>	İsteğe bağlı: Yükleme veya değiştirme işlemi sırasında, önceden kaydedilmiş bir yükleme yapılandırma dosyasına göre eklenecek iş yüklerini, bileşenleri veya uzantıları belirtmek için parametresini kullanarak --config bir yapılandırma dosyası geçirebilirsiniz. Bu işlem yalnızca ek bir işlemdir; dosyada belirtilmeyen hiçbir şeyi kaldırmaz. Ayrıca, yapılandırma dosyasında belirtilen ve ürün için geçerli olmayan öğeler eklenmez. Yapılandırma dosyasının tam yolunu belirtmeniz kesinlikle önerilir. Dışarı aktarma işlemi sırasında bu parametre yükleme yapılandırma dosyasının kaydedileceği konumu belirler.
--allowUnsignedExtensions	İsteğe bağlı: Yükleme veya değiştirme işlemi sırasında dosya kullanılarak --passive veya --quiet bağlamında çalıştırılırken--config, yapılandırma dosyasında uzantılar belirtilirse, uzantıları dijital imza olmadan yüklemek için bu parametre gereklidir.
--installerOnly	İsteğe bağlı: Yükleme veya güncelleştirme işlemi sırasında bu parametre Visual Studio Yükleyicisi'ne SSMS ürününü değil yalnızca kendisini (yükleyici) yüklemesini söyler. İşlevselliği parametresine --update eşdeğerdir, ancak daha sezgiseldir. İstemci makinelerini hazırlarken ve önceden yapılandırırken kullanılması amaçlanmalıdır.
--help, --?, -h, -?	Bu makalenin çevrimdışı sürümünü görüntüler.

Düzen komutu ve komut satırı parametreleri

Düzen oluşturma veya güncelleştirme gibi tüm düzen yönetimi işlemleri önyükleyici exe kullanılarak çalıştırılır ve komutun varsayılan Yükleme (boş) olduğunu varsayar. Tüm düzen yönetimi işlemleri gerekli --layout ilk parametreyle başlamalıdır. Aşağıdaki tabloda, komut satırını kullanarak düzen oluşturmak veya güncelleştirmek için kullanabileceğiniz diğer parametreler açıklanmaktadır.

Düzen parametreleri	Açıklama
--layout <dir>	Çevrimdışı yükleme önbelleği oluşturulacak veya güncelleştirilecek bir dizin belirtir.
--lang <one or more language-locales>	İsteğe bağlı: Belirtilen bir veya daha fazla belirtilen dile sahip kaynak paketleriyle çevrimdışı yükleme önbelleği hazırlamak için ile --layout kullanılır. Daha fazla bilgi için bu makalenin Dil yerel ayarları listesi bölümüne bakın.
--add <one or more workload or component IDs>	İsteğe bağlı: Eklenecek bir veya daha fazla iş yükü veya bileşen kimlikleri. Yapıtın gerekli bileşenleri yüklenir, ancak önerilen veya isteğe bağlı bileşenler yüklenmez. --includeRecommended ve/veya --includeOptional kullanarak genel olarak daha fazla bileşeni kontrol edebilirsiniz. Daha ayrıntılı denetim için, kimliğin sonuna ;includeRecommended veya ;includeOptional ekleyebilirsiniz (örneğin, --add Workload1;includeRecommended veya --add Workload2;includeOptional). Not: Kullanılırsa --add , yalnızca belirtilen iş yükleri ve bileşenleri ve bağımlılıkları indirilir. Belirtilmezse --add , tüm iş yükleri ve bileşenler düzene indirilir.
--includeRecommended	İsteğe bağlı: Yüklenen tüm iş yükleri için önerilen bileşenleri içerir, ancak isteğe bağlı bileşenleri içermez. İş yükleri, ya --allWorkloads ya da --add ile belirtilir.
--includeOptional	İsteğe bağlı: Düzene dahil edilen tüm iş yükleri için önerilen ve isteğe bağlı bileşenleri içerir. İş yükleri --add ile belirtilmiştir.
--wait	İsteğe bağlı: İşlem, bir çıkış kodu döndürmeden önce yükleme tamamlanana kadar bekler. wait yüklemelerini otomatikleştirirken, yüklemenin tamamlanmasını beklemek ve dönüş kodunu işlemek gerektiğinde kullanışlıdır. --wait Parametre yalnızca önyükleyiciye geçirilebilir; yükleyici (setup.exe) bunu desteklemez. Düzenleri güncelleştirirken kullanışlıdır.
--config <path to *.vsconfig file>	İsteğe bağlı: Varsa, SSMS düzeninizi yapılandırmak için yapılandırma dosyasının içeriğini kullanır. Yapılandırma dosyasının tam yolunu belirttiğinizden emin olun.
--noWeb	İsteğe bağlı: Varsa, SSMS kurulumu SSMS'yi yüklemek için düzen dizininizdeki dosyaları kullanır ve web'den herhangi bir paket indirmez. Kullanıcı düzende olmayan bileşenleri yüklemeye çalışırsa kurulum başarısız olur. İç intranet web sitesinde barındırılan bir düzeni dağıtmaya çalışıyorsanız bu parametreyi kullanmayın. Önemli: --noWeb parametresi, internete bağlı bir istemci makinedeki Visual Studio Yükleyicisi'nin, güncellemeler için istemcinin Microsoft barındırılan sunucularına bakacak şekilde yapılandırılmışsa, güncellemeleri kontrol etmesini durdurmaz. Bu durumda, --noWeb istemcinin ürün paketlerini indirmesini engellemeniz yeterlidir.
--verify	İsteğe bağlı: Düzenin içeriğini doğrulayın. Bozuk veya eksik dosyalar listelenir.
--fix	İsteğe bağlı: Düzenin içeriğini doğrulayın. Bozuk veya eksik dosyalar yeniden yüklenir. Düzeni düzeltmek için İnternet erişimi gereklidir.
--clean <one or more paths to catalogs>	İsteğe bağlı: Bileşenlerin eski sürümlerini, daha yeni bir sürüme güncelleştirilmiş bir düzenden kaldırır.

Gelişmiş düzen parametreleri	Açıklama
--channelId <id>	İsteğe bağlı: Yüklenecek örneğin kanal kimliği SSMS.22.SSMS.Release şeklinde temsil edilir. channelId komutu yüklemek için gereklidir ve --installPath belirtilirse diğer komutlar için yoksayılır. Daha fazla bilgi için bkz. söz dizimi örnekleri--channelId.
--channelUri <uri>	İsteğe bağlı: Kanal bildiriminin URI'si. Bu değer güncelleştirmelerin kaynak konumunu yönetir ve ilk değer düzenin response.json dosyasında yapılandırılır. Güncelleştirmeler istenmiyorsa, --channelUri var olmayan bir dosyaya işaret edebilir (örneğin, --channelUri C:\doesntExist.chman). Bu parametre yükleme komutu için kullanılabilir; diğer komutlar bunu yoksayar.
--installChannelUri <uri>	İsteğe bağlı: Yükleme için kullanılacak kanal bildiriminin URI'si. Güncellemeleri algılamak için, --channelUri belirtildiğinde belirtilmesi gereken URI olan --installChannelUri kullanılır. Bu parametre yükleme komutu için kullanılabilir; diğer komutlar bunu yoksayar.
--installCatalogUri <uri>	İsteğe bağlı: Yükleme için kullanılacak katalog bildiriminin URI'si. Belirtilirse, kanal yöneticisi yükleme kanalı bildiriminde URI'yi kullanmadan önce bu URI'den katalog bildirimini indirmeyi dener. Bu parametre, düzen önbelleğinin önceden indirilmiş ürün kataloğuyla oluşturulduğu çevrimdışı yüklemeyi desteklemek için kullanılır. Bu parametre yükleme komutu için kullanılabilir; diğer komutlar bunu yoksayar.
--productId <id>	İsteğe bağlı: Yüklenen örneğin ürünün kimliği. Bu parametre normal yükleme koşullarında önceden doldurulur. productId şeklindedirMicrosoft.VisualStudio.Product.SSMS.
--keepLayoutVersion	İsteğe bağlı: Düzenin ürün sürümünü güncelleştirmeden düzende değişiklik uygulayın.
--locale <language-locale>	İsteğe bağlı: Yükleyicinin kendisi için kullanıcı arabiriminin görüntüleme dilini değiştirin. Ayar kalıcıdır. Daha fazla bilgi için bu makalenin Dil yerel ayarları listesi bölümüne bakın.
--cache	İsteğe bağlı: Varsa, paketler sonraki onarımlar için yüklendikten sonra saklanır. Bu, sonraki yüklemeler, onarımlar veya değişiklikler için kullanılacak genel ilke ayarını geçersiz kılar. Varsayılan ilke paketleri önbelleğe almaktır. Kaldırma komutu için bu politika göz ardı edilir.
--nocache	İsteğe bağlı: Varsa paketler yüklendikten veya onarıldıktan sonra silinir. Bunlar yalnızca gerektiğinde yeniden indirilir ve kullanımdan sonra yeniden silinir. Bu, sonraki yüklemeler, onarımlar veya değişiklikler için kullanılacak genel ilke ayarını geçersiz kılar. Varsayılan ilke paketleri önbelleğe almaktır. Kaldırma komutu için bu politika göz ardı edilir.
--noUpdateInstaller	İsteğe bağlı: Varsa, belirtildiğinde quiet yükleyicinin kendisini güncelleştirmesini engeller. Yükleyici, bir yükleyici güncellemesi gerektiğinde --noUpdateInstaller ile quiet belirtilirse komutu başarısız olur ve sıfır olmayan bir çıkış kodu döndürür.
--path <name>=<path>	İsteğe bağlı: Yükleme için özel yükleme yollarını belirtmek için kullanılır. Desteklenen yol adları paylaşılır, önbelleğe alınır ve yüklenir.
--path cache=<path>	İsteğe bağlı: Yükleme dosyalarını indirmek için belirttiğiniz konumu kullanır. Bu konum yalnızca SSMS ilk kez yüklendiğinde ayarlanabilir. Örnek: --path cache="C:\SSMS\cache"
--path shared=<path>	İsteğe bağlı: Yan yana SSMS ve Visual Studio yüklemeleri için paylaşılan dosyaları içerir. Bazı araçlar ve SDK'lar bu sürücüdeki bir konuma yüklenirken, bazıları bu ayarı geçersiz kılıp başka bir sürücüye yükleyebilir. Örnek: --path shared="C:\VS\shared" Önemli: Bu yol yalnızca bir kez ve SSMS veya Visual Studio ilk kez yüklendiğinde ayarlanabilir.
--path install=<path>	İsteğe bağlı: ile eşdeğerdir –-installPath. Özellikle --installPath "C:\SSMS" ve --path install="C:\SSMS" eşdeğerdir. Aynı anda bu komutlardan yalnızca biri kullanılabilir.

ModifySettings komutu ve komut satırı parametreleri

Güncelleştirme ayarlarını değiştirebilir ve belirli bir SSMS örneği için güncelleştirmelerin kaynak konumunu program aracılığıyla yapılandırabilirsiniz. Bu değişiklik, istemci makinesindeki yükleyici veya önyükleyici kullanılarak ve modifySettings komutuyla istenen güncelleştirme kanalı geçirerek yapılabilir.

Komut	Açıklama
modifySettings	SSMS'nin belirli bir örneğinin güncelleştirme ayarlarını değiştirmek için kullanılan fiil.

modifySettings parametreleri	Açıklama
--installPath <dir>	Hangi SSMS örneğinin üzerinde işlem gerçekleştirileceğini belirtmek için kullanılması önerilir.
--newChannelUri	Gerekli: Kanal bildiriminin URI'si. Bu değer, güncelleştirmelerin bir sonraki kaynak konumunun nerede olacağını belirtir. Güncelleştirmeler istenmiyorsa, --channelUri var olmayan bir dosyaya işaret edebilir (örneğin, --channelUri C:\doesNotExist.chman).
--channelUri	Eski kanal bildiriminin URI'sini. bilinmiyorsa --installPath kullanılabilir. Üzerinde işlem yapılacak doğru örneği tanımlamak için ile --productId kullanılmalıdır.
--productId <id>	Belirtilirse ve üzerinde işlem yapılacak doğru örneği tanımlamak için kullanılırsa --channelUri kullanılmalıdır. productId şeklindedirMicrosoft.VisualStudio.Product.SSMS.
--includeRecommended	İsteğe bağlı: ModifySettings komutu sırasında, bu parametre (bundan hemen sonra true veya false sözcüğü olmalıdır) SSMS yükleyicisine Güncelleştirme Ayarı iletişim kutusunda "güncelleştirmede yüklü iş yükleri için önerilen bileşenleri ekleme" işlevini devre dışı bırakmasını söyler.
--quiet	İsteğe bağlı: Bu parametre, komut yürütülürken herhangi bir kullanıcı arabiriminin görüntülenmesini engeller. Standart kullanıcılar tarafından programatik olarak kullanılamaz.
--removeOos true	İsteğe bağlı: ModifySettings komutu sırasında, bu parametre SSMS yükleyicisine destek dışı duruma geçiş yapan tüm yüklü bileşenleri kalıcı olarak kaldırmasını veya kaldırmamasını söyler. Bu ayarın hemen ardından true veya false kelimesi olmalıdır. Bu ayar makinenin güvenli kalmasına yardımcı olur.

Söz dizimi örnekleri:

C:\>"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modifySettings --installPath "C:\Program Files\Microsoft SQL Server Management Studio 22\Release" --newChannelUri https://aka.ms/ssms/22/release/channel --removeOos true

 C:\>"C:\Program Files\Microsoft SQL Server Management Studio 22\Release\vs_SSMS.exe" modifySettings --channelUri https://aka.ms/ssms/22/release/channel --productId Microsoft.VisualStudio.Product.Ssms --newChannelUri \\layoutserver\share\path\channelmanifest.json --removeOos true --quiet

Kanal komutu ve komut satırı parametrelerini kaldırma

Güncelleştirme için kullanılabilen kanallar istemcide önbelleğe alınır ve zaman içinde dağınıklık oluşturabilir. Visual Studio Yükleyicisi'ni açıp Kullanılabilir sekmesine geçip ürün kartının sağ üst köşesindeki X işaretini seçerek güncelleştirme kanallarını el ile kaldırabilirsiniz. Kanalları (örneğin, eski düzen konumları) program aracılığıyla removeChannel komutunu kullanarak kaldırabilirsiniz. İstemci makinesinde hangi kanalların önbelleğe alındığını belirlemek için istemci makinesinde program aracılığıyla çalıştırabilirsiniz vswhere .

Komut	Açıklama
removeChannel	İstemci makinesinden bir kanalı kaldırma komutu.

removeChannel parametreleri	Açıklama
--channelUri	Gerekli Eski kanal bildiriminin URI'si.
--quiet	İsteğe bağlı Bu parametre, komut yürütülürken herhangi bir kullanıcı arabiriminin görüntülenmesini engeller.
--passive	İsteğe bağlı Bu parametre parametresini --quiet geçersiz kılar. Kullanıcı arabiriminin etkileşimli olmayan bir şekilde görünmesine neden olur.

Söz dizimi örneği:

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" removeChannel --channelUri "\\\\server\\share\\layoutdirectory\\ChannelManifest.json"

SSMS'yi yüklemek veya değiştirmek için winget kullanma

Windows Paket Yöneticisi (winget) aracını kullanarak, wingettarafından yönetilen diğer paketlerin yanı sıra makinenizde SSMS'yi program aracılığıyla yükleyebilir, değiştirebilir veya güncelleştirebilirsiniz.

Varsayılan olarak winget yalnızca SSMS çekirdek iş yükünü yükler.

Söz dizimi örneği:

winget install Microsoft.SQLServerManagementStudio.22

Visual Studio Yükleyicisi işlemleri şu anda yönetici ayrıcalıkları gerektirir, bu nedenle winget komutu tamamlamak için gerekirse ayrıcalıklarınızı yükseltmenizi ister. Ayrıca en son sürüme yükseltecekseniz SSMS kapatılmalıdır.

İş yükü kimliklerinin ve bileşen kimliklerinin listesi

SSMS ürününe göre sıralanmış iş yükü ve bileşen kimliklerinin listesi için bkz. SQL Server Management Studio için iş yükü ve bileşen kimlikleri.

Dil yerel ayarları listesi

Aşağıdaki tabloda, --addProductLang ve --removeProductLang parametreleriyle kullanılabilecek dil yerel ayarları listelenir.

Dil ve yerel ayar	Dil
cs-cz	Çekçe
de-de	Almanca
en-us	İngilizce
es-es	İspanyolca
fr-fr	Fransızca
it-it	İtalyanca
ja-jp	Japonca
ko-kr	Korece
pl-pl	Lehçe
pt-br	Portekizce - Brezilya
ru-ru	Rusça
tr-tr	Türkçe
zh-cn	Çince - Basitleştirilmiş
zh-tw	Çince - Geleneksel

Hata kodları

İşlemin sonucuna bağlı olarak ortam %ERRORLEVEL% değişkeni aşağıdaki değerlerden birine ayarlanır:

Değer	Sonuç
0	İşlem başarıyla tamamlandı
740	Yükseklik artırımı gerekiyor
1001	Visual Studio yükleyici işlemi çalışıyor
1003	SSMS kullanımda
1602	İşlem iptal edildi
1618	Başka bir yükleme çalışıyor
1641	İşlem başarıyla tamamlandı ve yeniden başlatma başlatıldı
3010	İşlem başarıyla tamamlandı, ancak yüklemenin kullanılabilmesi için yeniden başlatma gerekiyor
5003	Önyükleyici yükleyiciyi indiremedi
5004	İşlem iptal edildi
5005	Önyükleyici komut satırı ayrıştırma hatası
5007	İşlem engellendi - bilgisayar gereksinimleri karşılamıyor
8001	Arm makinesi kontrol hatası
8002	Arka plan indirme ön denetimi hatası
8003	Desteklenmeyen seçilebilir arıza
8004	Hedef dizin hatası
8005	Kaynak yüklerini doğrulamada başarısızlık
8006	SSMS işlemleri çalışıyor
8010	İşletim Sistemi desteklenmiyor. Sistem gereksinimlerine bakın.
-1073720687	Bağlantı hatası
-1073741510	Microsoft Visual Studio Yükleyicisi sonlandırıldı (kullanıcı veya dış işlem tarafından)
Diğer (örneğin: -1, 1, 1603 )	Hata durumu oluştu - Daha fazla bilgi için günlükleri denetleyin

Her işlem, dizinde %TEMP% yüklemenin ilerleme durumunu gösteren birkaç günlük dosyası oluşturur. Klasörü tarihe göre sıralayın ve sırasıyla önyükleyici, yükleyici uygulaması ve ssms_bootstrapper kurulum altyapısı için , ssms_clientve ile ssms_setupbaşlayan dosyaları arayın.

Destek ve sorun giderme

Bazen işler ters gider. SSMS yüklemeniz başarısız olursa, adım adım yönergeler için bkz. SQL Server Management Studio yükleme ve yükseltme sorunlarını giderme .

Diğer bilinen sorunlar hakkında bilgi almak (ve ürün ekibine geri bildirimde bulunmak için) SSMS Geliştirici Topluluğu sitesine başvurabilirsiniz (Gruplarıaltında Araçları filtreleyin).

İlgili içerik

• SQL Server Management Studio'nun çevrimdışı yüklemesini oluşturma
• SQL Server Management Studio için iş yükü ve bileşen kimlikleri