Delen via

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.

De volgende opdrachtregelopdrachten en -parameters kunnen worden gebruikt met de volgende uitvoerbare bestanden of programma's:

  • De setup bootstrapper, het kleine (~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.0.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 moet altijd worden gelezen als 'nieuwste onderhoudsversie van wat is gespecificeerd', en het kanaal is Release, tenzij 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 de SSMS-bootstrapper of het installatieprogramma programmatisch wordt aangeroepen om het product te installeren of een indeling te 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 moet plaatsvinden.

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. U kunt het beste koppelen met --installPath parameters, zodat dit expliciet is welk exemplaar van SSMS u configureert. 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 --includeRecommended en/of --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 --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. Niet beschikbaar voor programmatisch gebruik door standaardgebruikers, ongeacht hoe het AllowStandardUserControl-beleid 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. Ook niet beschikbaar om programmatisch te gebruiken door standaardgebruikers, 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. 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. Items die zijn opgegeven in het configuratiebestand die niet van toepassing zijn op het product, worden ook niet toegevoegd. U wordt ten zeerste aangeraden het volledig gekwalificeerde pad naar het configuratiebestand op te geven. 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 indelingsbeheerbewerkingen, zoals het maken of bijwerken van een indeling, worden uitgevoerd met behulp van de bootstrapper exe en gaan ervan uit dat de opdracht de standaardinstallatie is (leeg). Alle indelingsbeheerbewerkingen moeten beginnen 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 met --layout om een offline-installatiecache met resourcepakketten in een of meer opgegeven talen voor te bereiden. 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 globaal beheren met behulp van --includeRecommended en/of --includeOptional. Voor fijnmazige controle kunt u ;includeRecommended of ;includeOptional toevoegen aan de id (bijvoorbeeld --add Workload1;includeRecommended of --add Workload2;includeOptional).

Opmerking: als --add wordt gebruikt, worden alleen de opgegeven werkbelastingen en onderdelen en de bijbehorende afhankelijkheden gedownload. Als --add niet is opgegeven, worden alle workloads en onderdelen gedownload naar de layout.
--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 updates niet zijn gewenst, --channelUri kan dit verwijzen naar een niet-bestaand bestand (bijvoorbeeld --channelUri C:\doesntExist.chman). Deze parameter kan worden gebruikt voor de installatieopdracht; andere opdrachten negeren.
--installChannelUri <uri> Optionele: de URI van het kanaalmanifest dat moet worden gebruikt voor de installatie. De URI die is opgegeven door --channelUri (die moet worden opgegeven wanneer --installChannelUri is opgegeven) wordt gebruikt om updates te detecteren. Deze parameter kan worden gebruikt voor de installatieopdracht; andere opdrachten negeren.
--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 wordt gebruikt ter ondersteuning van 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.
--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 Optionele: Indien aanwezig, worden de pakketten bewaard na installatie voor volgende reparaties. Dit 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 Optionele: indien aanwezig, worden pakketten verwijderd nadat ze zijn geïnstalleerd of hersteld. Ze worden alleen opnieuw gedownload als dat nodig is en opnieuw worden verwijderd na gebruik. Dit 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. Deze locatie kan alleen worden ingesteld 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: dit pad kan slechts één keer worden ingesteld en 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. Slechts één van deze opdrachten kan tegelijk worden gebruikt.

Opdracht- en opdrachtregelparameters ModifySettings

U kunt de update-instellingen wijzigen en de bronlocatie van updates voor een bepaald exemplaar van SSMS programmatisch configureren. Deze wijziging kan worden uitgevoerd met behulp van het installatieprogramma of de bootstrapper op de clientcomputer en het doorgeven van de opdracht modifySettings en het gewenste updatekanaal.

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 updates niet zijn gewenst, --channelUri kan dit verwijzen naar een niet-bestaand bestand (bijvoorbeeld --channelUri C:\doesNotExist.chman).
--channelUri De URI van het vorige kanaalmanifest. Kan worden gebruikt als het --installPath niet bekend is. Moet worden gebruikt om --productId het juiste exemplaar te identificeren waarop moet worden gehandeld.
--productId <id> Moet worden gebruikt als --channelUri is gespecificeerd en wordt gebruikt om het juiste exemplaar te identificeren 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

Kanalen die beschikbaar zijn voor updates worden in de cache van de client opgeslagen en kunnen na verloop van tijd rommel genereren. U kunt updatekanalen handmatig verwijderen door het Visual Studio-installatieprogramma weer te geven, 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

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

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. SSMS moet ook worden gesloten 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 taalinstellingen die kunnen worden gebruikt 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 of probleemoplossing

Soms kan het fout gaan. 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

  • Last updated on