Opdrachtregelparameters gebruiken om SQL Server Management Studio te installeren

van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics-

SQL Server Management Studio 22 is een krachtig hulpprogramma voor het beheren van SQL Server-exemplaren, Azure SQL-databases en door Azure SQL beheerde exemplaren. In dit artikel vindt u gedetailleerde instructies voor het gebruik van opdrachtregelparameters voor het installeren van SQL Server Management Studio 22, zodat u een meer aangepast en geautomatiseerd installatieproces kunt uitvoeren. Of u nu SQL Server Management Studio 22 voor het eerst installeert of een bestaande installatie bijwerkt, deze instructies bieden de benodigde stappen om uw doelen te bereiken.

Opdrachtregelparameters

Wanneer u SQL Server Management Studio (SSMS) programmatisch of vanaf een opdrachtprompt installeert, kunt u verschillende opdrachtregelparameters gebruiken om de installatie te beheren of aan te passen om de volgende acties uit te voeren:

• Start de installatie op de client met bepaalde opties en gedrag vooraf geselecteerd.
• Automatiseer het installatie- of updateproces.
• Maak of onderhoud een netwerkindeling van de productbestanden voor het installeren of bijwerken van clientcomputers.

Gebruik de volgende opdrachtregelwerkwoorden en -parameters met de volgende uitvoerbare bestanden of programma's:

• De setup bootstrapper, het kleine (ongeveer 5 MB)-bestand (bijvoorbeeld vs_SSMS.exe) waarmee het downloadproces en de eerste installatie worden gestart.
• Het Visual Studio-installatieprogramma dat mogelijk al op de computer is geïnstalleerd en zich in de map C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exebevindt. U moet het installatieprogramma programmatisch starten vanuit een andere map waarin het installatieprogramma zich bevindt. Het installatieprogramma wordt doorgaans gebruikt voor het bijwerken of wijzigen van opdrachten.

Niet alle opdrachten of parameters werken in elk van deze situaties en eventuele speciale opmerkingen of uitzonderingen worden gedocumenteerd. Bovendien hebt u in sommige scenario's mogelijk geen toegang tot al deze uitvoerbare bestanden die eerder zijn beschreven. Clientcomputers hebben bijvoorbeeld mogelijk alleen het installatieprogramma beschikbaar voor programmatische uitvoering als SSMS is geïnstalleerd via een indeling.

Als u de nieuwste bootstrappers voor SQL Server Management Studio 22 wilt downloaden die altijd de nieuwste versie van het geselecteerde kanaal installeren, downloadt u een van de bestanden in de volgende tabel. Als u een specifieke versie of een specifiek kanaal van SQL Server Management Studio 22 wilt installeren, raadpleegt u de releasegeschiedenis voor SQL Server Management Studio. Dit artikel bevat koppelingen naar de stabiele versie-oplaadprogramma's voor elke onderhoudsrelease.

Kanaal	Versie	Bootstrapper
Vrijgeven	22.3.0	SQL Server Management Studio

Hint

Als u eerder een bootstrapper-bestand hebt gedownload, kunt u de versie controleren voordat u probeert te installeren. Open Verkenner, klik met de rechtermuisknop op het bootstrapper-bestand, selecteer Eigenschappen en selecteer vervolgens het tabblad Details . In het veld Productversie worden het kanaal en de versie beschreven die de bootstrapper installeert. Het versienummer vertegenwoordigt altijd de meest recente onderhoudsrelease van de opgegeven versie en het kanaal is Release, tenzij anders expliciet is opgegeven. Een bootstrapper met een productversie die aangeeft dat het om SQL Server Management Studio 22 gaat, installeert de nieuwste versie van SQL Server Management Studio 22 vanuit het releasekanaal.

Opdrachten en opdrachtregelparameters installeren, bijwerken, wijzigen, herstellen, verwijderen en exporteren

Wanneer u de SSMS bootstrapper of het installatieprogramma programmatisch aanroept, kunt u het product installeren of een indeling onderhouden:

• De eerste parameter is de opdracht (het werkwoord) die de bewerking beschrijft die moet worden uitgevoerd.
• De volgende optionele opdrachtregelparameters, allemaal voorafgegaan door twee streepjes (--), definiëren verder hoe die bewerking plaatsvindt.

Alle SSMS-opdrachtregelparameters zijn niet hoofdlettergevoelig.

Voorbeeld van syntaxis: vs_SSMS.exe [command] <optional parameters>...

