Add examples to SSMS installation articles

fuixx217 · rwestMSFT · commit dda629dd3f2f · 2025-09-25T15:28:13.000-06:00
diff --git a/ssms/install/command-line-examples.md b/ssms/install/command-line-examples.md
@@ -4,13 +4,13 @@ description: Examples of using command-line parameters to install SQL Server Man
 author: erinstellato-ms
 ms.author: erinstellato
 ms.reviewer: randolphwest, maghan, mbarickman
-ms.date: 06/25/2025
+ms.date: 09/25/2025
 ms.service: sql-server-management-studio
 ms.topic: concept-article
 ms.collection:
   - data-tools
 ---
-# Command-Line parameter examples for SQL Server Management Studio installation
+# Command-line parameter examples for SQL Server Management Studio installation
 
 [!INCLUDE [sql-asdb-asdbmi-asa](../includes/applies-to-version/sql-asdb-asdbmi-asa.md)]
 
@@ -24,70 +24,130 @@ To execute commands in a non-interactive manner, you can use `--passive` or `--q
 
 For lists of the workloads and components that you can install by using the command line, see [Workload and component IDs for SQL Server Management Studio](workload-component-ids.md).
 
-## Install using --installPath and --add alongside the bootstrapper
+## Install using `--installPath` and `--add` alongside the bootstrapper
 
 Install a minimal instance of SSMS, with no interactive prompts, but progress displayed:
 
-```cmd
-vs_ssms.exe --installPath C:\SSMS21 --passive --norestart
+```console
+vs_SSMS.exe --installPath C:\SSMS21 --passive --norestart
 ```
 
 Install SSMS silently, with the Italian language pack, returning only when the product is installed:
 
-```cmd
-vs_ssms.exe --installPath C:\SSMS21 --addProductLang it-it --quiet --wait
+```console
+vs_SSMS.exe --installPath C:\SSMS21 --addProductLang it-it --quiet --wait
 ```
 
 ## Install workloads
 
 Install SSMS with Git integration, with the user interface displayed in a non-interactive manner:
 
-```cmd
-vs_ssms.exe --add Microsoft.SqlServer.Workload.SSMS.CodeTools --includeRecommended --passive
+```console
+vs_SSMS.exe --add Microsoft.SqlServer.Workload.SSMS.CodeTools --includeRecommended --passive
 ```
 
 Install SSMS with all components in the Business Intelligence workload, with the user interface displayed in a non-interactive manner:
 
-```cmd
-vs_ssms.exe --add Microsoft.SqlServer.Workload.SSMS.BI --includeRecommended --passive --norestart
+```console
+vs_SSMS.exe --add Microsoft.SqlServer.Workload.SSMS.BI --includeRecommended --passive --norestart
 ```
 
 ## Update
 
-Update an SSMS installation via the command line with progress displayed and no interactive prompts. You can't initiate the installer programmatically from the same directory that the installer resides in.
+Update an SSMS installation via the command line with progress displayed and no interactive prompts. You can't initiate the installer programmatically from the same folder that the installer resides in.
 
-```cmd
-"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" update --passive --norestart --installPath "C:\SSMS21"
+```console
+vs_SSMS.exe update --passive --norestart --installPath "C:\SSMS21"
 ```
 
-## Use --layout to create a network layout or local cache
+Update an SSMS installation via the command line quietly:
+
+```console
+vs_SSMS.exe update --noWeb --quiet --wait --norestart
+```
+
+## Use `--layout` to create a network layout or local cache
 
 Create a layout that includes SSMS and Copilot in SSMS, and the English language pack:
 
