Usare i parametri della riga di comando per installare, aggiornare e gestire Visual Studio
Quando si installa Visual Studio 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 (~1 MB) (ad esempio, vs_enterprise.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. - Con un comando winget usando l'opzione --override di winget.
- Con un pacchetto di aggiornamento amministratore, disponibile per il download dal Catalogo di Microsoft Update, per aggiornare a livello di codice il layout di rete. Altre informazioni sono disponibili nell'articolo Aggiornare o modificare il layout .
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 possono avere il programma di installazione disponibile solo per l'esecuzione a livello di codice se Visual Studio è stato installato tramite un layout.
È possibile ottenere i programma di avvio automatico di Visual Studio 2019 dalla tabella seguente. In alternativa, se si vuole una versione specifica di Visual Studio 2019, vedere la pagina Versioni di Visual Studio 2019. Questa pagina include collegamenti ai programma di avvio automatico della versione fissa per la versione e l'edizione scelta di Visual Studio.
| Edizione | Programma di avvio automatico |
|---|---|
| Visual Studio 2019 Enterprise versione 16.11 | vs_enterprise.exe |
| Visual Studio 2019 Professional versione 16.11 | vs_professional.exe |
| Visual Studio 2019 Build Tools versione 16.11 | vs_buildtools.exe |
Per ottenere i programma di avvio automatico più recenti per Visual Studio 2022 che installano sempre la versione più recente del canale corrente, scaricare uno dei file nella tabella seguente. In alternativa, per installare una versione specifica o un canale specifico di Visual Studio 2022, vedere la pagina Cronologia delle versioni di Visual Studio 2022. Questa pagina include collegamenti ai programma di avvio automatico delle versioni fisse per ogni versione di manutenzione.
| Edizione | Programma di avvio automatico |
|---|---|
| Visual Studio 2022 Enterprise | vs_enterprise.exe |
| Visual Studio 2022 Professional | vs_professional.exe |
| Visual Studio 2022 Community | vs_community.exe |
| Strumenti di compilazione di Visual Studio 2022 | vs_buildtools.exe |
Suggerimento
Se in precedenza è stato scaricato un file del programma di avvio automatico e si vuole verificarne la versione, ecco come. In Windows aprire Esplora file, fare clic con il pulsante destro del mouse sul file del programma di avvio automatico, scegliere Proprietà, scegliere la scheda Dettagli e quindi visualizzare il numero di versione del prodotto. Per trovare la corrispondenza con tale numero a una versione di Visual Studio, fare riferimento alla tabella nella parte inferiore della pagina Versioni di Visual Studio 2019.
Suggerimento
Se in precedenza è stato scaricato un file del programma di avvio automatico e si vuole verificare quale versione verrà installata, ecco come. In Windows aprire Esplora file, fare clic con il pulsante destro del mouse sul file del programma di avvio automatico, scegliere Proprietà e quindi scegliere la scheda Dettagli. Il campo Versione prodotto descriverà il canale e la versione che verrà installato dal programma di avvio automatico. Il numero di versione deve sempre essere letto come "versione di manutenzione più recente di ciò che viene specificato" e il canale è Corrente, a meno che non sia specificato in modo esplicito. Quindi, un programma di avvio automatico con una versione Product di LTSC 17.0 installerà la versione di manutenzione 17.0.x più recente disponibile nel canale 17.0 LTSC. Un programma di avvio automatico con una versione del prodotto che indica semplicemente Che Visual Studio 2022 installerà la versione più recente di Visual Studio 2022 nel canale Corrente.
Installare, aggiornare, modificare, ripristinare, disinstallare ed esportare i comandi e i parametri della riga di comando
Quando si richiama il programma di avvio automatico di Visual Studio o il programma di installazione 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 Visual Studio non fanno distinzione tra maiuscole e minuscole e altri esempi sono disponibili nella pagina Esempi di parametri della riga di comando.
Esempio di sintassi: vs_enterprise.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 --quiet i parametri e --passive . |
repair |
Ripristina un prodotto installato. |
uninstall |
Disinstalla un prodotto installato. |
export |
Esporta la configurazione di installazione in un *.vsconfig file. |
Importante
Quando si specificano più carichi di lavoro 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. è productID simile a "Microsoft.VisualStudio.Product.Enterprise". |
--channelUri |
Facoltativo: durante un comando di aggiornamento, è possibile passare un nuovo --channelUri per modificare il percorso delle impostazioni di aggiornamento. È consigliabile associare il --installPath parametro in modo che sia esplicita l'istanza di Visual Studio che si sta configurando. Vedere esempi di sintassi di --channelUri |
--channelId <id> |
ID del canale, ad esempio VisualStudio.17.Release. Vedere esempi di sintassi di --channelId.
channelId è necessario per le operazioni di modifica, insieme --productID a 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. Vengono installati i componenti necessari dell'elemento, ma non i componenti consigliati o facoltativi. È possibile controllare altri componenti a livello globale usando --includeRecommended parametri 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ù capillare, è possibile aggiungere ;includeRecommended o ;includeOptional all'ID (ad esempio, --add Workload1;includeRecommended o --add Workload2;includeRecommended;includeOptional). Per altre informazioni, vedere la pagina ID dei carichi di lavoro e dei componenti. |
--all |
Facoltativo: durante un comando di installazione o modifica, questo parametro determina l'installazione di tutti i carichi di lavoro e i componenti del 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 sono specificati con --allWorkloads o --add. Si noti che usando il parametro si abiliterà la --includeRecommendedfinestra 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 sono 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 --add parametro . |
| (#list-of-language-locales) in questa pagina. | |
--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 --addProductLang parametro . |
--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 dal modo in cui è impostato il criterio AllowStandardUserControl. |
--passive, -p |
Facoltativo: questo parametro determina la visualizzazione dell'interfaccia utente in modo non interattivo. Questo parametro si escludono a vicenda dal parametro (e in effetti esegue l'override --quiet ). Inoltre, non è disponibile per l'uso a livello di codice da parte degli utenti standard indipendentemente dal modo in cui è impostato il criterio AllowStandardUserControl. |
--norestart |
Facoltativo: questo parametro deve essere associato ai --passive parametri o --quiet . Durante un'installazione, un aggiornamento o un comando di modifica, l'aggiunta del --norestart parametro ritarda qualsiasi riavvio necessario. |
--force |
Facoltativo: questo parametro impone la chiusura di Visual Studio anche se è in uso un processo di Visual Studio. Forzare la chiusura di Visual Studio potrebbe causare la perdita di lavoro, quindi usarlo con cautela. |
--installWhileDownloading |
Facoltativo: durante un comando di installazione, aggiornamento o modifica, questo parametro consente a Visual Studio di scaricare e installare il prodotto in parallelo. È l'esperienza predefinita. |
--downloadThenInstall |
Facoltativo: durante un comando di installazione, aggiornamento o modifica, questo parametro impone a Visual Studio di 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. |
--productKey |
Facoltativo: durante un comando di installazione, questo parametro definisce il codice Product Key da usare per un prodotto installato. Il codice Product Key è composto da 25 caratteri alfanumerici nel formato xxxxxxxxxxxxxxxxxxxxxxxxx. |
--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 comando modifySettings, descritto più avanti o configurare il criterio globale removeOOS. 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 --config parametro per specificare i carichi di lavoro, i componenti o le estensioni da aggiungere in base a un file di configurazione dell'installazione salvato in precedenza. Questa operazione è solo additivi; non rimuove alcun elemento non specificato nel file. Inoltre, gli elementi specificati nel file di configurazione che non si applicano al prodotto non vengono aggiunti. È consigliabile 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 --passive contesto o --quiet usando un --config file, se le estensioni sono specificate nel file di configurazione, 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 Visual Studio. La funzionalità è equivalente al --update parametro , ma più intuitiva. Destinato a essere usato durante la preparazione e la preconfigurazione dei computer client. |
--help, --?, -h, -? |
Visualizza una versione offline di questa pagina. |
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 richiesto --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. Per altre informazioni, vedere Creare un'installazione di rete di Visual Studio. |
--lang <one or more language-locales> |
Facoltativo: usato con --layout per preparare una cache di installazione offline con i pacchetti di risorse con le lingue specificate. Per altre informazioni, vedere la sezione Elenco delle impostazioni locali delle lingue in questa pagina. |
--add <one or more workload or component IDs> |
Facoltativa: uno o più ID di carichi di lavoro o componenti da aggiungere. Vengono installati i componenti necessari dell'elemento, ma non i componenti consigliati o facoltativi. È possibile controllare più componenti a livello globale usando --includeRecommended e/o --includeOptional. Per un controllo più capillare, è possibile aggiungere ;includeRecommended o ;includeOptional all'ID (ad esempio, --add Workload1;includeRecommended o --add Workload2;includeOptional). Per altre informazioni, vedere la pagina ID dei carichi di lavoro e dei componenti. Nota: se viene usato --add, vengono scaricati solo i carichi di lavoro e i componenti specificati (con le relative dipendenze). Se --add non viene specificato, tutti i carichi di lavoro e i componenti vengono scaricati nel layout. |
--includeRecommended |
Facoltativa: include i componenti consigliati per tutti i carichi di lavoro installati, ma non i componenti facoltativi. I carichi di lavoro sono specificati con --allWorkloads o --add. |
--includeOptional |
Facoltativo: include i componenti consigliati e facoltativi per tutti i carichi di lavoro inclusi nel layout. I carichi di lavoro sono 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 --wait parametro può essere passato solo al programma di avvio automatico. Il programma di installazione (setup.exe) non lo supporta. È utile quando si aggiornano i layout. Per informazioni dettagliate, vedere qui. |
--useLatestInstaller |
Facoltativo: funzionalità legacy applicabile solo per i programma di avvio automatico di Visual Studio precedenti ad aprile 2023. Qualsiasi elemento spedito dopo aprile 2023 usa il programma di installazione più recente per impostazione predefinita. Se questo parametro è presente, la versione più recente del Programma di installazione di Visual Studio è inclusa nel layout, anche se appartiene a una versione principale più recente del prodotto. Il programma di installazione più recente può essere utile se si desidera sfruttare le nuove funzionalità o le correzioni di bug disponibili nella versione più recente. Per altre informazioni, vedere Configurare il layout per usare sempre la documentazione più recente del programma di installazione . |
--config <path to *.vsconfig file> |
Facoltativo: se presente, Visual Studio usa il contenuto del file di configurazione per configurare il layout. Assicurarsi di specificare il percorso completo del file di configurazione. |
--noWeb |
Facoltativo: se presente, il programma di installazione di Visual Studio usa i file nella directory di layout per installare Visual Studio 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. Per altre informazioni, vedere Installare in un client che non ha accesso a Internet. Importante: il --noWeb parametro 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. Vengono elencati eventuali file danneggiati o mancanti. |
--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: ID del canale per l'istanza da installare, rappresentato come VisualStudio.17.Release. channelId è obbligatorio per il comando di installazione e viene ignorato per altri comandi, se --installPath specificato. Vedere esempi di sintassi di --channelId. |
--channelUri <uri> |
Facoltativa: URI del manifesto del canale. Questo valore regola il percorso di origine degli aggiornamenti e il valore iniziale viene configurato nel file di response.json del layout. Per i valori possibili, vedere esempi di sintassi di --channelUri . 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> |
Facoltativa: URI del manifesto del canale da usare per l'installazione. L'URI specificato da --channelUri (che deve essere specificato quando si specifica --installChannelUri) viene usato per rilevare gli aggiornamenti. Questo parametro può essere usato per il comando di installazione; altri comandi lo ignorano. |
--installCatalogUri <uri> |
Facoltativa: URI del manifesto del catalogo da usare per l'installazione. Se specificato, il gestore del canale prova a scaricare il manifesto del catalogo da questo URI prima di usare l'URI nel manifesto del canale di 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> |
Facoltativo: ID del prodotto per l'istanza installata. Questo parametro viene prepopolato in condizioni di installazione normali. è productID simile a "Microsoft.VisualStudio.Product.Enterprise". |
--arch all |
Facoltativo: per impostazione predefinita, i layout vengono creati con solo file binari di prodotto x64. Per includere i file binari ARM per i carichi di lavoro applicabili insieme ai file binari x64 in un layout, usare il --arch all parametro o --arch * . Per creare un layout solo di file binari ARM, usare --arch arm64 |
--keepLayoutVersion |
Facoltativo: applicare le modifiche al layout senza aggiornare la versione del prodotto inclusa nel layout. |
--locale <language-locale> |
Facoltativa: modifica la lingua di visualizzazione dell'interfaccia utente per il programma di installazione. L'impostazione verrà resa persistente. Per altre informazioni, vedere la sezione Elenco delle impostazioni locali delle lingue in questa pagina. |
--cache |
Facoltativo: se presente, i pacchetti verranno mantenuti dopo l'installazione per le riparazioni successive. Sostituisce l'impostazione dei criteri globali usata per installazioni successive, correzioni o modifiche. I criteri predefiniti prevedono di memorizzare i pacchetti nella cache. Questa impostazione viene ignorata per il comando di disinstallazione. Per altre informazioni, leggere come disabilitare o spostare la cache dei pacchetti. |
--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. Sostituisce l'impostazione dei criteri globali usata per installazioni successive, correzioni o modifiche. I criteri predefiniti prevedono di memorizzare i pacchetti nella cache. Questa impostazione viene ignorata per il comando di disinstallazione. Per altre informazioni, leggere come disabilitare o spostare la cache dei pacchetti. |
--noUpdateInstaller |
Facoltativo: se presente, impedisce al programma di installazione di eseguire l'aggiornamento quando viene specificato l'opzione non interattiva. Il programma di installazione non riuscirà a eseguire il comando e restituirà un codice di uscita diverso da zero se è noUpdateInstaller con modalità non interattiva quando è richiesto un aggiornamento del programma di installazione. |
--path <name>=<path> |
Facoltativo: usato per specificare percorsi di installazione personalizzati per l'installazione. I nomi di percorso supportati sono shared, cache e install. |
--path cache=<path> |
Facoltativo: usa il percorso specificato per scaricare i file di installazione. Questo percorso può essere impostato solo la prima volta in cui viene installato Visual Studio. Esempio: --path cache="C:\VS\cache" |
--path shared=<path> |
Facoltativo: contiene file condivisi per le installazioni side-by-side di Visual Studio. Alcuni strumenti e SDK vengono installati in un percorso dell'unità, mentre altri potrebbero sostituire questa impostazione ed essere installati in un'altra unità. Esempio: --path shared="C:\VS\shared" Importante: questa impostazione può essere impostata una sola volta e alla prima installazione di Visual Studio. |
--path install=<path> |
Facoltativo: equivalente a –-installPath. In particolare, --installPath "C:\VS" e --path install="C:\VS" 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 Visual Studio 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 Visual Studio. |
| parametri modifySettings | Descrizione |
|---|---|
--installPath <dir> |
È consigliabile usare per specificare l'istanza di Visual Studio su cui agire. |
--newChannelUri |
Obbligatorio: URI del manifesto del canale. Questo valore specifica dove verrà visualizzato il percorso di origine successivo degli aggiornamenti . Per i valori possibili, vedere esempi di sintassi di --channelUri . Se gli aggiornamenti non sono desiderati, --channelUri può puntare a un file inesistente, ad esempio --channelUri C:\doesntExist.chman. |
--channelUri |
URI del manifesto del canale precedente. Può essere usato se --installPath non è noto. Deve essere usato insieme a productID per identificare l'istanza corretta su cui agire. |
--productId <id> |
Deve essere usato se si specifica --channelUri e viene usato per identificare l'istanza corretta su cui agire. è productID simile a "Microsoft.VisualStudio.Product.Enterprise". |
--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 Visual Studio 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 degli 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 Visual Studio di rimuovere in modo permanente (o non rimuovere) tutti i componenti installati che hanno eseguito la transizione a uno stato out-of-support. 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\Visual Studio\2022\Enterprise" --newChannelUri https://aka.ms/vs/17/release.LTSC.17.0/channel --removeOos true
C:\>"C:\Program Files\Microsoft\Visual Studio\2022\Enterprise\vs_enterprise.exe" modifySettings --channelUri https://aka.ms/vs/17/release.LTSC.17.0/channel --productID Microsoft.VisualStudio.Product.Enterprise --newChannelUri \\layoutserver\share\path\channelmanifest.json --removeOos true --quiet
Eseguire il rollback dei parametri del comando e della riga di comando
A partire da Visual Studio 2022, è possibile eseguire il rollback di un aggiornamento a livello di codice usando il programma di installazione nel computer client e passando il comando di rollback insieme all'istanza del percorso di installazione.
| Comando | Descrizione |
|---|---|
rollback |
Comando per eseguire il rollback di una particolare istanza di Visual Studio all'aggiornamento installato in precedenza. Questo comando non funzionerà se DisableRollback è abilitato. |
| Parametri di rollback | Descrizione |
|---|---|
--installPath <dir> |
È consigliabile usare per specificare l'istanza di Visual Studio su cui agire. |
Esempi di sintassi:
"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" rollback -–installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise"
Comandi e parametri della riga di comando di Administrator Update
È possibile scaricare un aggiornamento dell'amministratore dal catalogo di Microsoft Update e usarlo per aggiornare l'installazione client o il layout.
Aggiornamento di un layout
Se si aggiorna un layout a una versione specifica di Visual Studio, è sufficiente scaricare l'aggiornamento dell'amministratore nel computer che ospita il layout, aprire un prompt dei comandi nel computer ed eseguire un comando simile al seguente:
visualstudioupdate-17.0.0to17.1.5.exe layout --layoutPath c:\VSLayout
Aggiornamento di un client
Nel client, se si scarica l'aggiornamento dell'amministratore nella directory di installazione nel computer client, è sufficiente fare doppio clic sul file per applicare l'aggiornamento. È anche possibile aprire una finestra di comando e passare alcuni dei parametri seguenti per modificare il comportamento predefinito.
Configurazione dell'aggiornamento dell'amministratore in SCCM
Se si distribuisce l'aggiornamento dell'amministratore tramite Microsoft Endpoint Manager (SCCM), è possibile modificare il pacchetto per modificare il comportamento usando i parametri seguenti. È anche possibile controllare i parametri tramite un file di configurazione nel computer client. Per altre informazioni, vedere Metodi per la configurazione di un aggiornamento dell'amministratore
Si noti che tutti i parametri administrator Update vengono eseguiti per impostazione predefinita nel contesto di "aggiornamento", a meno che non venga specificato il verbo di layout.
| Parametri di aggiornamento dell'amministratore | Descrizione |
|---|---|
--installerUpdateArgs [optional parameters] |
Questo parametro funge da "matrice pass-through" di parametri specifici rilevanti per gli scenari di aggiornamento dell'amministratore. I parametri facoltativi abilitati per questo scopo sono: --quiet: questa è l'esperienza predefinita per gli aggiornamenti dell'amministratore ed è elencata qui per completezza. --passive: questo parametro esegue l'override del --quiet parametro . Fa sì che l'interfaccia utente venga visualizzata in modo non interattivo. --norestart: questo parametro deve essere usato in combinazione con --quiet o --passive e causa il ritardo di eventuali riavvii necessari. --noWeb: questo parametro impedisce a Visual Studio di controllare su Internet la disponibilità di aggiornamenti al prodotto. --force: questo parametro impone la chiusura di Visual Studio anche se Visual Studio è in uso. Usare questo parametro con cautela, perché può causare la perdita di lavoro. Questo parametro deve essere usato solo quando l'aggiornamento dell'amministratore viene eseguito nel contesto utente; viene ignorato se l'aggiornamento dell'amministratore viene eseguito nel contesto di sistema. --installWhileDownloading: questo parametro consente a Visual Studio di scaricare e installare il prodotto in parallelo. È l'esperienza predefinita per gli aggiornamenti dell'amministratore ed è elencata qui per completezza. --keepWindowsUpdateOn: questo parametro impedisce al programma di installazione di disattivare l'agente di Windows Update nel client. È consigliabile usare questo parametro se si importa un aggiornamento dell'amministratore dal catalogo in SCCM. Potrebbe anche essere necessario impostare il timeout del pacchetto SCCM per essere più lungo dei 10 minuti predefiniti. Se si modifica il tipo di distribuzione SCCM in Required, questo parametro non è necessario.--downloadThenInstall: questo parametro impone a Visual Studio di scaricare tutti i file prima di installarli. Si escludono a vicenda dal --installWhileDownloading parametro . |
--checkPendingReboot |
L'aggiornamento verrà interrotto se è presente un riavvio in sospeso nel computer, indipendentemente dall'applicazione che potrebbe aver causato. L'impostazione predefinita non consiste nel verificare la presenza di riavvii in sospeso. |
Esempio di sintassi per il passaggio di parametri in un aggiornamento dell'amministratore:
visualstudioupdate-16.9.0to16.9.4.exe --installerUpdateArgs=--force,--noWeb,--keepWindowsUpdateOn --checkPendingReboot
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 includare gli elementi. È possibile rimuovere manualmente i canali di aggiornamento visualizzando il Programma di installazione di Visual Studio, passando alla scheda Disponibile e facendo clic sulla 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 removeChannel comando . È 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. |
| parametri removeChannel | 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 --quiet parametro . 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 Visual Studio
È possibile usare lo strumento Gestione pacchetti Windows "winget" per installare, modificare o aggiornare Visual Studio 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 Visual Studio.
winget install --id Microsoft.VisualStudio.2022.Community
Tuttavia, se si vuole personalizzare l'installazione e specificare carichi di lavoro e componenti aggiuntivi da acquisire durante l'installazione iniziale, è possibile usare l'opzione di --override winget insieme al comando di install winget e passare un file vsconfig esportato che contiene i carichi di lavoro e i componenti da aggiungere:
winget install --id Microsoft.VisualStudio.2022.Community --override "--passive --config c:\my.vsconfig"
Naturalmente, è anche possibile includere componenti direttamente durante l'installazione iniziale, come illustrato di seguito:
winget install --id Microsoft.VisualStudio.2022.Community --override "--quiet --add Microsoft.Visualstudio.Workload.Azure"
Se Visual Studio è già installato nel computer, è possibile usare configure di winget insieme al provider DSC di Visual Studio PowerShell, a un file yaml e a un file vsconfig per aggiungere componenti a un'installazione di Visual Studio esistente. Il comando di Winget funge essenzialmente da operazione di "modifica" di configure Visual Studio. Vedere come creare un file di configurazione WinGet per informazioni su come creare una configurazione winget.
Non è possibile usare l'opzione --override o il provider DSC di Visual Studio insieme al comando di upgrade winget, come upgrade essenzialmente funge da operazione di "aggiornamento" di Visual Studio e installa la versione più recente dei componenti già selezionati. Non è possibile aggiungere componenti tramite un aggiornamento o un aggiornamento. È necessario usare winget configure per aggiungere componenti.
Si noti che Programma di installazione di Visual Studio operazioni richiedono attualmente privilegi di amministratore, quindi winget chiederà di elevare i privilegi se necessario per completare il comando. Inoltre, non è attualmente possibile usare winget per installare più edizioni (ovvero SKU diversi) o più istanze dello stesso SKU contemporaneamente in un computer client. Infine, Visual Studio deve essere chiuso se si intende configurarlo (modificarlo) per aggiungere componenti o aggiornarlo alla versione più recente.
Elenco di ID di carichi di lavoro e ID di componenti
Per un elenco degli ID di componenti e carichi di lavoro ordinati per prodotto Visual Studio, vedere la pagina ID dei carichi di lavoro e dei componenti di Visual Studio.
Elenco delle impostazioni locali delle lingue
| Impostazioni locali | Lingua |
|---|---|
| Cs-cz | Ceco |
| De-de | Tedesco |
| En-us | italiano |
| 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% viene impostata su uno dei valori seguenti:
| valore | Risultato |
|---|---|
| 0 | L'operazione è riuscita |
| 740 | Elevazione obbligatoria |
| 1001 | Il processo di installazione di Visual Studio è in esecuzione |
| 1003 | Visual Studio è in uso |
| 1602 | L'operazione è stata annullata |
| 1618 | Un'altra installazione in esecuzione |
| 1641 | L'operazione è stata completata ed è stato avviato il riavvio |
| 3010 | L'operazione è riuscita, ma è necessario riavviare per poter usare l'installazione |
| 5003 | Il programma di avvio automatico non è riuscito a scaricare il programma di installazione |
| 5004 | L'operazione è stata annullata |
| 5005 | Errore di analisi della riga di comando del programma di avvio automatico |
| 5007 | L'operazione è stata bloccata. Il computer non soddisfa i requisiti |
| 8001 | Errore di controllo del computer Arm |
| 8002 | Errore di controllo preliminare del download in background |
| 8003 | Errore selezionabile non supportato |
| 8004 | Errore della directory di destinazione |
| 8005 | Verifica degli errori dei payload di origine |
| 8006 | Processi di Visual Studio 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 da un processo esterno) |
| Altro (ad esempio: -1, 1, 1603) |
Si è verificata una condizione di errore. Per altre informazioni, vedere i log |
Durante ogni operazione nella directory %TEMP% vengono generati diversi file di log che indicano lo stato di avanzamento dell'installazione. Ordinare la cartella per data e cercare i file che iniziano con dd_bootstrapper, dd_client e dd_setup per individuare quelli che si riferiscono rispettivamente al programma di avvio automatico, all'app del programma di installazione e al motore di installazione.
Supporto o risoluzione dei problemi
Non sempre tutto funziona correttamente. Se l'installazione di Visual Studio non riesce, vedere Risolvere i problemi di installazione e aggiornamento di Visual Studio per istruzioni dettagliate.
Ecco alcune altre opzioni di supporto:
- Usare l'opzione di supporto per l'installazione della chat (solo in inglese) per i problemi correlati all'installazione.
- Segnali i problemi del prodotto utilizzando lo strumento Segnala un problema, che appare sia nell'Installer di Visual Studio che nell'IDE di Visual Studio. Se si è un amministratore IT e non è installato Visual Studio, è possibile inviare feedback dell'amministratore IT.
- Suggerire una funzionalità, tenere traccia dei problemi del prodotto e trovare risposte in Visual Studio Developer Community.