Opdracht	Beschrijving
(leeg)	De standaardopdracht installeert het product en wordt gebruikt voor alle onderhoudsbewerkingen voor indelingen.
modify	Hiermee wijzigt u een geïnstalleerd product.
update	Hiermee werkt u een geïnstalleerd product bij.
updateall	Hiermee worden alle geïnstalleerde producten in opeenvolgende volgorde bijgewerkt. Werkt met --quiet en --passive parameters.
repair	Herstelt een geïnstalleerd product.
uninstall	Hiermee verwijdert u een geïnstalleerd product.
export	Hiermee exporteert u de installatieconfiguratie naar een *.vsconfig-bestand.

Belangrijk

Wanneer u meerdere afzonderlijke werkbelastingen, onderdelen of talen opgeeft, moet u de --add of --remove opdrachtregelswitch voor elk item herhalen.

Parameters	Beschrijving
--installPath <dir>	Voor de standaardinstallatieopdracht is deze parameter Optionele en wordt beschreven waar het exemplaar op de clientcomputer is geïnstalleerd. Voor andere opdrachten, zoals bijwerken of wijzigen, is deze parameter verplicht en geeft deze de installatiedirectory aan voor de instantie waarop moet worden ingewerkt.
--productId <id>	Optionele: de ID van het productexemplaar dat wordt gewijzigd en gebruikt met --channelId. De productId is Microsoft.VisualStudio.Product.SSMS.
--channelUri	Optionele: tijdens een updateopdracht kunt u een nieuwe --channelUri doorgeven om de locatie van de update-instellingen te wijzigen. Koppel deze aan de --installPath parameter zodat het exemplaar van SSMS dat u configureert expliciet is. Zie syntaxisvoorbeelden van --channelUri.
--channelId <id>	De id van het kanaal, bijvoorbeeld SSMS.22.SSMS.Release. channelId is vereist voor wijzigingsbewerkingen, naast --productId of --installPath.
--add <one or more workload or component IDs>	Optionele: tijdens een installatie- of wijzigingsopdracht geeft deze herhaalbare parameter een of meer workload- of onderdeel-id's op die moeten worden toegevoegd. De vereiste onderdelen van het artefact worden geïnstalleerd, maar niet de aanbevolen of optionele onderdelen. U kunt andere onderdelen globaal beheren met behulp van de --includeRecommended en --includeOptional parameters. Als u meerdere workloads of onderdelen wilt opnemen, herhaalt u de opdracht --add (bijvoorbeeld --add Workload1 --add Workload2). Voor fijnmazige controle kunt u ;includeRecommended of ;includeOptional toevoegen aan de id (bijvoorbeeld --add Workload1;includeRecommended of --add Workload2;includeRecommended;includeOptional).
--all	Optionele: tijdens een installatie- of wijzigingsopdracht zorgt deze parameter ervoor dat alle werkbelastingen en onderdelen voor het product worden geïnstalleerd.
--allWorkloads	Optionele: tijdens een installatie- of wijzigingsopdracht installeert deze parameter alle workloads en onderdelen, maar geen aanbevolen of optionele onderdelen.
--includeRecommended	Optionele: tijdens een installatie- of wijzigingsopdracht bevat deze parameter de aanbevolen onderdelen voor alle geïnstalleerde werkbelastingen. Het bevat niet de optionele onderdelen. De werkbelastingen worden opgegeven met behulp van --allWorkloads of --add. Met behulp van de --includeRecommended parameter schakelt u het dialoogvenster Update-instellingen in om aanbevolen onderdelen toe te voegen voor geïnstalleerde workloads bij de update. Zie Update-instellingen aanpassen om deze instellingen te wijzigen.
--includeOptional	Optionele: tijdens een installatie- of wijzigingsopdracht bevat deze parameter de optionele onderdelen voor alle geïnstalleerde workloads. Het bevat niet de aanbevolen onderdelen. De werkbelastingen worden opgegeven met --allWorkloads of --add.
--addProductLang <language-locale>	Optionele: tijdens een installatie- of wijzigingsopdracht geeft deze herhaalbare parameter de taalpakketten voor de gebruikersinterface op die met het product moeten worden geïnstalleerd. Als deze niet aanwezig is, gebruikt de installatie het taalpakket dat overeenkomt met de landinstelling van de computer. Zie de [lijst met taalinstellingen] voor meer informatie.
--remove <one or more workload or component IDs>	Optionele: tijdens een wijzigingsopdracht geeft deze herhaalbare parameter een of meer workload- of onderdeel-id's op die moeten worden verwijderd. Het vormt een aanvulling op en gedraagt zich op dezelfde manier als de parameter --add.
--addProductLang <language-locale>	Optionele: tijdens een installatie- of wijzigingsopdracht geeft deze herhaalbare parameter de taalpakketten voor de gebruikersinterface op die met het product moeten worden geïnstalleerd. Als deze niet aanwezig is, gebruikt de installatie het taalpakket dat overeenkomt met de landinstelling van de computer. Zie voor meer informatie de sectie Lijst met taalinstellingen in dit artikel.
--removeProductLang <language-locale>	Optionele: tijdens een installatie- of wijzigingsopdracht bepaalt deze herhaalbare parameter de taalpakketten voor de gebruikersinterface die uit het product moeten worden verwijderd. Het vormt een aanvulling op en gedraagt zich op dezelfde manier als de parameter --addProductLang.
--in <path>	Optioneel: de URI of het pad naar een antwoordbestand, dat configuratie-instellingen kan bevatten.
--quiet	Optioneel: Deze parameter, wanneer deze wordt gebruikt met een opdracht, voorkomt dat een gebruikersinterface wordt weergegeven terwijl de opdracht wordt uitgevoerd. Standaardgebruikers kunnen deze parameter niet programmatisch gebruiken, ongeacht hoe het beleid AllowStandardUserControl is ingesteld.
--passive, -p	Optionele: deze parameter zorgt ervoor dat de gebruikersinterface op een niet-interactieve manier wordt weergegeven. Deze parameter is wederzijds exclusief van (en in feite overschrijft) de --quiet parameter. Standaardgebruikers kunnen deze parameter niet programmatisch gebruiken, ongeacht hoe het beleid AllowStandardUserControl is ingesteld.
--norestart	Optionele: deze parameter moet worden gekoppeld aan de parameters --passive of --quiet. Tijdens het installeren, bijwerken of wijzigen van een opdracht, zorgt het toevoegen van de parameter --norestart ervoor dat een noodzakelijke herstart wordt uitgesteld.
--force	Optioneel: met deze parameter wordt SSMS gedwongen te sluiten, zelfs als er een SSMS-proces wordt gebruikt. Het afdwingen van SSMS om te sluiten kan leiden tot verlies van werk, dus gebruik het met voorzichtigheid.
--installWhileDownloading	Optioneel: tijdens een installatie, update of wijzigingsopdracht. Met deze parameter kan SSMS het product parallel downloaden en installeren. Dit is de standaardervaring.
--downloadThenInstall	Optioneel: Tijdens een opdracht installeren, bijwerken of wijzigen dwingt deze parameter SSMS om alle bestanden te downloaden voordat u ze installeert. Het is wederzijds exclusief van de --installWhileDownloading parameter.
--nickname <name>	Optionele: tijdens een installatieopdracht definieert deze parameter de bijnaam die moet worden toegewezen aan een geïnstalleerd product. De bijnaam mag niet langer zijn dan 10 tekens.
--removeOos true	Optionele: Tijdens een opdracht voor installeren, bijwerken of wijzigen, geeft deze parameter, gevolgd door true of false, aan het Installatieprogramma van Visual Studio aan of alle geïnstalleerde onderdelen moeten worden verwijderd die zijn overgezet naar een status buiten de ondersteuning. Dit gedrag is van toepassing op één gebeurtenis. Als u dit gedrag permanent wilt maken, past u deze parameter toe op de modifySettings opdracht, die later wordt beschreven of configureert u het removeOOS globale beleid. Deze parameter is handig om de machine veilig te houden.
--config <path to *.vsconfig file>	Optionele: tijdens een installatie- of wijzigingsbewerking kunt u een configuratiebestand doorgeven met behulp van de parameter --config om de werkbelastingen, onderdelen of extensies op te geven die moeten worden toegevoegd op basis van een eerder opgeslagen installatieconfiguratiebestand. Deze bewerking is alleen additief; er wordt niets verwijderd dat niet is opgegeven in het bestand. Het installatieprogramma voegt ook geen items toe die zijn opgegeven in het configuratiebestand dat niet van toepassing is op het product. Geef het volledig gekwalificeerde pad naar het configuratiebestand op. Tijdens een exportbewerking bepaalt deze parameter de locatie om het installatieconfiguratiebestand op te slaan.
--allowUnsignedExtensions	Optionele: Tijdens een installatie- of wijzigingsbewerking die in een --passive of --quiet-context wordt uitgevoerd met behulp van een --config-bestand, is deze parameter noodzakelijk om extensies zonder digitale handtekening te laden wanneer ze in het configuratiebestand zijn gespecificeerd.
--installerOnly	Optioneel: Tijdens een installatie- of updatebewerking geeft deze parameter aan dat het Installatieprogramma van Visual Studio alleen zichzelf (het installatieprogramma) en niet het SSMS-product moet installeren. De functionaliteit is gelijk aan de parameter --update, maar intuïtiever. Bedoeld voor gebruik bij het voorbereiden en vooraf configureren van clientcomputers.
--help, --?, -h, -?	Geeft een offlineversie van dit artikel weer.

