Visual Studio 安装的命令行参数示例

项目
03/11/2023

适用范围：Visual Studio Visual Studio for Mac Visual Studio Code

为了说明如何使用命令行参数来安装 Visual Studio，本文介绍了多个示例，你可以根据自己的需求自定义这些示例。

在每个示例中，vs_enterprise.exe、vs_professional.exe 和 vs_community.exe 表示 Visual Studio 安装引导程序的相应版本，这是启动下载过程的小型（约 1 MB）文件。若要使用其他版本，请用相应的安装引导程序名称进行替换。

所有命令都需要进行管理提升，如果没有通过提升的提示符启动进程，将显示用户帐户控制提示。

可以在命令行末尾使用 ^ 字符，将多行连接到一个命令中。也可以在一行中编写这些代码行。在 PowerShell 中，等效字符为反引号 (`)。

有关可使用命令行安装的工作负载和组件列表，请参阅 Visual Studio 工作负载和组件 ID 页。

使用 --installPath 安装

安装 Visual Studio 的最小实例，不显示任何交互式提示，但显示进度：

vs_enterprise.exe --installPath C:\minVS ^
--add Microsoft.VisualStudio.Workload.CoreEditor ^
--passive --norestart

无提示安装包含法语语言包的 Visual Studio 桌面实例，仅在产品安装后才返回值。

vs_enterprise.exe --installPath C:\desktopVS ^
--addProductLang fr-FR ^
--add Microsoft.VisualStudio.Workload.ManagedDesktop ^
--includeRecommended --quiet --wait

通过两个步骤进行更新

通过命令行更新 Visual Studio 实例（不显示任何交互式提示，但显示进度）。如果引导程序位于客户端计算机上，则可以从客户端运行此命令。否则，需要从布局中运行此命令。第一条命令更新安装程序，第二条命令更新 Visual Studio 产品。
```
vs_enterprise.exe --update --quiet --wait
vs_enterprise.exe update --wait --passive --norestart --installPath "C:\installPathVS"
```
注意

第一条命令更新 Visual Studio 安装程序，第二条命令更新 Visual Studio 产品位。建议按顺序运行并完成这两条命令。为了避免看到“用户帐户控制”对话框，请以管理员身份运行命令提示符。

使用 --wait

在批处理文件或脚本中使用 --wait，以等待 Visual Studio 安装程序完成之后再执行下一个命令。对于批文件，%ERRORLEVEL% 环境变量包含命令的返回值，如使用命令行参数安装 Visual Studio 页面所述。某些命令实用程序需要其他参数，以等待完成并获取安装程序的返回值。以下命令是与 PowerShell 脚本命令“Start-Proces”搭配使用的其他参数的示例：

start /wait vs_professional.exe --installPath "C:\VS" --passive --wait > nul
echo %errorlevel%

$process = Start-Process -FilePath vs_enterprise.exe -ArgumentList "--installPath", "C:\VS", "--passive", "--wait" -Wait -PassThru
Write-Output $process.ExitCode

或

  $startInfo = New-Object System.Diagnostics.ProcessStartInfo
  $startInfo.FileName = "vs_enterprise.exe"
  $startInfo.Arguments = "--all --quiet --wait"
  $process = New-Object System.Diagnostics.Process
  $process.StartInfo = $startInfo
  $process.Start()
  $process.WaitForExit()

第一个“--wait”由 Visual Studio 安装程序使用，第二个“--Wait”由“Start-Process”用于等待完成。 “-PassThru”参数由“Start-Process”使用，以以将安装程序的退出代码用于其返回值。

使用 --layout 创建网络布局或本地缓存

创建仅包含 Visual Studio 核心编辑器的布局（最精简的 Visual Studio 配置）和英语语言包：
```
vs_professional.exe --layout C:\VS ^
--lang en-US ^
--add Microsoft.VisualStudio.Workload.CoreEditor
```

创建包含 .NET 桌面和 .NET Web 工作负载以及所有推荐组件（仅限英语）的布局。

vs_professional.exe --layout C:\VS ^
--lang en-US ^
--add Microsoft.VisualStudio.Workload.NetWeb ^
--add Microsoft.VisualStudio.Workload.ManagedDesktop ^
--includeRecommended

使用 --config 配置布局的内容：

vs_enterprise.exe --layout C:\layout --config "C:\myconfig.vsconfig" --useLatestInstaller

使用 --all 获取整个产品

启动交互式安装 Visual Studio Enterprise 版本中的所有工作负载和组件：
```
vs_enterprise.exe --all
```

Using --includeRecommended

借助 Node.js 开发支持，使用昵称在已安装 Visual Studio Community 版本的计算机上安装 Visual Studio Professional 的第二个实例：
```
vs_professional.exe --installPath C:\VSforNode ^
--add Microsoft.VisualStudio.Workload.Node --includeRecommended --nickname VSforNode
```

Using --channelURI

使用 Visual Studio 2022 或更高版本安装程序，可以配置 Visual Studio 查找更新的位置。 --channelURI 也称为更新通道或更新的源位置。下表提供了 channelId 和 channelURI 的示例值及其含义。

通道名称	--channelURI	--channelId
Visual Studio 2022 当前频道	`https://aka.ms/vs/17/release/channel`	`VisualStudio.17.Release`
Visual Studio 2022 17.0 LTSC 频道	`https://aka.ms/vs/17/release.LTSC.17.0/channel`	`VisualStudio.17.Release.LTSC.17.0`
Visual Studio 2022 预览频道	`https://aka.ms/vs/17/pre/channel`	`VisualStudio.17.Preview`
Visual Studio 2019 发布频道	`https://aka.ms/vs/16/release/channel`	`VisualStudio.16.Release`
Visual Studio 2017 发布频道	`https://aka.ms/vs/15/release/channel`	`VisualStudio.15.Release`
自定义布局 - 专用频道	`\\layoutserver\share\path\channelmanifest.json`	`VisualStudio.17.Release`（或布局所基于的任何版本）

如果选择使用自定义布局作为更新通道，请注意以下准则：

--channelURI 必须指向自定义布局中的“channelmanifest.json”文件。
管理员可以通过配置客户端的注册表设置来配置自定义布局“专用频道”在更新设置 UI 中的显示方式。

Using --remove

从默认安装的 Visual Studio 实例中删除分析工具组件：

vs_enterprise.exe modify ^
--installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise" ^
--remove Microsoft.VisualStudio.Component.DiagnosticTools ^
--passive

Using --removeOos

注意

此命令需要使用 VS 2022 版本 17.4 或更高版本安装程序。按照此处的指南了解如何在客户端计算机上获取最新的安装程序。

修改安装，并从默认安装的 Visual Studio 实例中删除已转换为不支持状态的所有组件：

vs_enterprise.exe modify ^
--installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise" ^
--removeOos true ^
--passive

调整更新设置，以在每次更新产品时永久删除已转换为不支持状态的所有组件：

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

Using --path

使用安装、缓存和共享路径：

vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path cache="C:\VS\cache" --path shared="C:\VS\shared"
仅使用安装和缓存路径：

vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path cache="C:\VS\cache"
仅使用安装和共享路径：

vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path shared="C:\VS\shared"
仅使用安装路径：

vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS"

使用 export

使用 export 保存安装中的选择：

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\vs_installer.exe" export --installPath "C:\VS" --config "C:\.vsconfig"

使用 export 从头开始保存自定义选择：

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\vs_installer.exe" export --channelId VisualStudio.17.Release --productId Microsoft.VisualStudio.Product.Enterprise --add Microsoft.VisualStudio.Workload.ManagedDesktop --includeRecommended --config "C:\.vsconfig"

使用 --config

使用 --config 从以前保存的安装配置文件安装工作负载和组件：
```
vs_enterprise.exe --config "C:\my.vsconfig" --installPath "C:\VS"
```

使用 --config 向现有安装添加工作负载和组件：

vs_enterprise.exe modify --installPath "C:\VS" --config "C:\my.vsconfig"