Merge pull request #31 from coole106/patch-1

Adding and updating some options

Author: TerryGLee

docs/install/use-command-line-parameters-to-install-visual-studio.md

@@ -51,13 +51,14 @@ If no command is specified, it will install the product.
 | ----------------------- | --------------- |  
 | ```--installPath <dir>``` | The installation directory for the instance to act upon. For the install command, this is where the instance will be installed. For other commands, this is where the previously-installed instance was installed. |
 | ```--productId <id>``` | The ID of the product for the instance that will be installed. This is required for the install command, ignored for other commands if --installPath is specified. |
-| ```--layout <dir>``` | Optional: Specifies a directory to create an offline install cache. |
+| ```--layout <dir>``` | Optional: Specifies a directory to create an offline install cache. Selecting this option will implicitly add the '--wait' option as well. |
 | ```--lang <language-locale>``` *[&#60;language-locale&#62; ...]* | Optional: Install/uninstall resource packages with the specified language(s). |
-| ```--add <workload or component ID>``` *[&#60;workload or component ID&#62; ...]* | Optional: One or more workload or component IDs to add. |
+| ```--add <workload or component ID>``` *[&#60;workload or component ID&#62; ...]* | Optional: One or more workload or component IDs to add. The required components of the artifact are installed, but not the recommended or optional components. You can control additional components globally using '--includeRecommended' and/or '--includeOptional'. For finer-grained control, you can append ';includeRecommended' and/or ';includeOptional' to the artifactId (e.g. '--add Workload1;includeRecommended' or '--add Workload2;includeOptional;includeRecommended'). |
 | ```--remove <workload or component ID>``` *[&#60;workload or component ID&#62; ...]* | Optional: One or more workload or component IDs to remove. |
 | ```--all``` | Optional: Whether to install all workloads and components for a product. |
-| ```--includeRecommended``` | Optional: Includes the recommended components for any workloads that are installed, but not the optional components. The workloads are specified either with --all or --add. |
-| ```--includeOptional``` | Optional: Includes the optional components for any workloads that are installed, but not the recommended components. The workloads are specified either with --all or --add.  |
+| ```--allWorkloads``` | Optional: Installs all workloads and their required components, no recommended or optional components. |
+| ```--includeRecommended``` | Optional: Includes the recommended components for any workloads that are installed, but not the optional components. The workloads are specified either with --allWorkloads or --add. |
+| ```--includeOptional``` | Optional: Includes the optional components for any workloads that are installed, but not the recommended components. The workloads are specified either with --allWorkloads or --add.  |
 | ```--quiet, -q``` | Optional: Do not display any user interface while performing the installation. |
 | ```--passive, -p``` | Optional: Display the user interface, but do not request any interaction from the user. |
 | ```--norestart``` | Optional: If present, commands with --passive or --quiet will not automatically restart the machine (if required). This is ignored if neither --passive nor --quiet are specified.  |
@@ -74,7 +75,8 @@ If no command is specified, it will install the product.
 | ```--in <path>``` | Optional: The URI or path to a response file.  |
 | ```--addProductLang <language-locale>``` | Optional: This defines the language of an artifact (group, workload, or component) that is to be installed. It can appear multiple times on the command line. It is optional for the install and modify commands, ignored for the update, repair and uninstall commands. If not present, the installation will use the machine locale. |
 | ```--removeProductLang <language-locale>``` | Optional: This defines the language of an artifact (group, workload, or component) that is to be removed. It can appear multiple times on the command line. It is optional for the install and modify commands, ignored for the update, repair and uninstall commands. |
-
+| ```--wait``` | Optional: The process will wait until the install is completed before returning a exit code. This is useful when automating installations where one needs to wait for the install to finish to handle the return code from that install. |
+| ```--productKey``` | Optional: This defines the product key to use for an installed product. It is composed of 25 alphanumeric characters either in the format 'xxxxx-xxxxx-xxxxx-xxxxx-xxxxx' or 'xxxxxxxxxxxxxxxxxxxxxxxxx'. |
 ## List of workload IDs and component IDs
 For a list of workload and component IDs sorted by Visual Studio product, see our [Visual Studio 2017 Workload and Component IDs](https://aka.ms/vs2017componentids) page.