Indelingsopdracht en opdrachtregelparameters

Alle bewerkingen voor indelingsbeheer, zoals het maken of bijwerken van een indeling, worden uitgevoerd met behulp van het uitvoerbare bootstrapper-bestand. Bij deze bewerkingen wordt ervan uitgegaan dat de opdracht de standaardinstallatie is (leeg). U moet alle indelingsbeheerbewerkingen starten met de vereiste --layout initiële parameter. In de volgende tabel worden de andere parameters beschreven die u kunt gebruiken om een indeling te maken of bij te werken met behulp van de opdrachtregel.

indelingsparameters	Beschrijving
--layout <dir>	Hiermee specificeert u een map om een offline-installatiecache te maken of bij te werken.
--lang <one or more language-locales>	Optioneel: wordt gebruikt --layout voor het voorbereiden van een offline-installatiecache met resourcepakketten, in een of meer opgegeven talen. Zie voor meer informatie de sectie Lijst met taalinstellingen in dit artikel.
--add <one or more workload or component IDs>	Optioneel: een of meer workload- of component-id's die moeten worden toegevoegd. De vereiste onderdelen van het artefact worden geïnstalleerd, maar niet de aanbevolen of optionele onderdelen. U kunt meer onderdelen wereldwijd beheren met --includeRecommended en --includeOptional. Voor fijnmazige controle kunt u ;includeRecommended of ;includeOptional toevoegen aan de id (bijvoorbeeld --add Workload1;includeRecommended of --add Workload2;includeOptional). Opmerking: Als u gebruikt --add, worden alleen de opgegeven workloads en onderdelen en de bijbehorende afhankelijkheden gedownload. Als u --add niet specificeert, worden alle workloads en componenten gedownload naar de lay-out.
--includeRecommended	Optionele: bevat de aanbevolen onderdelen voor alle geïnstalleerde workloads, maar niet voor de optionele onderdelen. De werkbelastingen worden opgegeven met --allWorkloads of --add.
--includeOptional	Optionele: bevat de aanbevolen en optionele onderdelen voor alle workloads die in de indeling worden opgenomen. De werkbelastingen worden opgegeven met --add.
--wait	Optionele: het proces wacht totdat de installatie is voltooid voordat een afsluitcode wordt geretourneerd. wait is handig bij het automatiseren van installaties waarbij moet worden gewacht tot de installatie is voltooid om de retourcode van die installatie af te handelen. De parameter --wait kan alleen worden doorgegeven aan de bootstrapper; het installatieprogramma (setup.exe) ondersteunt deze niet. Het is handig bij het bijwerken van indelingen.
--config <path to *.vsconfig file>	Optioneel: Indien aanwezig, gebruikt SSMS de inhoud van het configuratiebestand om uw indeling te configureren. Zorg ervoor dat u het volledig gekwalificeerde pad naar het configuratiebestand opgeeft.
--noWeb	Optioneel: Indien aanwezig, gebruikt SSMS setup de bestanden in uw indelingsmap om SSMS te installeren en worden er geen pakketten van internet gedownload. Als een gebruiker onderdelen probeert te installeren die niet in de indeling zijn opgenomen, mislukt de installatie. Gebruik deze parameter niet als u een indeling wilt implementeren die wordt gehost op een interne intranetwebsite. Belangrijk: de parameter --noWeb stopt het installatieprogramma van Visual Studio op een clientcomputer met internetverbinding niet om te controleren op updates als de client is geconfigureerd om te kijken naar door Microsoft gehoste servers voor updates. In dit geval voorkomt --noWeb dat de client de productpakketten downloadt.
--verify	Optioneel: controleer de inhoud van een indeling. Beschadigde of ontbrekende bestanden worden vermeld.
--fix	Optioneel: controleer de inhoud van een indeling. Als bestanden beschadigd zijn of ontbreken, worden ze opnieuw gedownload. Internettoegang is vereist om een indeling te herstellen.
--clean <one or more paths to catalogs>	Optioneel: hiermee verwijdert u oude versies van onderdelen uit een indeling die wordt bijgewerkt naar een nieuwere versie.