-```cmd
-vs_ssms.exe --layout "C:\SSMS_Layout" --lang en-US --add Microsoft.SqlServer.Workload.SSMS.AI --includeRecommended
+```console
+vs_SSMS.exe --layout C:\SSMS_Layout --lang en-US --add Microsoft.SqlServer.Workload.SSMS.AI --includeRecommended
+```
+
+Create a layout that includes SSMS and Integration Services in SSMS, and the English language pack:
+
+```console
+vs_SSMS.exe --layout C:\SSMS_Layout --lang en-US --add Microsoft.SSMS.Component.IS --includeRecommended
 ```
 
 Create a layout with two workloads and one optional component in three languages:
 
-```cmd
-vs_ssms.exe --layout "C:\SSMS_Layout" --lang en-US --add Microsoft.SqlServer.Workload.SSMS.HybridAndMigration --add Microsoft.SqlServer.Workload.SSMS.CodeTools --add Microsoft.Component.HelpViewer --lang en-US de-DE ja-JP
+```console
+vs_SSMS.exe --layout C:\SSMS_Layout --lang en-US --add Microsoft.SqlServer.Workload.SSMS.HybridAndMigration --add Microsoft.SqlServer.Workload.SSMS.CodeTools --add Microsoft.Component.HelpViewer --lang en-US de-DE ja-JP
+```
+
+To create a complete local layout for SQL Server Management Studio and all languages, run:
+
+```console
+vs_SSMS.exe --layout C:\SSMS_Layout --all
+```
+
+To create a local layout for SQL Server Management Studio that limits the components to only the Integration Services and Reporting Services component, run:
+
+```console
+vs_SSMS.exe --layout C:\SSMS_Layout --add Microsoft.SSMS.Component.IS --add Microsoft.SSMS.Component.RS
+```
+
+To create a local layout for SQL Server Management Studio that limits the components to only the offline help content, run:
+
+```console
+vs_SSMS.exe --layout C:\SSMS_Layout --add Microsoft.Component.HelpViewer
 ```
 
 ## Install a layout
 
