Documentation improvement to Az.StackHCI (Azure#13988)

* Fix example format of Register-AzStackHCI

* module description

* Update Register-AzStackHCI.md

* exit 0

Author: isra-fel

src/StackHCI/Az.StackHCI.psd1

@@ -30,7 +30,7 @@ CompanyName = 'Microsoft Corporation'
 Copyright = 'Microsoft Corporation. All rights reserved.'
 
 # Description of the functionality provided by this module
-Description = 'Microsoft Azure PowerShell: StackHCI cmdlets'
+Description = 'Microsoft Azure PowerShell: Azure Stack HCI registration cmdlets'
 
 # Minimum version of the PowerShell engine required by this module
 PowerShellVersion = '5.1'

src/StackHCI/help/Az.StackHCI.md

@@ -8,7 +8,7 @@ Locale: en-US
 
 # Az.StackHCI Module
 ## Description
-Microsoft Azure PowerShell: StackHCI cmdlets
+Microsoft Azure PowerShell: Azure Stack HCI registration cmdlets
 
 ## Az.StackHCI Cmdlets
 ### [Register-AzStackHCI](Register-AzStackHCI.md)

src/StackHCI/help/Register-AzStackHCI.md

@@ -26,48 +26,48 @@ Register-AzStackHCI creates a Microsoft.AzureStackHCI cloud resource representin
 ## EXAMPLES
 
 ### EXAMPLE 1
-```
-Invoking on one of the cluster node.
-```
-
+```powershell
 C:\PS\>Register-AzStackHCI -SubscriptionId "12a0f531-56cb-4340-9501-257726d741fd" 
 Result: Success
 ResourceId: /subscriptions/12a0f531-56cb-4340-9501-257726d741fd/resourceGroups/DemoHCICluster1-rg/providers/Microsoft.AzureStackHCI/clusters/DemoHCICluster1
 PortalResourceURL: https://portal.azure.com/#@c31c0dbb-ce27-4c78-ad26-a5f717c14557/resource/subscriptions/12a0f531-56cb-4340-9501-257726d741fd/resourceGroups/DemoHCICluster1-rg/providers/Microsoft.AzureStackHCI/clusters/DemoHCICluster1/overview
 PortalAADAppPermissionsURL: https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationMenuBlade/CallAnAPI/appId/980be58d-578c-4cff-b4cd-43e9c3a77826/isMSAApp/
-
-### EXAMPLE 2
-```
-Invoking from the management node
 ```
 
+Invoking on one of the cluster node.
+
+### EXAMPLE 2
+```powershell
 C:\PS\>Register-AzStackHCI -SubscriptionId "12a0f531-56cb-4340-9501-257726d741fd" -ComputerName ClusterNode1
 Result: Success
 ResourceId: /subscriptions/12a0f531-56cb-4340-9501-257726d741fd/resourceGroups/DemoHCICluster2-rg/providers/Microsoft.AzureStackHCI/clusters/DemoHCICluster2
 PortalResourceURL: https://portal.azure.com/#@c31c0dbb-ce27-4c78-ad26-a5f717c14557/resource/subscriptions/12a0f531-56cb-4340-9501-257726d741fd/resourceGroups/DemoHCICluster2-rg/providers/Microsoft.AzureStackHCI/clusters/DemoHCICluster2/overview
 PortalAADAppPermissionsURL: https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationMenuBlade/CallAnAPI/appId/950be58d-578c-4cff-b4cd-43e9c3a77866/isMSAApp/
-
-### EXAMPLE 3
-```
-Invoking from WAC
 ```
 
+Invoking from the management node.
+
+### EXAMPLE 3
+```powershell
 C:\PS\>Register-AzStackHCI -SubscriptionId "12a0f531-56cb-4340-9501-257726d741fd" -ArmAccessToken etyer..ere= -GraphAccessToken acyee..rerrer -AccountId [email protected] -Region westus -ResourceName DemoHCICluster3 -ResourceGroupName DemoHCIRG 
 Result: PendingForAdminConsent
 ResourceId: /subscriptions/12a0f531-56cb-4340-9501-257726d741fd/resourceGroups/DemoHCIRG/providers/Microsoft.AzureStackHCI/clusters/DemoHCICluster3
 PortalResourceURL: https://portal.azure.com/#@c31c0dbb-ce27-4c78-ad26-a5f717c14557/resource/subscriptions/12a0f531-56cb-4340-9501-257726d741fd/resourceGroups/DemoHCIRG/providers/Microsoft.AzureStackHCI/clusters/DemoHCICluster3/overview
 PortalAADAppPermissionsURL: https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationMenuBlade/CallAnAPI/appId/980be58d-578c-4cff-b4cd-43e9c3a77866/isMSAApp/
-
-### EXAMPLE 4
-```
-Invoking with all the parameters
 ```
 
+Invoking from WAC.
+
+### EXAMPLE 4
+```powershell
 C:\PS\>Register-AzStackHCI -SubscriptionId "12a0f531-56cb-4340-9501-257726d741fd" -Region westus -ResourceName HciCluster1 -TenantId "c31c0dbb-ce27-4c78-ad26-a5f717c14557" -ResourceGroupName HciClusterRG -ArmAccessToken eerrer..ere= -GraphAccessToken acee..rerrer -AccountId [email protected] -EnvironmentName AzureCloud -ComputerName node1hci -Credential Get-Credential
 Result: Success
 ResourceId: /subscriptions/12a0f531-56cb-4340-9501-257726d741fd/resourceGroups/HciClusterRG/providers/Microsoft.AzureStackHCI/clusters/HciCluster1
 PortalResourceURL: https://portal.azure.com/#@c31c0dbb-ce27-4c78-ad26-a5f717c14557/resource/subscriptions/12a0f531-56cb-4340-9501-257726d741fd/resourceGroups/HciClusterRG/providers/Microsoft.AzureStackHCI/clusters/HciCluster1/overview
 PortalAADAppPermissionsURL: https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationMenuBlade/CallAnAPI/appId/990be58d-578c-4cff-b4cd-43e9c3a77866/isMSAApp/
+```
+
+Invoking with all the parameters.
 
 ## PARAMETERS
 

src/StackHCI/test-module.ps1

@@ -0,0 +1 @@
+exit 0