Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Si applica a:
SQL ServerDatabase SQL di AzureIstanza gestita di SQL di AzureAzure Synapse Analytics
SQL Server Management Studio 21 è uno strumento potente per la gestione di istanze di SQL Server, database SQL di Azure e istanze gestite di SQL di Azure. Questo articolo fornisce istruzioni dettagliate su come usare i parametri della riga di comando per installare SQL Server Management Studio 21, consentendo un processo di installazione più personalizzato e automatizzato. Se si installa SQL Server Management Studio 21 per la prima volta o si aggiorna un'installazione esistente, queste istruzioni forniscono i passaggi necessari per raggiungere gli obiettivi.
Parametri della riga di comando
Quando si installa SQL Server Management Studio (SSMS) a livello di codice o da un prompt dei comandi, è possibile usare vari parametri della riga di comando per controllare o personalizzare l'installazione per eseguire le azioni seguenti:
- Avviare l'installazione nel client con determinate opzioni e comportamenti pre-selezionati.
- Automatizzare il processo di installazione o aggiornamento.
- Creare o gestire un layout di rete dei file di prodotto per l'installazione o l'aggiornamento dei computer client.
I verbi e i parametri della riga di comando seguenti possono essere usati con i seguenti file eseguibili o programmi:
- Programma di avvio automatico di installazione, ovvero il file piccolo (~5 MB) (ad esempio ,
vs_SSMS.exe) che avvia il processo di download e l'installazione iniziale. - Il programma di installazione di Visual Studio che potrebbe essere già installato nel computer e si trova nella cartella
C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe. È necessario avviare il programma di installazione a livello di codice da una directory diversa in cui risiede il programma di installazione. Il programma di installazione viene in genere usato per aggiornare o modificare i comandi.
Non tutti i comandi o i parametri funzionano in ognuna di queste situazioni e vengono documentate eventuali avvertenze o eccezioni speciali. Inoltre, in alcuni scenari potrebbe non avere accesso a tutti questi eseguibili descritti in precedenza. Ad esempio, i computer client potrebbero avere il programma di installazione disponibile solo per l'esecuzione a livello di codice se SSMS è stato installato tramite un layout.
Per ottenere i più recenti programmi di avvio per SQL Server Management Studio 21 che consentono di installare sempre la versione più recente del canale selezionato, scaricare uno dei file nella tabella seguente. In alternativa, per installare una versione specifica o un canale specifico di SQL Server Management Studio 21, vedere Cronologia delle versioni per SQL Server Management Studio. Questo articolo include collegamenti ai programma di avvio automatico delle versioni fisse per ogni versione di manutenzione.
| Canale | Versione | Programma di avvio automatico |
|---|---|---|
| Rilascio | 21.0.0 | SQL Server Management Studio |
Suggerimento
Se in precedenza è stato scaricato un file del programma di avvio automatico, è possibile verificare la versione installata prima di provare a eseguire l'installazione. Aprire Esplora file, fare clic con il pulsante destro del mouse sul file del programma di avvio automatico, scegliere Proprietà e quindi selezionare la scheda Dettagli . Il campo Versione prodotto descrive il canale e la versione installati dal programma di avvio automatico. Il numero di versione deve essere sempre letto come "versione di manutenzione più recente di ciò che viene specificato" e il canale è Release a meno che non sia specificato in modo esplicito. Un bootstrapper con una versione del prodotto che riporta SQL Server Management Studio 21 installa l'ultima versione di SQL Server Management Studio 21 dal canale Release.
Installare, aggiornare, modificare, ripristinare, disinstallare ed esportare comandi e parametri della riga di comando
Quando il programma di avvio automatico di SSMS o il programma di installazione viene richiamato a livello di codice, per installare il prodotto o per mantenere un layout:
- Il primo parametro è il comando (verbo) che descrive l'operazione da eseguire.
- I parametri della riga di comando facoltativi successivi, tutti preceduti da due trattini (
--), definiscono ulteriormente il modo in cui deve verificarsi l'operazione.
Tutti i parametri della riga di comando di SSMS non fanno distinzione tra maiuscole e minuscole.
Esempio di sintassi: vs_SSMS.exe [command] <optional parameters>...
| Comando | Descrizione |
|---|---|
| (vuoto) | Il comando predefinito installa il prodotto e viene usato per tutte le operazioni di manutenzione del layout. |
modify |
Modifica un prodotto installato. |
update |
Aggiorna un prodotto installato. |
updateall |
Aggiorna tutti i prodotti installati in ordine sequenziale. Funziona con i parametri --quiet e --passive. |
repair |
Ripristina un prodotto installato. |
uninstall |
Disinstalla un prodotto installato. |
export |
Esporta la configurazione dell'installazione in un file di *.vsconfig. |
Importante
Quando si specificano più carichi di lavoro, componenti o lingue distinti, è necessario ripetere l'opzione della --add riga di comando o --remove per ogni elemento.
| Parametri | Descrizione |
|---|---|
--installPath <dir> |
Per il comando di installazione predefinito, questo parametro è facoltativo e descrive dove è installata l'istanza nel computer client. Per altri comandi come l'aggiornamento o la modifica, questo parametro è Obbligatorio e indica la directory di installazione su cui l'istanza deve agire. |
--productId <id> |
facoltativo: ID dell'istanza del prodotto modificato e usato con --channelId. Il productId è Microsoft.VisualStudio.Product.SSMS. |
--channelUri |
facoltativo: nel corso di un comando di aggiornamento, è possibile fornire un nuovo --channelUri per modificare il percorso delle impostazioni di aggiornamento. Si consiglia di associare il parametro --installPath così che sia esplicita l'istanza di SSMS che si sta configurando. Consulta esempi di sintassi di --channelUri |
--channelId <id> |
ID del canale, ad esempio, SSMS.21.SSMS.Preview.
channelId è necessario per le operazioni di modifica, insieme a --productId o --installPath. |
--add <one or more workload or component IDs> |
Facoltativo: durante un comando di installazione o modifica, questo parametro ripetibile specifica uno o più ID del carico di lavoro o dei componenti da aggiungere. I componenti necessari dell'artefatto vengono installati, ma non i componenti consigliati o facoltativi. È possibile controllare altri componenti a livello globale usando parametri --includeRecommended e/o --includeOptional. Per includere più carichi di lavoro o componenti, ripetere il comando --add ( ad esempio, --add Workload1 --add Workload2). Per un controllo più granulare, è possibile aggiungere ;includeRecommended o ;includeOptional all'ID, ad esempio --add Workload1;includeRecommended o --add Workload2;includeRecommended;includeOptional. |
--all |
facoltativo: durante un comando di installazione o modifica, questo parametro determina l'installazione di tutti i carichi di lavoro e i componenti per il prodotto. |
--allWorkloads |
Facoltativo: durante un comando di installazione o modifica, questo parametro installa tutti i carichi di lavoro e i componenti, ma non i componenti consigliati o facoltativi. |
--includeRecommended |
facoltativo: durante un comando di installazione o modifica, questo parametro include i componenti consigliati per tutti i carichi di lavoro installati. Non include i componenti facoltativi. I carichi di lavoro vengono specificati con --allWorkloads o --add. Usando il parametro , si abilita la --includeRecommended finestra di dialogo Impostazioni di aggiornamento per aggiungere i componenti consigliati per i carichi di lavoro installati all'aggiornamento. Vedere Personalizzare le impostazioni di aggiornamento per modificare questa impostazione. |
--includeOptional |
Facoltativo: durante un comando di installazione o modifica, questo parametro include i componenti facoltativi per tutti i carichi di lavoro installati. Non include i componenti consigliati. I carichi di lavoro vengono specificati con --allWorkloads o --add. |
--addProductLang <language-locale> |
Facoltativo: durante un comando di installazione o modifica, questo parametro ripetibile specifica i Language Pack dell'interfaccia utente che devono essere installati con il prodotto. Se non è presente, l'installazione usa il Language Pack corrispondente alle impostazioni locali del computer. Per altre informazioni, vedere [Elenco delle impostazioni locali della lingua] |
--remove <one or more workload or component IDs> |
Facoltativo: durante un comando di modifica, questo parametro ripetibile specifica uno o più ID del carico di lavoro o dei componenti da rimuovere. Si integra e si comporta in modo analogo al parametro --add. |
--addProductLang <language-locale> |
Facoltativo: durante un comando di installazione o modifica, questo parametro ripetibile specifica i Language Pack dell'interfaccia utente che devono essere installati con il prodotto. Se non è presente, l'installazione usa il Language Pack corrispondente alle impostazioni locali del computer. Per altre informazioni, vedere la sezione Elenco delle impostazioni locali della lingua in questo articolo. |
--removeProductLang <language-locale> |
Facoltativo: durante un comando di installazione o modifica, questo parametro ripetibile determina i Language Pack dell'interfaccia utente che devono essere rimossi dal prodotto. Si integra e si comporta in modo analogo al parametro --addProductLang. |
--in <path> |
Facoltativo: l'URI o il percorso di un file di risposta, che può contenere le impostazioni di configurazione. |
--quiet |
Facoltativo: usato con qualsiasi comando, questo parametro impedisce la visualizzazione di qualsiasi interfaccia utente durante l'esecuzione del comando. Non disponibile per l'uso a livello di codice da parte degli utenti standard indipendentemente dalla modalità di impostazione del criterio AllowStandardUserControl. |
--passive, -p |
Facoltativo: questo parametro determina la visualizzazione dell'interfaccia utente in modo non interattivo. Questo parametro è mutuamente esclusivo rispetto al parametro --quiet (e in effetti lo sostituisce). Inoltre, non è disponibile per l'utilizzo programmatico da parte degli utenti standard, indipendentemente da come viene impostato il criterio AllowStandardUserControl . |
--norestart |
facoltativo: questo parametro deve essere associato ai parametri --passive o --quiet. Durante un'installazione, un aggiornamento o un comando di modifica, l'aggiunta del parametro --norestart ritarda il riavvio necessario. |
--force |
Facoltativo: questo parametro forza la chiusura di SSMS anche se è in uso un processo SSMS. Forzare la chiusura di SSMS potrebbe causare la perdita di lavoro, quindi usarlo con cautela. |
--installWhileDownloading |
Facoltativo: durante un comando di installazione, aggiornamento o modifica, questo parametro consente a SSMS di scaricare e installare il prodotto in parallelo. È l'esperienza predefinita. |
--downloadThenInstall |
Facoltativo: durante un comando di installazione, aggiornamento o modifica, questo parametro forza SSMS a scaricare tutti i file prima di installarli. Si escludono a vicenda dal --installWhileDownloading parametro . |
--nickname <name> |
Facoltativo: durante un comando di installazione, questo parametro definisce il nome alternativo da assegnare a un prodotto installato. Il nome alternativo non può contenere più di 10 caratteri. |
--removeOos true |
facoltativo: durante un comando di installazione, aggiornamento o modifica, questo parametro, seguito da true o false, indica al programma di installazione di Visual Studio se rimuovere tutti i componenti installati passati a uno stato di supporto non supportato. Questo comportamento è applicabile per un singolo evento. Se si vuole rendere persistente questo comportamento, applicare questo parametro al modifySettings comando, descritto più avanti o configurare i removeOOS criteri globali. Utile per garantire la sicurezza del computer. |
--config <path to *.vsconfig file> |
Facoltativo: durante un'operazione di installazione o modifica, è possibile passare un file di configurazione usando il parametro --config per specificare i carichi di lavoro, i componenti o le estensioni da aggiungere in base a un file di configurazione di installazione salvato in precedenza. Questa operazione è di tipo additivo; non rimuove nulla che non sia specificato nel file. Inoltre, gli elementi specificati nel file di configurazione che non si applicano al prodotto non vengono aggiunti. Si consiglia vivamente di specificare il percorso completo del file di configurazione. Durante un'operazione di esportazione, questo parametro determina il percorso in cui salvare il file di configurazione dell'installazione. |
--allowUnsignedExtensions |
facoltativo: durante un'operazione di installazione o modifica eseguita in un contesto di --passive o di --quiet usando un file --config, se nel file di configurazione sono specificate estensioni, questo parametro è necessario per caricare le estensioni senza firma digitale. |
--installerOnly |
Facoltativo: durante un'operazione di installazione o aggiornamento, questo parametro indica al programma di installazione di Visual Studio di installare solo se stesso (il programma di installazione) e non il prodotto SSMS. La funzionalità è equivalente al parametro --update, ma più intuitivo. Progettato per essere usato durante la preparazione e la preconfigurazione dei computer client. |
--help, --?, -h, -? |
Visualizza una versione offline di questo articolo. |
Comandi di layout e parametri della riga di comando
Tutte le operazioni di gestione del layout, ad esempio la creazione o l'aggiornamento di un layout, vengono eseguite usando l'exe del programma di avvio automatico e presuppongono che il comando sia l'installazione predefinita (vuota). Tutte le operazioni di gestione del layout devono iniziare con il parametro iniziale necessario --layout. Nella tabella seguente vengono descritti gli altri parametri che è possibile usare per creare o aggiornare un layout tramite la riga di comando.
| Parametri di layout | Descrizione |
|---|---|
--layout <dir> |
Specifica una directory per creare o aggiornare una cache di installazione offline. |
--lang <one or more language-locales> |
facoltativo: utilizzato con --layout per preparare una cache di installazione offline con i pacchetti di risorse in una o più lingue specificate. Per altre informazioni, vedere la sezione Elenco delle impostazioni locali della lingua in questo articolo. |
--add <one or more workload or component IDs> |
Facoltativo: uno o più ID di carichi di lavoro o di componenti da aggiungere. I componenti necessari dell'artefatto vengono installati, ma non i componenti consigliati o facoltativi. È possibile controllare più componenti a livello globale usando --includeRecommended e/o --includeOptional. Per un controllo più granulare, è possibile aggiungere ;includeRecommended o ;includeOptional all'ID, ad esempio --add Workload1;includeRecommended o --add Workload2;includeOptional.Nota: se si usa --add, vengono scaricati solo i carichi di lavoro e i componenti specificati e le relative dipendenze. Se --add non viene specificato, tutti i carichi di lavoro e i componenti vengono scaricati nel layout. |
--includeRecommended |
Facoltativo: include i componenti consigliati per tutti i carichi di lavoro installati, ma non i componenti facoltativi. I carichi di lavoro vengono specificati con --allWorkloads o --add. |
--includeOptional |
facoltativo: include i componenti facoltativi consigliati e per i carichi di lavoro inclusi nel layout. I carichi di lavoro vengono specificati con --add. |
--wait |
facoltativo: il processo attende il completamento dell'installazione prima di restituire un codice di uscita.
wait è utile quando si automatizzano le installazioni in cui è necessario attendere il completamento dell'installazione per gestire il codice restituito da tale installazione. Il parametro --wait può essere passato solo al programma di avvio automatico; il programma di installazione (setup.exe) non lo supporta. È utile quando si aggiornano i layout. |
--config <path to *.vsconfig file> |
Facoltativo: se presente, SSMS usa il contenuto del file di configurazione per configurare il layout. Assicurati di specificare il percorso completo del file di configurazione. |
--noWeb |
Facoltativo: se presente, il programma di installazione di SSMS usa i file nella directory di layout per installare SSMS e non scarica alcun pacchetto dal Web. Se un utente tenta di installare componenti che non si trovano nel layout, l'installazione non riesce. Non usare questo parametro se si sta provando a distribuire un layout ospitato in un sito Web Intranet interno. importante: il parametro --noWeb non impedisce al programma di installazione di Visual Studio in un computer client connesso a Internet di verificare la disponibilità di aggiornamenti se il client è configurato per esaminare i server ospitati da Microsoft per gli aggiornamenti. In questo caso, --noWeb impedisce semplicemente al client di scaricare i pacchetti del prodotto. |
--verify |
Facoltativo: verificare il contenuto di un layout. Tutti i file danneggiati o mancanti sono elencati. |
--fix |
Facoltativo: verificare il contenuto di un layout. Se i file sono danneggiati o mancanti, vengono scaricati di nuovo. Per correggere un layout, è necessario l'accesso a Internet. |
--clean <one or more paths to catalogs> |
Facoltativo: rimuove le versioni precedenti dei componenti da un layout aggiornato a una versione più recente. |
| parametri di layout avanzati | Descrizione |
|---|---|
--channelId <id> |
Facoltativo: l'ID del canale dell'istanza da installare, rappresentato come SSMS.21.SSMS.Preview.
channelId è obbligatorio per il comando di installazione e ignorato per altri comandi, se --installPath specificato. Per altre informazioni, vedere esempi di sintassi di --channelId. |
--channelUri <uri> |
opzionale: l'URI del manifesto del canale. Questo valore regola il percorso di origine degli aggiornamenti e il valore iniziale viene configurato nel file del response.json layout. Se gli aggiornamenti non sono desiderati, --channelUri può puntare a un file inesistente , ad esempio --channelUri C:\doesntExist.chman. Questo parametro può essere usato per il comando di installazione; altri comandi lo ignorano. |
--installChannelUri <uri> |
facoltativo: URI del manifesto del canale da usare per l'installazione. L'URI specificato da --channelUri (che deve essere specificato quando viene specificato --installChannelUri) viene usato per rilevare gli aggiornamenti. Questo parametro può essere usato per il comando di installazione; altri comandi lo ignorano. |
--installCatalogUri <uri> |
Opzionale: URI del manifesto del catalogo da usare per l'installazione. Se specificato, il channel manager tenta di scaricare il manifesto del catalogo da questo URI prima di usare l'URI nel manifesto del canale d'installazione. Questo parametro viene usato per supportare l'installazione offline, in cui viene creata la cache di layout con il catalogo prodotti già scaricato. Questo parametro può essere usato per il comando di installazione; altri comandi lo ignorano. |
--productId <id> |
Opzionale: L'ID del prodotto per l'istanza che è installata. Questo parametro è prepopolato in condizioni di installazione normali. Il productId è Microsoft.VisualStudio.Product.SSMS. |
--keepLayoutVersion |
Facoltativo: applica modifiche al layout senza aggiornare la versione del prodotto inclusa nel layout. |
--locale <language-locale> |
Facoltativo: modificare la lingua di visualizzazione dell'interfaccia utente per il programma di installazione stesso. L'impostazione è stata salvata. Per altre informazioni, vedere la sezione Elenco delle impostazioni locali della lingua in questo articolo. |
--cache |
Facoltativo: se presente, i pacchetti software verranno conservati dopo l'installazione per le riparazioni successive. In questo modo viene ignorata l'impostazione dei criteri globale da usare per le installazioni, le riparazioni o le modifiche successive. Il criterio predefinito consiste nel memorizzare nella cache i pacchetti. Questa operazione viene ignorata per il comando di disinstallazione. |
--nocache |
Facoltativo: se presente, i pacchetti verranno eliminati dopo l'installazione o il ripristino. Verranno scaricati di nuovo solo se necessario ed eliminati nuovamente dopo l'uso. In questo modo viene ignorata l'impostazione dei criteri globale da usare per le installazioni, le riparazioni o le modifiche successive. Il criterio predefinito consiste nel memorizzare nella cache i pacchetti. Questa operazione viene ignorata per il comando di disinstallazione. |
--noUpdateInstaller |
Facoltativo: se presente, impedisce al programma di installazione di eseguire l'aggiornamento quando quiet viene specificato. Il programma di installazione non esegue il comando e restituisce un codice di uscita diverso da zero se --noUpdateInstaller viene specificato con quiet quando è necessario aggiornare il programma di installazione. |
--path <name>=<path> |
Facoltativo: usato per specificare percorsi di installazione personalizzati per l'installazione. I nomi di percorso supportati sono condivisi, memorizzati nella cache e installati. |
--path cache=<path> |
Facoltativo: usa il percorso specificato per scaricare i file di installazione. Questo percorso può essere impostato solo la prima volta che viene installato SSMS. Esempio: --path cache="C:\SSMS\cache" |
--path shared=<path> |
Facoltativo: contiene file condivisi per le installazioni side-by-side di SSMS e Visual Studio. Alcuni strumenti e SDK vengono installati in un percorso in questa unità, mentre altri potrebbero eseguire l'override di questa impostazione e installarli in un'altra unità. Esempio: --path shared="C:\VS\shared"Importante: questa impostazione può essere impostata una sola volta e alla prima installazione di SSMS o Visual Studio. |
--path install=<path> |
facoltativo: equivalente a –-installPath. In particolare, --installPath "C:\SSMS" e --path install="C:\SSMS" sono equivalenti. È possibile usare solo uno di questi comandi alla volta. |
Parametri del comando ModifySettings e della riga di comando
È possibile modificare le impostazioni di aggiornamento e configurare a livello di codice il percorso di origine degli aggiornamenti per una determinata istanza di SSMS usando il programma di installazione o il programma di avvio automatico nel computer client e passando il comando modifySettings e il canale di aggiornamento desiderato.
| Comando | Descrizione |
|---|---|
modifySettings |
Verbo usato per modificare le impostazioni di aggiornamento di una particolare istanza di SSMS. |
| parametri di modifica impostazioni | Descrizione |
|---|---|
--installPath <dir> |
È consigliabile usare per specificare l'istanza di SSMS su cui intervenire. |
--newChannelUri |
Obbligatorio: URI del manifesto del canale. Questo valore specifica dove sarà la prossima posizione di origine degli aggiornamenti. Se gli aggiornamenti non sono desiderati, --channelUri può puntare a un file inesistente , ad esempio --channelUri C:\doesNotExist.chman. |
--channelUri |
URI del manifesto del vecchio canale. Può essere usato se --installPath non è noto. Deve essere usato con --productId per identificare l'istanza corretta su cui agire. |
--productId <id> |
Deve essere usato se --channelUri è specificato e viene usato per identificare l'istanza corretta su cui agire. Il productId è Microsoft.VisualStudio.Product.SSMS. |
--includeRecommended |
Facoltativo: durante un comando modifySettings, questo parametro (che deve avere la parola true o false immediatamente dopo di esso) indica al programma di installazione di SSMS di disabilitare la funzionalità "aggiungere i componenti consigliati per i carichi di lavoro installati all'aggiornamento" nella finestra di dialogo Aggiorna impostazione. |
--quiet |
Facoltativo: questo parametro impedisce la visualizzazione di qualsiasi interfaccia utente durante l'esecuzione del comando. Non disponibile per l'uso a livello di codice da parte di utenti standard. |
--removeOos true |
Facoltativo: durante un comando modifySettings, questo parametro (che deve avere la parola true o false immediatamente dopo di esso) indica al programma di installazione di SSMS di rimuovere in modo permanente (o non rimuovere) tutti i componenti installati che hanno eseguito la transizione a uno stato di supporto non supportato. Utile per garantire la sicurezza del computer. |
Esempi di sintassi:
C:\>"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modifySettings --installPath "C:\Program Files\Microsoft SQL Server Management Studio 21\Release" --newChannelUri https://aka.ms/ssms/21/release/channel --removeOos true
C:\>"C:\Program Files\Microsoft SQL Server Management Studio 21\Release\vs_SSMS.exe" modifySettings --channelUri https://aka.ms/ssms/21/release/channel --productId Microsoft.VisualStudio.Product.Ssms --newChannelUri \\layoutserver\share\path\channelmanifest.json --removeOos true --quiet
Rimuovere i parametri del comando del canale e della riga di comando
I canali disponibili per l'aggiornamento da, vengono memorizzati nella cache nel client e nel corso del tempo possono generare confusione. È possibile rimuovere manualmente i canali di aggiornamento visualizzando il programma di installazione di Visual Studio, passando alla scheda Disponibile e selezionando nella X nell'angolo superiore destro della scheda prodotto. È possibile rimuovere i canali a livello di codice, ad esempio percorsi di layout meno recenti, usando il comando removeChannel. È possibile eseguire vswhere a livello di codice nel computer client per determinare quali canali vengono memorizzati nella cache nel computer client.
| Comando | Descrizione |
|---|---|
removeChannel |
Comando per rimuovere un canale dal computer client. |
| removeChannel parametri | Descrizione |
|---|---|
--channelUri |
Obbligatorio L'URI del manifesto del canale precedente. |
--quiet |
Facoltativo Questo parametro impedisce la visualizzazione di qualsiasi interfaccia utente durante l'esecuzione del comando. |
--passive |
Facoltativo Questo parametro esegue l'override del parametro --quiet. Fa sì che l'interfaccia utente venga visualizzata in modo non interattivo. |
Esempio di sintassi:
"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" removeChannel --channelUri "\\\\server\\share\\layoutdirectory\\ChannelManifest.json"
Usare winget per installare o modificare SSMS
È possibile usare lo strumento Gestione pacchetti windows (winget) per installare, modificare o aggiornare SSMS a livello di codice nel computer insieme ad altri pacchetti gestiti da winget.
Per impostazione predefinita, winget installa solo il carico di lavoro principale di SSMS.
Esempio di sintassi:
winget install Microsoft.SQLServerManagementStudio.21
Le operazioni del programma di installazione di Visual Studio richiedono attualmente privilegi di amministratore, quindi winget chiederà di elevare i privilegi, se necessario, per completare il comando. Inoltre, SSMS deve essere chiuso se si intende aggiornarlo alla versione più recente.
Elenco di ID dei carichi di lavoro e ID dei componenti
Per un elenco degli ID dei carichi di lavoro e dei componenti ordinati in base al prodotto SSMS, vedere ID dei carichi di lavoro e dei componenti di Visual Studio.
Elenco delle impostazioni locali della lingua
Nella tabella seguente sono elencati i locali linguistici che possono essere usati con i parametri --addProductLang e --removeProductLang.
| Lingua-locale | Lingua |
|---|---|
cs-cz |
Ceco |
de-de |
Tedesco |
en-us |
Inglese |
es-es |
Spagnolo |
fr-fr |
Francese |
it-it |
Italiano |
ja-jp |
Giapponese |
ko-kr |
Coreano |
pl-pl |
Polacco |
pt-br |
Portoghese - Brasile |
ru-ru |
Russo |
tr-tr |
Turco |
zh-cn |
Cinese - Semplificato |
zh-tw |
Cinese - Tradizionale |
Codici di errore
A seconda del risultato dell'operazione, la variabile di ambiente %ERRORLEVEL% è impostata su uno dei valori seguenti:
| Valore | Risultato |
|---|---|
| 0 | Operazione completata correttamente |
| 740 | Elevazione richiesta |
| 1001 | Il processo di installazione di Visual Studio è in esecuzione |
| 1003 | SSMS è in uso |
| 1602 | Operazione annullata |
| 1618 | Un'altra installazione in esecuzione |
| 1641 | Operazione completata correttamente e il riavvio è stato avviato |
| 3010 | Operazione completata correttamente, ma l'installazione richiede il riavvio prima di poter essere usata |
| 5003 | Il Bootstrapper non è riuscito a scaricare l'installer |
| 5004 | Operazione annullata |
| 5005 | Errore di analisi della riga di comando di Bootstrapper |
| 5007 | Operazione bloccata: il computer non soddisfa i requisiti |
| 8001 | Errore di controllo della macchina Arm |
| 8002 | Fallimento del controllo preliminare del download in background |
| 8003 | Condizione di guasto selezionabile non più supportata |
| 8004 | Errore della directory di destinazione |
| 8005 | Errore nella verifica dei payload di origine |
| 8006 | Processi di SSMS in esecuzione |
| 8010 | Sistema operativo non supportato. Fare riferimento ai requisiti di sistema. |
| -1073720687 | Errore di connettività |
| -1073741510 | Il programma di installazione di Microsoft Visual Studio è stato terminato (dall'utente o dal processo esterno) |
| Altro (ad esempio: -1, 1, 1603) |
Si è verificata una condizione di errore - controllare i log per ulteriori informazioni |
Ogni operazione genera diversi file di log nella directory %TEMP% che indicano lo stato di avanzamento dell'installazione. Ordinare la cartella in base alla data e cercare i file che iniziano con ssms_bootstrapper, ssms_cliente ssms_setup rispettivamente per il programma di avvio automatico, l'app del programma di installazione e il motore di installazione.
Supporto o risoluzione dei problemi
A volte, le cose possono andare storte. Se l'installazione di SSMS non riesce, vedere Risolvere i problemi di installazione e aggiornamento per SQL Server Management Studio per istruzioni dettagliate.
È possibile fare riferimento al sito della community degli sviluppatori di SSMS per altri problemi noti (filtro su Tooling sotto Groups) e per fornire feedback e suggerimenti al team del prodotto.