geavanceerde indelingsparameters	Beschrijving
--channelId <id>	Optioneel: De ID van het kanaal voor de instantie die moet worden geïnstalleerd, weergegeven als SSMS.22.SSMS.Release. channelId is vereist voor de installatieopdracht en genegeerd voor andere opdrachten als --installPath deze is opgegeven. Zie syntaxisvoorbeelden van --channelId.
--channelUri <uri>	Optioneel: de URI van het kanaalmanifest. Deze waarde bepaalt de bronlocatie van updates en de initiële waarde wordt geconfigureerd in het bestand van response.json de indeling. Als u geen updates wilt, --channelUri kunt u verwijzen naar een niet-bestaand bestand (bijvoorbeeld --channelUri C:\doesntExist.chman). Deze parameter kan worden gebruikt voor de installatieopdracht. Andere opdrachten negeren het.
--installChannelUri <uri>	Optionele: de URI van het kanaalmanifest dat moet worden gebruikt voor de installatie. De URI die door --channelUri is opgegeven (en die u moet opgeven wanneer --installChannelUri wordt opgegeven) wordt gebruikt om updates te detecteren. Deze parameter kan worden gebruikt voor de installatieopdracht. Andere opdrachten negeren het.
--installCatalogUri <uri>	Optionele: de URI van het catalogusmanifest dat moet worden gebruikt voor de installatie. Indien opgegeven, probeert de channel manager het catalogusmanifest van deze URI te downloaden voordat de URI in het installatiekanaalmanifest wordt gebruikt. Deze parameter ondersteunt offline-installatie, waarbij de lay-outcache wordt gemaakt met de productcatalogus die al is gedownload. Deze parameter kan worden gebruikt voor de installatieopdracht. Andere opdrachten negeren het.
--productId <id>	Optionele: de id van het product voor het exemplaar dat is geïnstalleerd. Deze parameter wordt vooraf ingevuld in normale installatievoorwaarden. De productId is Microsoft.VisualStudio.Product.SSMS.
--keepLayoutVersion	Optioneel: Pas wijzigingen toe op de indeling zonder de productversie van de indeling bij te werken.
--locale <language-locale>	Optionele: wijzig de weergavetaal van de gebruikersinterface voor het installatieprogramma zelf. De instelling blijft behouden. Zie voor meer informatie de sectie Lijst met taalinstellingen in dit artikel.
--cache	Optioneel: Indien aanwezig, worden pakketten bewaard nadat ze zijn geïnstalleerd voor volgende reparaties. Deze instelling overschrijft de globale beleidsinstelling die moet worden gebruikt voor volgende installaties, reparaties of wijzigingen. Het standaardbeleid is het opslaan van pakketten in de cache. Dit beleid wordt genegeerd voor de verwijderopdracht.
--nocache	Optioneel: Indien aanwezig, worden pakketten verwijderd nadat ze zijn geïnstalleerd of hersteld. Ze worden alleen opnieuw gedownload indien nodig en verwijderd na gebruik. Deze instelling overschrijft de globale beleidsinstelling die moet worden gebruikt voor volgende installaties, reparaties of wijzigingen. Het standaardbeleid is het opslaan van pakketten in de cache. Dit beleid wordt genegeerd voor de verwijderopdracht.
--noUpdateInstaller	Optioneel: Indien aanwezig, voorkomt u dat het installatieprogramma zichzelf bijwerkt wanneer quiet deze is opgegeven. Het installatieprogramma voert de opdracht niet uit en retourneert een niet-nul-uitgangscode als --noUpdateInstaller is opgegeven met quiet wanneer een installatieprogramma-update vereist is.
--path <name>=<path>	Optionele: wordt gebruikt om aangepaste installatiepaden voor de installatie op te geven. Ondersteunde padnamen worden gedeeld, in de cache opgeslagen en geïnstalleerd.
--path cache=<path>	Optionele: gebruikt de locatie die u opgeeft om installatiebestanden te downloaden. U kunt deze locatie alleen instellen wanneer SSMS voor het eerst wordt geïnstalleerd. Voorbeeld: --path cache="C:\SSMS\cache"
--path shared=<path>	Optioneel: bevat gedeelde bestanden voor SSMS- en Visual Studio-installaties naast elkaar. Sommige hulpprogramma's en SDK's worden geïnstalleerd op een locatie op deze schijf, terwijl andere deze instelling kunnen overschrijven en op een andere schijf installeren. Voorbeeld: --path shared="C:\VS\shared" Belangrijk: U kunt dit pad slechts één keer instellen, op de eerste keer dat SSMS of Visual Studio is geïnstalleerd.
--path install=<path>	Optionele: gelijk aan --installPath. In het bijzonder zijn --installPath "C:\SSMS" en --path install="C:\SSMS" gelijkwaardig. Gebruik slechts één van deze opdrachten tegelijk.

