From 089042f735a2c9cfe844880842486091f5855b9c Mon Sep 17 00:00:00 2001
From: Wade Pickett <wpickett@microsoft.com>
Date: Fri, 21 Jul 2023 15:46:16 -0700
Subject: [PATCH] dotnet install: Add arch options (#36345)

* dotnet install: Add arch options
* Per review changed to CLI RID description
---
 docs/core/tools/dotnet-tool-install.md | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/docs/core/tools/dotnet-tool-install.md b/docs/core/tools/dotnet-tool-install.md
index d2d777d50e2e2..66838cd51fdf4 100644
--- a/docs/core/tools/dotnet-tool-install.md
+++ b/docs/core/tools/dotnet-tool-install.md
@@ -1,7 +1,7 @@
 ---
 title: dotnet tool install command
 description: The dotnet tool install command installs the specified .NET tool on your machine.
-ms.date: 05/16/2023
+ms.date: 07/19/2023
 ---
 # dotnet tool install
 
@@ -15,6 +15,7 @@ ms.date: 05/16/2023
 
 ```dotnetcli
 dotnet tool install <PACKAGE_NAME> -g|--global
+    [-a|--arch <ARCHITECTURE>]
     [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
     [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
     [--no-cache] [--prerelease]
@@ -22,6 +23,7 @@ dotnet tool install <PACKAGE_NAME> -g|--global
     [--version <VERSION_NUMBER>]
 
 dotnet tool install <PACKAGE_NAME> --tool-path <PATH>
+    [-a|--arch <ARCHITECTURE>]
     [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
     [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
     [--no-cache] [--prerelease]
@@ -29,6 +31,7 @@ dotnet tool install <PACKAGE_NAME> --tool-path <PATH>
     [--version <VERSION_NUMBER>]
 
 dotnet tool install <PACKAGE_NAME> [--local]
+    [-a|--arch <ARCHITECTURE>]
     [--add-source <SOURCE>] [--configfile <FILE>]
     [--create-manifest-if-needed] [--disable-parallel]
     [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
@@ -84,6 +87,10 @@ For more information, see [Install a local tool](global-tools.md#install-a-local
 
 ## Options
 
+- **`-a|--arch <ARCHITECTURE>`**
+
+  Specifies the target architecture. This is a shorthand syntax for setting the [Runtime Identifier (RID)](../../../docs/core/rid-catalog.md), where the provided value is combined with the default RID. For example, on a `win-x64` machine, specifying `--arch x86` sets the RID to `win-x86`.
+
 [!INCLUDE [add-source](../../../includes/cli-add-source.md)]
 
 [!INCLUDE [configfile](../../../includes/cli-configfile.md)]