Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
s’applique à :
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics
SQL Server Management Studio 22 est un outil puissant pour gérer les instances SQL Server, les bases de données Azure SQL et les instances managées Azure SQL. Cet article fournit des instructions détaillées sur l’utilisation des paramètres de ligne de commande pour installer SQL Server Management Studio 22, ce qui permet un processus d’installation plus personnalisé et automatisé. Que vous installiez SQL Server Management Studio 22 pour la première fois ou que vous mettez à jour une installation existante, ces instructions fournissent les étapes nécessaires pour atteindre vos objectifs.
Paramètres de ligne de commande
Lorsque vous installez SQL Server Management Studio (SSMS) par programmation ou à partir d’une invite de commandes, vous pouvez utiliser différents paramètres de ligne de commande pour contrôler ou personnaliser l’installation afin d’effectuer les actions suivantes :
- Démarrez l’installation sur le client avec certaines options et comportements préélectionnés.
- Automatisez le processus d’installation ou de mise à jour.
- Créez ou gérez une disposition réseau des fichiers produits pour l’installation ou la mise à jour des ordinateurs clients.
Les verbes et paramètres de ligne de commande suivants peuvent être utilisés avec les exécutables ou programmes suivants :
- Programme d’amorçage du programme d’installation, le petit fichier d’environ 5 Mo (par exemple,
vs_SSMS.exe) qui lance le processus de téléchargement et l’installation initiale. - Programme d’installation de Visual Studio qui pourrait déjà être installé sur l’ordinateur et qui se trouve dans le dossier
C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe. Vous devez lancer le programme d’installation à partir d’un répertoire différent dans lequel réside le programme d’installation. Le programme d’installation est généralement utilisé pour mettre à jour ou modifier des commandes.
Toutes les commandes ou paramètres ne fonctionnent pas dans chacune de ces situations, mais toutes les mises en garde ou exceptions spéciales sont documentées. De plus, dans certains scénarios, vous pourriez ne pas avoir accès à tous ces exécutables décrits précédemment. Par exemple, les ordinateurs clients pourraient avoir le programme d’installation disponible uniquement pour l’exécution par programmation si SSMS a été installé par le biais d’une disposition.
Pour obtenir les derniers programme d’amorçage pour SQL Server Management Studio 22 qui installent toujours la dernière version du canal sélectionné, téléchargez l’un des fichiers dans le tableau suivant. Vous pouvez également installer une version spécifique ou un canal spécifique de SQL Server Management Studio 22, consultez l’historique des versions pour SQL Server Management Studio. Cet article contient des liens vers les programmes d'amorçage de version fixe pour chaque version de maintenance.
| Canal | Version | Programme d'amorçage |
|---|---|---|
| Libération | 22.0.0 | SQL Server Management Studio |
Conseil / Astuce
Si vous avez précédemment téléchargé un fichier de programme d’amorçage, vous pouvez vérifier la version avant d’essayer d’installer. Ouvrez l’Explorateur de fichiers, cliquez avec le bouton droit sur le fichier de programme d’amorçage, sélectionnez Propriétés, puis sélectionnez l’onglet Détails . Le champ Version du produit décrit le canal et la version que le programme d’amorçage installe. Le numéro de version doit toujours être lu en tant que « dernière version de maintenance de ce qui est spécifié », et le canal est Release, sauf indication explicite. Un programme d’amorçage avec une version de produit indiquant que SQL Server Management Studio 22 installe la dernière version de SQL Server Management Studio 22 à partir du canal Release.
Les commandes installer, mettre à jour, modifier, réparer, désinstaller et exporter et paramètres de ligne de commande
Lorsque le programme d'amorçage de SSMS ou l’installateur est invoqué de manière programmatique, pour installer le produit ou pour maintenir une disposition :
- Le premier paramètre est la commande (verbe) qui décrit l’opération à effectuer.
- Les paramètres de ligne de commande optionnels suivants, tous précédés de deux tirets (
--), définissent davantage comment cette opération est censée se produire.
Les paramètres de ligne de commande SSMS ne respectent pas la casse.
Exemple de syntaxe : vs_SSMS.exe [command] <optional parameters>...
| Commande | Description |
|---|---|
| (vide) | La commande par défaut installe le produit et est utilisée pour toutes les opérations de maintenance de la disposition. |
modify |
Modifie un produit installé. |
update |
Met à jour un produit installé. |
updateall |
Met à jour tous les produits installés dans l’ordre séquentiel. Fonctionne avec des paramètres --quiet et --passive. |
repair |
Répare un produit installé. |
uninstall |
Désinstalle un produit installé. |
export |
Exporte la configuration d’installation dans un fichier *.vsconfig. |
Importante
Lorsque vous spécifiez des charges de travail, des composants ou des langages distincts, vous devez répéter le commutateur de ligne de commande --add ou --remove pour chaque élément.
| Paramètres | Description |
|---|---|
--installPath <dir> |
Pour la commande d’installation par défaut, ce paramètre est facultatif et décrit l’emplacement d’installation de l’instance sur l’ordinateur client. Pour d’autres commandes telles que la mise à jour ou la modification, ce paramètre est Obligatoire et indique le répertoire d’installation pour que l’instance agisse. |
--productId <id> |
facultatif : ID de l’instance de produit modifiée et utilisée avec --channelId. Le productId est Microsoft.VisualStudio.Product.SSMS. |
--channelUri |
facultatif : lors d'une commande de mise à jour, vous pouvez passer une nouvelle --channelUri afin de modifier l’emplacement des paramètres de mise à jour. Recommandé de jumeler avec le paramètre --installPath, pour que ce soit explicite, quelle instance de SSMS vous configurez. Voir exemples de syntaxe de --channelUri |
--channelId <id> |
ID du canal, par exemple, SSMS.22.SSMS.Release.
channelId est nécessaire pour les opérations de modification, en même temps que --productId ou --installPath. |
--add <one or more workload or component IDs> |
facultatif : pendant une commande d’installation ou de modification, ce paramètre reproductible spécifie un ou plusieurs ID de charge de travail ou de composant à ajouter. Les composants requis de l’artefact sont installés, mais pas les composants recommandés ou facultatifs. Vous pouvez contrôler d’autres composants globalement à l’aide de paramètres --includeRecommended et/ou --includeOptional. Pour inclure plusieurs charges de travail ou composants, répétez la commande --add (par exemple, --add Workload1 --add Workload2). Pour un contrôle plus fin, vous pouvez ajouter ;includeRecommended ou ;includeOptional à l’ID (par exemple, --add Workload1;includeRecommended ou --add Workload2;includeRecommended;includeOptional). |
--all |
facultatif : lors d’une commande d’installation ou de modification, ce paramètre entraîne l’installation de toutes les charges de travail et composants du produit. |
--allWorkloads |
facultatif : pendant une commande d’installation ou de modification, ce paramètre installe toutes les charges de travail et tous les composants, mais pas de composants recommandés ou facultatifs. |
--includeRecommended |
facultatif : pendant une commande d’installation ou de modification, ce paramètre inclut les composants recommandés pour toutes les charges de travail installées. Il n’inclut pas les composants facultatifs. Les charges de travail sont spécifiées avec --allWorkloads ou --add. En utilisant le paramètre --includeRecommended, vous activerez la boîte de dialogue Paramètres de mise à jour pour « ajouter des composants recommandés pour les charges de travail installées lors de la mise à jour ». Pour modifier ces paramètres, consultez Personnaliser les paramètres de mise à jour. |
--includeOptional |
facultatif : lors d’une commande d’installation ou de modification, ce paramètre inclut les composants facultatifs des charges de travail installées. Il n’inclut pas les composants recommandés. Les charges de travail sont spécifiées avec --allWorkloads ou --add. |
--addProductLang <language-locale> |
facultatif : pendant une commande d’installation ou de modification, ce paramètre reproductible spécifie les modules linguistiques de l’interface utilisateur qui doivent être installés avec le produit. S’il n’est pas présent, l’installation utilise le module linguistique correspondant aux paramètres régionaux de l’ordinateur. Pour plus d’informations, consultez la [liste des locales linguistiques] |
--remove <one or more workload or component IDs> |
facultatif : pendant une commande de modification, ce paramètre reproductible spécifie un ou plusieurs ID de charge de travail ou de composant à supprimer. Il complète et se comporte de la même façon que le paramètre --add. |
--addProductLang <language-locale> |
facultatif : pendant une commande d’installation ou de modification, ce paramètre reproductible spécifie les modules linguistiques de l’interface utilisateur qui doivent être installés avec le produit. S’il n’est pas présent, l’installation utilise le module linguistique correspondant aux paramètres régionaux de l’ordinateur. Pour plus d’informations, consultez la section Liste des paramètres régionaux linguistiques de cet article. |
--removeProductLang <language-locale> |
facultatif : pendant une commande d’installation ou de modification, ce paramètre reproductible détermine les modules linguistiques de l’interface utilisateur qui doivent être supprimés du produit. Il complète et se comporte de la même façon que le paramètre --addProductLang. |
--in <path> |
Facultatif : URI ou chemin d’accès à un fichier réponse, qui peut contenir des paramètres de configuration. |
--quiet |
Facultatif : ce paramètre, lorsqu’il est utilisé avec n’importe quelle commande, empêche toute interface utilisateur d’être affichée pendant l’exécution de la commande. Non disponible pour une utilisation par programmation par les utilisateurs standard, quelle que soit la façon dont la stratégie AllowStandardUserControl est définie. |
--passive, -p |
facultatif : ce paramètre entraîne l’affichage de l’interface utilisateur de manière non interactive. Ce paramètre s’exclue mutuellement (et remplace en fait) le paramètre --quiet. Il n'est pas non plus possible de l'utiliser programmatiquement par les utilisateurs standard, quelle que soit la façon dont la stratégie AllowStandardUserControl est définie. |
--norestart |
facultatif : ce paramètre doit être associé aux paramètres --passive ou --quiet. Pendant une commande d’installation, de mise à jour ou de modification, l’ajout du paramètre --norestart retarde tout redémarrage nécessaire. |
--force |
Facultatif : ce paramètre force SSMS à se fermer même si un processus SSMS est en cours d’utilisation. Le fait de forcer la fermeture de SSMS peut entraîner une perte de travail, utilisez donc ce paramètre avec précaution. |
--installWhileDownloading |
Facultatif : lors d’une commande d’installation, de mise à jour ou de modification. Ce paramètre permet à SSMS de télécharger et d’installer le produit en parallèle. C’est l’expérience par défaut. |
--downloadThenInstall |
Facultatif : lors d’une commande d’installation, de mise à jour ou de modification, ce paramètre force SSMS à télécharger tous les fichiers avant de les installer. Il s’exclut mutuellement du paramètre --installWhileDownloading. |
--nickname <name> |
facultatif : pendant une commande d’installation, ce paramètre définit le surnom à attribuer à un produit installé. Le surnom ne peut pas dépasser 10 caractères. |
--removeOos true |
facultatif : lors d’une commande d’installation, de mise à jour ou de modification, ce paramètre, suivi de true ou de false, indique au programme d’installation de Visual Studio s’il faut supprimer tous les composants installés transférés vers un état hors support. Ce comportement s’applique à un seul événement. Si vous voulez rendre ce comportement persistant, appliquez ce paramètre à la commande modifySettings, décrite plus en avant, ou configurez la stratégie globale removeOOS. Utile pour aider à sécuriser la machine. |
--config <path to *.vsconfig file> |
facultatif : pendant une opération d’installation ou de modification, vous pouvez transmettre un fichier de configuration à l’aide du paramètre --config pour spécifier les charges de travail, les composants ou les extensions à ajouter en fonction d’un fichier de configuration d’installation précédemment enregistré. Cette opération est additive uniquement ; elle ne supprime rien qui n'est pas spécifié dans le fichier. En outre, les éléments spécifiés dans le fichier de configuration qui ne s’appliquent pas au produit ne sont pas ajoutés. Il est vivement recommandé de spécifier le chemin complet du fichier config. Pendant une opération d’exportation, ce paramètre détermine l’emplacement pour enregistrer le fichier de configuration d’installation. |
--allowUnsignedExtensions |
facultatif : lors d’une opération d’installation ou de modification exécutée dans un contexte --passive ou --quiet à l’aide d’un fichier --config, si des extensions sont spécifiées dans le fichier config, ce paramètre est nécessaire pour charger des extensions sans signature numérique. |
--installerOnly |
Facultatif : lors d’une opération d’installation ou de mise à jour, ce paramètre indique à l’installateur de Visual Studio d’installer uniquement lui-même (l’installateur) et non le produit SSMS. Ses fonctionnalités sont équivalentes au paramètre --update, mais plus intuitives. Destiné à être utilisé lors de la préparation et de la préconfiguration des ordinateurs clients. |
--help, --?, -h, -? |
Affiche une version hors connexion de cet article. |
Commande de disposition et paramètres de ligne de commande
Toutes les opérations de gestion de mise en page, telles que la création ou la mise à jour d’une mise en page, sont exécutées à l’aide du fichier exécutable du bootstrapper et présupposent que la commande par défaut est Installation (sans paramètres). Toutes les opérations de gestion de disposition doivent commencer par le paramètre initial --layout requis. Le tableau suivant décrit les autres paramètres que vous pouvez utiliser pour créer ou mettre à jour une disposition à l’aide de la ligne de commande.
| Paramètres de disposition | Descriptif |
|---|---|
--layout <dir> |
Spécifie un répertoire pour créer ou mettre à jour un cache d’installation hors connexion. |
--lang <one or more language-locales> |
facultatif : utilisé avec --layout pour préparer un cache d’installation hors connexion avec des packages de ressources avec une ou plusieurs langues spécifiées. Pour plus d’informations, consultez la section Liste des paramètres régionaux linguistiques de cet article. |
--add <one or more workload or component IDs> |
facultatif : un ou plusieurs identifiants de charge de travail ou de composant à ajouter. Les composants requis de l’artefact sont installés, mais pas les composants recommandés ou facultatifs. Vous pouvez contrôler plus de composants globalement à l’aide de --includeRecommended et/ou de --includeOptional. Pour un contrôle plus fin, vous pouvez ajouter ;includeRecommended ou ;includeOptional à l’ID (par exemple, --add Workload1;includeRecommended ou --add Workload2;includeOptional).Remarque: si --add est utilisé, seules les charges de travail et les composants spécifiés et leurs dépendances sont téléchargés. Si --add n’est pas spécifié, l’ensemble des charges de travail et des composants est téléchargé sur la disposition. |
--includeRecommended |
facultatif : inclut les composants recommandés pour toutes les charges de travail installées, mais pas les composants facultatifs. Les charges de travail sont spécifiées avec --allWorkloads ou --add. |
--includeOptional |
Optionnel: inclut les composants recommandés et les composants facultatifs pour toutes les charges de travail incluses dans la disposition. Les charges de travail sont spécifiées avec --add. |
--wait |
facultatif : le processus attend que l’installation soit terminée avant de retourner un code de sortie.
wait est utile lors de l'automatisation des installations où il faut attendre la fin de l'installation pour gérer le code de retour de celle-ci. Le paramètre --wait ne peut être passé que dans le bootstrapper ; l’installateur (setup.exe) ne le prend pas en charge. Il est utile lors de la mise à jour des dispositions. |
--config <path to *.vsconfig file> |
Facultatif : s’il est présent, SSMS utilise le contenu du fichier de configuration pour configurer votre disposition. Veillez à spécifier le chemin complet du fichier config. |
--noWeb |
Facultatif : s’il est présent, SSMS utilise les fichiers de votre répertoire de disposition pour installer SSMS et ne télécharge aucun package à partir du web. Si un utilisateur tente d’installer des composants qui ne sont pas dans la disposition, le programme d’installation échoue. N’utilisez pas ce paramètre si vous essayez de déployer une disposition hébergée sur un site web intranet interne. important : le paramètre --noWeb n’empêche pas Visual Studio Installer sur une machine cliente connectée à Internet de vérifier les mises à jour si le client est configuré pour examiner les serveurs hébergés par Microsoft pour les mises à jour. Dans ce cas, --noWeb empêche simplement le client de télécharger les packages de produits. |
--verify |
Vérification facultative : vérifiez le contenu d'une mise en page. Tous les fichiers endommagés ou manquants sont répertoriés. |
--fix |
Vérification facultative : vérifiez le contenu d'une mise en page. Si des fichiers sont endommagés ou manquants, ils sont retéléchargés. L’accès à Internet est nécessaire pour corriger une disposition. |
--clean <one or more paths to catalogs> |
Facultatif : supprime les anciennes versions des composants d’une disposition mise à jour vers une version plus récente. |
| paramètres de disposition avancés | Description |
|---|---|
--channelId <id> |
facultatif : l'ID du canal pour l'instance à installer, représenté par SSMS.22.SSMS.Release.
channelId est requise pour la commande d’installation et ignorée pour les autres commandes si --installPath est spécifié. Pour plus d'informations, consultez les exemples de syntaxe de --channelId. |
--channelUri <uri> |
facultatif : URI du manifeste de canal. Cette valeur régit l’emplacement source des mises à jour et la valeur initiale est configurée dans le fichier response.json de la disposition. Si les mises à jour ne sont pas souhaitées, --channelUri peut pointer vers un fichier inexistant (par exemple, --channelUri C:\doesntExist.chman). Ce paramètre peut être utilisé pour la commande d’installation ; d’autres commandes l’ignorent. |
--installChannelUri <uri> |
facultatif : URI du manifeste de canal à utiliser pour l’installation. L’URI spécifié par --channelUri (qui doit être spécifié lorsque --installChannelUri est spécifié) est utilisé pour détecter les mises à jour. Ce paramètre peut être utilisé pour la commande d’installation ; d’autres commandes l’ignorent. |
--installCatalogUri <uri> |
facultatif : URI du manifeste de catalogue à utiliser pour l’installation. Si cela est spécifié, le gestionnaire de canaux tente de télécharger le manifeste du catalogue à partir de cet URI avant d’utiliser l’URI dans le manifeste du canal d’installation. Ce paramètre est utilisé pour prendre en charge l’installation hors connexion, où le cache de disposition est créé avec le catalogue de produits déjà téléchargé. Ce paramètre peut être utilisé pour la commande d’installation ; d’autres commandes l’ignorent. |
--productId <id> |
facultatif : ID du produit pour l’instance installée. Ce paramètre est pré-rempli dans des conditions d’installation normales. Le productId est Microsoft.VisualStudio.Product.SSMS. |
--keepLayoutVersion |
Facultatif : appliquez des modifications à la mise en page sans mettre à jour la version de la mise en page du produit. |
--locale <language-locale> |
facultatif : modifiez la langue d’affichage de l’interface utilisateur pour le programme d’installation lui-même. Le paramètre est conservé. Pour plus d’informations, consultez la section Liste des paramètres régionaux linguistiques de cet article. |
--cache |
Facultatif : le cas échéant, les packages sont conservés après leur installation pour les réparations ultérieures. Cela remplace le paramètre de stratégie globale à utiliser pour les installations, les réparations ou les modifications suivantes. La stratégie par défaut consiste à mettre en cache les packages. Cette stratégie est ignorée pour la commande de désinstallation. |
--nocache |
facultatif : s’il est présent, les packages sont supprimés après avoir été installés ou réparés. Ils seront téléchargés à nouveau uniquement si nécessaire et supprimés à nouveau après l’utilisation. Cela remplace le paramètre de stratégie globale à utiliser pour les installations, les réparations ou les modifications suivantes. La stratégie par défaut consiste à mettre en cache les packages. Cette stratégie est ignorée pour la commande de désinstallation. |
--noUpdateInstaller |
Facultatif : le cas échéant, empêche le programme d’installation de se mettre à jour quand quiet est spécifié. Le programme d'installation échoue à exécuter la commande et retourne un code de sortie différent de zéro si --noUpdateInstaller est spécifié avec quiet lorsqu'une mise à jour du programme d'installation est requise. |
--path <name>=<path> |
facultatif : utilisé pour spécifier des chemins d’installation personnalisés pour l’installation. Les noms de chemins pris en charge sont partagés, mis en cache et installés. |
--path cache=<path> |
facultatif : utilise l’emplacement que vous spécifiez pour télécharger les fichiers d’installation. Cet emplacement peut être défini uniquement pendant la première installation de SSMS. Exemple : --path cache="C:\SSMS\cache" |
--path shared=<path> |
Facultatif : contient des fichiers partagés pour les installations de SSMS et Visual Studio côte à côte. Certains outils et kits SDK s’installent sur un emplacement sur ce lecteur, tandis que d’autres peuvent remplacer ce paramètre et l’installer sur un autre lecteur. Exemple : --path shared="C:\VS\shared"Important : ce chemin d’accès ne peut être défini qu’une seule fois et la première fois que SSMS ou Visual Studio est installé. |
--path install=<path> |
facultatif : équivalent à –-installPath. Plus précisément, --installPath "C:\SSMS" et --path install="C:\SSMS" sont équivalents. Une seule de ces commandes peut être utilisée à la fois. |
Commande ModifySettings et paramètres de ligne de commande
Vous pouvez modifier les paramètres de mise à jour et configurer par programme l’emplacement source des mises à jour pour une instance donnée de SSMS. Cette modification peut être effectuée à l’aide du programme d’installation ou du programme d’amorçage sur l’ordinateur client, et en passant la commande modifySettings et le canal de mise à jour souhaité.
| Commande | Description |
|---|---|
modifySettings |
Verbe utilisé pour modifier les paramètres de mise à jour d’une instance particulière de SSMS. |
| Paramètres modifySettings | Description |
|---|---|
--installPath <dir> |
Il est recommandé de l’utiliser pour spécifier l’instance de SSMS sur laquelle agir. |
--newChannelUri |
obligatoire : URI du manifeste du canal. Cette valeur spécifie où sera le prochain emplacement source des mises à jour . Si les mises à jour ne sont pas souhaitées, --channelUri peut pointer vers un fichier inexistant (par exemple, --channelUri C:\doesNotExist.chman). |
--channelUri |
L'URI de l’ancien manifeste du canal. Peut être utilisé si --installPath n’est pas connu. Doit être utilisé avec --productId pour identifier l’instance appropriée sur laquelle agir. |
--productId <id> |
Doit être utilisé si --channelUri est spécifié et est utilisé pour identifier l’instance appropriée sur laquelle agir. Le productId est Microsoft.VisualStudio.Product.SSMS. |
--includeRecommended |
Facultatif : lors d’une commande modifySettings, ce paramètre (qui doit être suivi du mot true ou false) indique au programme d’installation de SSMS de désactiver la fonctionnalité « ajouter des composants recommandés pour les charges de travail installées lors de la mise à jour » dans la boîte de dialogue Paramètres de mise à jour. |
--quiet |
facultatif : ce paramètre empêche toute interface utilisateur d’être affichée pendant l’exécution de la commande. Non disponible pour une utilisation par programmation par utilisateurs standard. |
--removeOos true |
Facultatif : lors d’une commande modifySettings, ce paramètre indique au programme d’installation de SSMS de supprimer de manière permanente , ou non, tous les composants installés qui ont passé à un état hors support. Ce paramètre doit avoir le mot true ou false immédiatement après. Ce paramètre permet de sécuriser la machine. |
Exemples de syntaxe :
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
Supprimer les paramètres de commande de canal et de ligne de commande
Les chaînes à partir desquelles les mises à jour sont effectuées sont mises en cache sur le client. Au fil du temps, elles peuvent devenir encombrantes. Vous pouvez supprimer manuellement les canaux de mise à jour en mettant à jour le programme d’installation de Visual Studio, en basculant vers l’onglet Disponible et en sélectionnant le X dans le coin supérieur droit de la carte de produit. Vous pouvez supprimer par programme des canaux (par exemple, des emplacements de disposition plus anciens) à l’aide de la commande removeChannel. Vous pouvez exécuter vswhere par programmation sur l’ordinateur client pour déterminer les chaînes mises en cache sur l’ordinateur client.
| Commande | Description |
|---|---|
removeChannel |
Commande pour supprimer un canal de l’ordinateur client. |
| paramètres removeChannel | Description |
|---|---|
--channelUri |
Obligatoire L’URI de l’ancien manifeste de chaîne. |
--quiet |
facultatif Ce paramètre empêche toute interface utilisateur d’être affichée pendant l’exécution de la commande. |
--passive |
Facultatif Ce paramètre remplace le paramètre --quiet. Elle entraîne l’affichage de l’interface utilisateur de manière non interactive. |
Exemple de syntaxe :
"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" removeChannel --channelUri "\\\\server\\share\\layoutdirectory\\ChannelManifest.json"
Utiliser winget pour installer ou modifier SSMS
Vous pouvez utiliser l’outil Gestionnaire de package Windows (winget) pour installer, modifier ou mettre à jour SSMS par programmation sur votre ordinateur, ainsi que d’autres packages gérés par winget.
Par défaut, winget installe simplement la charge de travail principale SSMS.
Exemple de syntaxe :
winget install Microsoft.SQLServerManagementStudio.22
Les opérations visual Studio Installer nécessitent actuellement des privilèges d’administrateur. Winget vous invite donc à élever vos privilèges si nécessaire pour terminer la commande. De plus, SSMS doit être fermé si vous allez le mettre à niveau vers la dernière version.
Liste des ID de charge de travail et des ID de composant
Pour obtenir la liste des ID de charge de travail et de composant triés par produit SSMS, consultez les ID de charge de travail et de composant pour SQL Server Management Studio.
Liste des localisations linguistiques
Le tableau suivant liste les paramètres locaux de langues qui peuvent être utilisés avec les paramètres --addProductLang et --removeProductLang.
| Paramètres régionaux de langue | Langue |
|---|---|
cs-cz |
Tchèque |
de-de |
Allemand |
en-us |
Anglais |
es-es |
Espagnol |
fr-fr |
Français |
it-it |
Italien |
ja-jp |
Japonais |
ko-kr |
Coréen |
pl-pl |
Polonais |
pt-br |
Portugais - Brésil |
ru-ru |
Russe |
tr-tr |
Turc |
zh-cn |
Chinois - Simplifié |
zh-tw |
Chinois - Traditionnel |
Codes d’erreur
Selon le résultat de l’opération, la variable d’environnement %ERRORLEVEL% est définie sur l’une des valeurs suivantes :
| Valeur | Résultat |
|---|---|
| 0 | Opération terminée avec succès |
| 740 | Élévation requise |
| 1 001 | Le processus d’installation de Visual Studio est en cours d’exécution |
| 1003 | SSMS est en cours d’utilisation |
| 1602 | L’opération a été annulée |
| 18:16 | Une autre installation en cours d’exécution |
| 1641 | L’opération s’est terminée avec succès et le redémarrage a été lancé |
| 3010 | L’opération s’est terminée correctement, mais l’installation nécessite un redémarrage avant de pouvoir être utilisée |
| 5003 | Échec du bootstrapper à télécharger le programme d’installation |
| 5004 | L’opération a été annulée |
| 5005 | Erreur d’analyse de la ligne de commande Bootstrapper |
| 5007 | L’opération a été bloquée - l’ordinateur ne répond pas à la configuration requise |
| 8001 | Échec de la vérification de l’ordinateur ARM |
| 8002 | Échec de la vérification préalable du téléchargement en arrière-plan |
| 8003 | Échec sélectionnable non pris en charge |
| 8004 | Échec du répertoire cible |
| 8005 | Vérification de l’échec des charges utiles sources |
| 8006 | Processus SSMS en cours d’exécution |
| 8010 | Système d’exploitation non pris en charge. Reportez-vous à la configuration requise. |
| -1073720687 | Échec de connectivité |
| -1073741510 | Microsoft Visual Studio Installer a été arrêté (par l’utilisateur ou le processus externe) |
| Autres (par exemple : -1, 1, 1603 ) |
Une condition d’échec s’est produite - Pour plus d’informations, consultez les journaux |
Chaque opération génère plusieurs fichiers journaux dans le répertoire %TEMP% qui indiquent la progression de l’installation. Triez le dossier par date et recherchez les fichiers commençant par ssms_bootstrapper, ssms_clientet ssms_setup pour le programme d’amorçage, l’application d’installation et le moteur d’installation, respectivement.
Support ou résolution des problèmes
Parfois, les choses peuvent mal tourner. Si votre installation de SSMS échoue, consultez Résoudre les problèmes d’installation et de mise à niveau pour SQL Server Management Studio pour obtenir des instructions pas à pas.
Vous pouvez consulter le site de la communauté des développeurs SSMS pour d’autres problèmes connus (filtrez sur Outils sous Groupes) et pour fournir des commentaires à l'équipe du produit.