Opdracht- en opdrachtregelparameters ModifySettings

U kunt de update-instellingen wijzigen en de bronlocatie van updates voor een bepaald exemplaar van SSMS programmatisch configureren. U kunt deze wijziging aanbrengen met behulp van het installatieprogramma of de bootstrapper op de clientcomputer. Geef de modifySettings opdracht en het gewenste updatekanaal door.

Opdracht	Beschrijving
modifySettings	Werkwoord dat wordt gebruikt om de update-instellingen van een bepaald exemplaar van SSMS te wijzigen.

parameters modifySettings wijzigen	Beschrijving
--installPath <dir>	Aanbevolen om op te geven op welk exemplaar van SSMS moet worden gehandeld.
--newChannelUri	Vereist: de URI van het kanaalmanifest. Deze waarde geeft aan waar de volgende bronlocatie van updates zal zijn. Als u geen updates wilt, --channelUri kunt u verwijzen naar een niet-bestaand bestand (bijvoorbeeld --channelUri C:\doesNotExist.chman).
--channelUri	De URI van het vorige kanaalmanifest. Gebruik het als je de --installPath niet weet. Moet worden gebruikt om --productId het juiste exemplaar te identificeren waarop moet worden gehandeld.
--productId <id>	Gebruik deze parameter als u --channelUri specificeert. Het identificeert het juiste exemplaar waarop actie moet worden ondernomen. De productId is Microsoft.VisualStudio.Product.SSMS.
--includeRecommended	Optioneel: Tijdens een opdracht modifySettings geeft deze parameter (die het woord true of false direct erna moet hebben) het SSMS-installatieprogramma de opdracht om de functionaliteit 'aanbevolen onderdelen voor geïnstalleerde werkbelastingen bij bijwerken' uit te schakelen in het dialoogvenster 'Instelling bijwerken'.
--quiet	Optionele: met deze parameter voorkomt u dat een gebruikersinterface wordt weergegeven terwijl de opdracht wordt uitgevoerd. Niet beschikbaar om programmatisch te gebruiken door standaardgebruikers.
--removeOos true	Optioneel: Tijdens een modifySettings-opdracht geeft deze parameter aan dat het SSMS-installatieprogramma permanent moet verwijderen, of juist niet, alle geïnstalleerde onderdelen die zijn overgegaan naar een niet-ondersteunde status. Deze instelling moet het woord true of false direct daarna hebben. Deze instelling helpt de machine veilig te houden.

