Merge pull request #214518 from maertendMSFT/patch-7

Update ssh-arc-overview.md to include Azure PowerShell

Author: jborsecnik

articles/azure-arc/servers/ssh-arc-overview.md

@@ -19,7 +19,7 @@ allowing existing management tools to have a greater impact on Azure Arc-enabled
 SSH access to Arc-enabled servers provides the following key benefits:
  - No public IP address or open SSH ports required
  - Access to Windows and Linux machines
- - Ability to log-in as a local user or an [Azure user (Linux only)](../../active-directory/devices/howto-vm-sign-in-azure-ad-linux.md)
+ - Ability to log in as a local user or an [Azure user (Linux only)](../../active-directory/devices/howto-vm-sign-in-azure-ad-linux.md)
  - Support for other OpenSSH based tooling with config file support
 
 ## Prerequisites
@@ -42,32 +42,54 @@ SSH access to Arc-enabled servers is currently supported in the following region
    - Ubuntu Server: Ubuntu Server 16.04 to Ubuntu Server 20.04
 
 ## Getting started
-### Register the HybridConnectivity resource provider
+
+### Install local command line tool
+This functionality is currently packaged in an Azure CLI extension and an Azure PowerShell module.
+#### [Install Azure CLI extension](#tab/azure-cli)
+
+```az extension add --name ssh```
+
 > [!NOTE]
-> This is a one-time operation that needs to be performed on each subscription.
+> The Azure CLI extension version must be greater than 1.1.0.
 
-Check if the HybridConnectivity resource provider (RP) has been registered:
+#### [Install Azure PowerShell module](#tab/azure-powershell)
 
-```az provider show -n Microsoft.HybridConnectivity```
+```Install-Module -Name AzPreview -Scope CurrentUser -Repository PSGallery -Force```
 
-If the RP has not been registered, run the following:
+### Enable functionality on your Arc-enabled server
+In order to use the SSH connect feature, you must enable connections on the hybrid agent.
 
-```az provider register -n Microsoft.HybridConnectivity```
+> [!NOTE]
+> The following actions must be completed in an elevated terminal session.
 
-This operation can take 2-5 minutes to complete.  Before moving on, check that the RP has been registered.
+View your current incoming connections:
 
-### Install az CLI extension
-This functionality is currently package in an az CLI extension.
-In order to install this extension, run:
+```azcmagent config list```
 
-```az extension add --name ssh```
+If you have existing ports, you'll need to include them in the following command.
 
-If you already have the extension installed, it can be updated by running:
+To add access to SSH connections, run the following:
 
-```az extension update --name ssh```
+```azcmagent config set incomingconnections.ports 22<,other open ports,...>```
+
+If you're using a non-default port for your SSH connection, replace port 22 with your desired port in the previous command.
 
 > [!NOTE]
-> The Azure CLI extension version must be greater than 1.1.0.
+> The following steps will not need to be run for most users.
+
+### Register the HybridConnectivity resource provider
+> [!NOTE]
+> This is a one-time operation that needs to be performed on each subscription.
+
+Check if the HybridConnectivity resource provider (RP) has been registered:
+
+```az provider show -n Microsoft.HybridConnectivity```
+
+If the RP hasn't been registered, run the following:
+
+```az provider register -n Microsoft.HybridConnectivity```
+
+This operation can take 2-5 minutes to complete.  Before moving on, check that the RP has been registered.
 
 ### Create default connectivity endpoint
 > [!NOTE]
@@ -86,24 +108,5 @@ Validate endpoint creation:
  az rest --method get --uri https://management.azure.com/subscriptions/<subscription>/resourceGroups/<resourcegroup>/providers/Microsoft.HybridCompute/machines/<arc enabled server name>/providers/Microsoft.HybridConnectivity/endpoints/default?api-version=2021-10-06-preview
  ```
 
-### Enable functionality on your Arc-enabled server
-In order to use the SSH connect feature, you must enable connections on the hybrid agent.
-
-> [!NOTE]
-> The following actions must be completed in an elevated terminal session.
-
-View your current incoming connections:
-
-```azcmagent config list```
-
-If you have existing ports, you will need to include them in the following command.
-
-To add access to SSH connections, run the following:
-
-```azcmagent config set incomingconnections.ports 22<,other open ports,...>```
-
-> [!NOTE]
-> If you are using a non-default port for your SSH connection, replace port 22 with your desired port in the previous command.
-
 ## Examples
-To view examples of using the ```az ssh arc``` command, view the az CLI documentation page for [az ssh](/cli/azure/ssh).
+To view examples, view the Az CLI documentation page for [az ssh](/cli/azure/ssh) or the Azure PowerShell documentation page for [Az.Ssh](/powershell/module/az.ssh).