-Once a layout is created, it can be copied to an offline machine for installation. If the layout was created using:
+Once a layout is created, it can be copied to an offline machine for installation. To install specific components, those components must be included in the offline layout already. For more information, see the [complete local layout](#use---layout-to-create-a-network-layout-or-local-cache) example.
+
+Make sure you are in the folder where the layout was saved. In these examples, it's `C:\SSMS_Layout`.
 
-```cmd
-vs_ssms.exe --layout "C:\SSMS_Layout" --lang en-US --add Microsoft.SqlServer.Workload.SSMS.AI --includeRecommended
+```console
+C:\SSMS_Layout\vs_SSMS.exe --lang en-US --add Microsoft.SqlServer.Workload.SSMS.AI --includeRecommended
 ```
 
-Install SSMS from the layout using:
+To install SSMS with Integration Services support from the layout, run:
 
-```cmd
-C:\SSMS_Layout\vs_SSMS.exe --noWeb --noUpdateInstaller --add Microsoft.SqlServer.Workload.SSMS.AI --includeRecommended --passive
+```console
+C:\SSMS_Layout\vs_SSMS.exe --noWeb --noUpdateInstaller --add Microsoft.SSMS.Component.IS --includeRecommended --passive
 ```
 
+To install SSMS with Integration Services and Reporting Services support, run:
+
+```console
+C:\SSMS_Layout\vs_SSMS.exe --noWeb --noUpdateInstaller --add Microsoft.SSMS.Component.IS --add Microsoft.SSMS.Component.RS --includeRecommended --passive
+```
+
+## Modify an existing installation
+
+To update SSMS to include other components, create a layout with your desired components, using the previous examples.
+
+1. Change to the layout folder.
+
+   ```console
+   cd C:\SSMS_Layout
+   ```
+
+1. Update to the latest released version.
+
+   ```console
+   vs_SSMS.exe update --noWeb --quiet --wait --norestart
+   ```
+
+1. Modify SSMS to add Analysis Services, Integration Services, and Reporting Services components, using the offline layout that includes these components, run:
+
+   ```console
+   vs_SSMS.exe modify --noWeb --productID Microsoft.VisualStudio.Product.SSMS --channelID SSMS.21.SSMS.Release --add Microsoft.SSMS.Component.AS --add Microsoft.SSMS.Component.IS --add Microsoft.SSMS.Component.RS --quiet --norestart
+   ```
+
 ## Related content
 
 - [Create an offline installation of SQL Server Management Studio](create-offline.md)
diff --git a/ssms/install/create-offline.md b/ssms/install/create-offline.md
@@ -4,7 +4,7 @@ description: Create an offline installation package to install SQL Server Manage
 author: erinstellato-ms
 ms.author: erinstellato
 ms.reviewer: randolphwest, maghan, mbarickman
-ms.date: 07/15/2025
+ms.date: 09/25/2025
 ms.service: sql-server-management-studio
 ms.topic: concept-article
 ms.collection:
@@ -20,17 +20,29 @@ ms.collection:
 
 ### Step 1 - Download the SSMS bootstrapper
 
-[Download the correct bootstrapper](install.md) for the version of SSMS you want, and copy it into the directory you want to use as the source location for your local layout. The bootstrapper is the executable you use to create, update, or modify your local layout. You must have an internet connection to complete this step.
+[Download the correct bootstrapper](install.md) for the version of SSMS you want, and copy it into the folder you want to use as the source location for your local layout. The bootstrapper is the executable you use to create, update, or modify your local layout. You must have an internet connection to complete this step.
 
 ### Step 2 - Create a local layout
 
-Open a command prompt with administrator privileges, navigate to the directory where you downloaded the bootstrapper, and use the [bootstrapper's parameters](command-line-parameters.md#layout-command-and-command-line-parameters) to create your local layout. You must have an internet connection to complete this step.
+Open a command prompt with administrator privileges, navigate to the folder where you downloaded the bootstrapper, and use the [bootstrapper's parameters](command-line-parameters.md#layout-command-and-command-line-parameters) to create your local layout. You must have an internet connection to complete this step.
 
 You can install a language other than English by changing `en-US` to a locale from the [list of language locales](command-line-parameters.md#list-of-language-locales), and you can use the [list of component IDs](workload-component-ids.md) to further customize your local layout.
 
-To create a complete local layout for SQL Server Management Studio, run:
+To create a complete local layout for SQL Server Management Studio and all languages, run:
 
-```cmd
+```console
+vs_SSMS.exe --layout C:\SSMS_Layout --all
+```
+
+To create a local layout for SQL Server Management Studio that limits the components to only the Integration Services and Reporting Services component, run:
+
+```console
+vs_SSMS.exe --layout C:\SSMS_Layout --add Microsoft.SSMS.Component.IS --add Microsoft.SSMS.Component.RS
+```
+
+To create a local layout for SQL Server Management Studio that limits the components to only the offline help content, run:
+
+```console
 vs_SSMS.exe --layout C:\SSMS_Layout --add Microsoft.Component.HelpViewer
 ```
 
@@ -45,13 +57,13 @@ When you install SSMS from a local layout, the Visual Studio Installer uses the
 
 For example, if you created a local installation layout using the command from step 2, then use the following command to run the installation and prevent the client machine from accessing the internet:
 
-```cmd
+```console
 C:\SSMS_Layout\vs_SSMS.exe --noWeb --add Microsoft.Component.HelpViewer
 ```
 
 ## Validate a certificate for offline installations
 
-Installing SSMS on an offline machine can require a valid certificate. If you try to install SSMS on an offline machine using a layout, and the installer exits with no exception, it might be due to an invalid certificate. Go to the `%TEMP%` directory and open the most recent bootstrapper file named `dd_bootstrapper_yyyyMMddHHmmss.log`. The following messages indicate the installation is failing because of an invalid certificate:
+Installing SSMS on an offline machine can require a valid certificate. If you try to install SSMS on an offline machine using a layout, and the installer exits with no exception, it might be due to an invalid certificate. Go to the `%TEMP%` folder and open the most recent bootstrapper file named `dd_bootstrapper_yyyyMMddHHmmss.log`. The following messages indicate the installation is failing because of an invalid certificate:
 
 ```output
 Certificate is invalid: <YourSSMSFolder>\vs_installer.opc
diff --git a/ssms/install/install.md b/ssms/install/install.md
@@ -4,7 +4,7 @@ description: Learn how to use the Visual Studio installer to install SQL Server
 author: erinstellato-ms
 ms.author: erinstellato
 ms.reviewer: randolphwest
-ms.date: 08/21/2025
+ms.date: 09/25/2025
 ms.service: sql-server-management-studio
 ms.topic: how-to
 ms.collection:
@@ -104,6 +104,8 @@ vs_SSMS.exe --locale en-US
 
 The installer remembers this setting when you run it again. The installer supports these language locales: `zh-cn`, `zh-tw`, `cs-cz`, `en-us`, `es-es`, `fr-fr`, `de-de`, `it-it`, `ja-jp`, `ko-kr`, `pl-pl`, `pt-br`, `ru-ru`, and `tr-tr`.
 
+For more command-line examples, see [Command-line parameter examples](command-line-examples.md).
+
 ## Step 7 - Select the installation location (optional)
 
 You can reduce the installation footprint of SSMS on your system drive. For more information, see [Select installation locations for SQL Server Management Studio](select-install-location.md).