Voorbeelden van syntaxis:

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

Kanaalopdracht en opdrachtregelparameters verwijderen

De client slaat kanalen in de cache op die u kunt bijwerken, en na verloop van tijd kunnen ze rommel genereren. U kunt updatekanalen handmatig verwijderen door Visual Studio Installer te openen, over te schakelen naar het tabblad Beschikbaar en de X in de rechterbovenhoek van de productkaart te selecteren. U kunt kanalen (bijvoorbeeld oudere indelingslocaties) programmatisch verwijderen met behulp van de opdracht removeChannel. U kunt programmatisch uitvoeren vswhere op de clientcomputer om te bepalen welke kanalen in de cache worden opgeslagen op de clientcomputer.

Opdracht	Beschrijving
removeChannel	Opdracht om een kanaal van de clientcomputer te verwijderen.

removeChannel-parameters	Beschrijving
--channelUri	Vereist De URI van het oude kanaalmanifest.
--quiet	Optionele Met deze parameter voorkomt u dat een gebruikersinterface wordt weergegeven terwijl de opdracht wordt uitgevoerd.
--passive	Optioneel Met deze parameter wordt de parameter --quiet overschreven. Hierdoor wordt de gebruikersinterface op een niet-interactieve manier weergegeven.

Voorbeeld van syntaxis:

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

Winget gebruiken om SSMS te installeren of te wijzigen

Gebruik het hulpprogramma Windows Package Manager (winget) om SSMS programmatisch te installeren, te wijzigen of bij te werken op uw computer, samen met andere pakketten die door winget worden beheerd.

Winget installeert standaard alleen de SSMS-kernworkload.

Voorbeeld van syntaxis:

winget install Microsoft.SQLServerManagementStudio.22

Visual Studio Installer-bewerkingen vereisen momenteel beheerdersbevoegdheden, dus winget vraagt u om uw bevoegdheden zo nodig te verhogen om de opdracht te voltooien. U moet SSMS ook sluiten als u deze naar de nieuwste versie wilt upgraden.

Lijst met workload-id's en onderdeel-id's

Zie Workload- en onderdeel-id's voor SQL Server Management Studio voor een lijst met workload- en onderdeel-id's, gesorteerd per SSMS-product.

Lijst van taalgebieden

De volgende tabel bevat de taallokalen die u kunt gebruiken met de --addProductLang en --removeProductLang parameters.

Taalgebied	Taal
cs-cz	Tsjechisch
de-de	Duits
en-us	Engels
es-es	Spaans
fr-fr	Frans
it-it	Italiaans
ja-jp	De Japanse taal
ko-kr	Koreaans
pl-pl	Pools
pt-br	Portugees - Brazilië
ru-ru	Russisch
tr-tr	Turkse taal
zh-cn	Chinees - Vereenvoudigd
zh-tw	Chinees - traditioneel

Foutcodes

Afhankelijk van het resultaat van de bewerking is de omgevingsvariabele %ERRORLEVEL% ingesteld op een van de volgende waarden:

Waarde	Resultaat
0	De bewerking is voltooid
740	Verhoging vereist
1001	Het installatieproces van Visual Studio wordt uitgevoerd
1003	SSMS wordt gebruikt
1602	Bewerking is geannuleerd
1618	Een andere installatie die wordt uitgevoerd
1641	De bewerking is voltooid en opnieuw opstarten is gestart
3010	De bewerking is voltooid, maar de installatie vereist opnieuw opstarten voordat deze kan worden gebruikt
5003	Bootstrapper kan het installatieprogramma niet downloaden
5004	Bewerking is geannuleerd
5005	Fout bij het parseren van de opdrachtregel van de Bootstrapper
5007	Bewerking is geblokkeerd: de computer voldoet niet aan de vereisten
8001	Fout bij ARM-machinecontrole
8002	Fout bij het vooraf controleren van het downloaden op de achtergrond
8003	Selecteerbare fout bij gebrek aan ondersteuning
8004	Fout in doelmap
8005	Fout bij het verifiëren van bronpayloads
8006	SSMS-processen die actief zijn
8010	Besturingssysteem wordt niet ondersteund. Raadpleeg de systeemvereisten.
-1073720687	Connectiviteitsfout
-1073741510	Microsoft Visual Studio Installer is beëindigd (door de gebruiker of het externe proces)
Overige (bijvoorbeeld: -1, 1, 1603	Er is een fout opgetreden: controleer de logboeken voor meer informatie

Elke bewerking genereert verschillende logboekbestanden in de %TEMP% map die de voortgang van de installatie aangeven. Sorteer de map op datum en zoek naar bestanden die beginnen met ssms_bootstrapper, ssms_clienten ssms_setup voor de bootstrapper, de installatie-app en de installatie-engine.

Ondersteuning en probleemoplossing

Soms gaan er dingen mis. Als uw SSMS-installatie mislukt, raadpleegt u Installatie- en upgradeproblemen voor SQL Server Management Studio oplossen voor stapsgewijze instructies.

U kunt verwijzen naar de SSMS Developer Community-site voor andere bekende problemen (filteren op Hulpprogramma's onder Groepen) en feedback geven aan het productteam.

Verwante inhoud

• Een offline-installatie van SQL Server Management Studio maken
• Workload- en onderdeel-id's voor SQL Server Management Studio