Fix one-off Cloud Shell includes.

Author: Stephen Tramer

articles/expressroute/expressroute-howto-add-gateway-resource-manager.md

@@ -28,11 +28,11 @@ This article helps you add, resize, and remove a virtual network (VNet) gateway
 
 [!INCLUDE [updated-for-az](../../includes/updated-for-az.md)]
 
-[!INCLUDE [working with cloud shell](../../includes/expressroute-cloud-shell-try-it-about.md)]
+[!INCLUDE [working with cloud shell](../../includes/expressroute-cloud-shell-powershell-about.md)]
 
 ### Configuration reference list
 
 [!INCLUDE [expressroute-gateway-rm-ps](../../includes/expressroute-gateway-rm-ps-include.md)]
 
 ## Next steps
-After you have created the VNet gateway, you can link your VNet to an ExpressRoute circuit. See [Link a Virtual Network to an ExpressRoute circuit](expressroute-howto-linkvnet-arm.md).
+After you have created the VNet gateway, you can link your VNet to an ExpressRoute circuit. See [Link a Virtual Network to an ExpressRoute circuit](expressroute-howto-linkvnet-arm.md).

articles/vpn-gateway/create-zone-redundant-vnet-gateway.md

@@ -21,7 +21,7 @@ You can deploy VPN and ExpressRoute gateways in Azure Availability Zones. This b
 
 You can use either PowerShell installed locally on your computer, or the Azure Cloud Shell. If you choose to install and use the PowerShell locally, this feature requires the latest version of the PowerShell module.
 
-[!INCLUDE [Cloud shell](../../includes/vpn-gateway-cloud-shell-try-it.md)]
+[!INCLUDE [Cloud shell](../../includes/vpn-gateway-cloud-shell-powershell.md)]
 
 ### To use PowerShell locally
 

articles/vpn-gateway/point-to-site-how-to-radius-ps.md

@@ -58,7 +58,7 @@ Apart from Active Directory, a RADIUS server can also integrate with other exter
 
 Verify that you have an Azure subscription. If you don't already have an Azure subscription, you can activate your [MSDN subscriber benefits](https://azure.microsoft.com/pricing/member-offers/msdn-benefits-details) or sign up for a [free account](https://azure.microsoft.com/pricing/free-trial).
 
-[!INCLUDE [powershell](../../includes/vpn-gateway-cloud-shell-try-it-about.md)]
+[!INCLUDE [powershell](../../includes/vpn-gateway-cloud-shell-powershell-about.md)]
 
 ### <a name="example"></a>Example values
 

articles/vpn-gateway/vpn-gateway-connect-multiple-policybased-rm-ps.md

@@ -71,7 +71,7 @@ The workflow to enable this connectivity:
 
 Verify that you have an Azure subscription. If you don't already have an Azure subscription, you can activate your [MSDN subscriber benefits](https://azure.microsoft.com/pricing/member-offers/msdn-benefits-details) or sign up for a [free account](https://azure.microsoft.com/pricing/free-trial).
 
-[!INCLUDE [powershell](../../includes/vpn-gateway-cloud-shell-try-it-about.md)]
+[!INCLUDE [powershell](../../includes/vpn-gateway-cloud-shell-powershell-about.md)]
 
 ## <a name="enablepolicybased"></a>Enable policy-based traffic selectors on a connection
 

articles/vpn-gateway/vpn-gateway-howto-point-to-site-rm-ps.md

@@ -31,7 +31,7 @@ Point-to-Site native Azure certificate authentication connections use the follow
 
 Verify that you have an Azure subscription. If you don't already have an Azure subscription, you can activate your [MSDN subscriber benefits](https://azure.microsoft.com/pricing/member-offers/msdn-benefits-details) or sign up for a [free account](https://azure.microsoft.com/pricing/free-trial).
 
-[!INCLUDE [powershell](../../includes/vpn-gateway-cloud-shell-try-it-about.md)]
+[!INCLUDE [powershell](../../includes/vpn-gateway-cloud-shell-powershell-about.md)]
 
 Most of the steps in this article can use Cloud Shell. However, to upload the root certificate public key, you must either use PowerShell locally, or the Azure portal.
 

articles/vpn-gateway/vpn-gateway-tutorial-create-gateway-powershell.md

@@ -30,7 +30,7 @@ The following diagram shows the virtual network and the VPN gateway created as p
 
 [!INCLUDE [updated-for-az](../../includes/updated-for-az.md)]
 
-[!INCLUDE [working with cloud shell](../../includes/vpn-gateway-cloud-shell-try-it.md)]
+[!INCLUDE [working with cloud shell](../../includes/vpn-gateway-cloud-shell-powershell.md)]
 
 ## Common network parameter values
 

includes/cloud-shell-try-it.md

@@ -8,7 +8,7 @@ ms.author: sttramer
 
 ## Open Azure Cloud Shell
 
-Azure Cloud Shell is an interactive shell environment hosted in Azure, which you interact with through your browser. Azure Cloud Shell allows you to
+Azure Cloud Shell is an interactive shell environment hosted in Azure and used through your browse. Azure Cloud Shell allows you to
 use either `bash` or `PowerShell` shells to run a variety of tools to work with Azure services. Azure Cloud Shell comes pre-installed with the commands
 to allow you to run the content of this article without having to install anything on your local environment.
 

includes/expressroute-cloud-shell-powershell-about.md

@@ -5,18 +5,25 @@
  author: cherylmc
  ms.service: vpn-gateway
  ms.topic: include
- ms.date: 02/13/2019
+ ms.date: 06/04/2019
  ms.author: cherylmc
  ms.custom: include file
 ---
 
-This article uses PowerShell cmdlets. To run the cmdlets, you can use Azure Cloud Shell, a free interactive shell. It has common Azure tools preinstalled and configured to use with your account. Just click the **Copy** to copy the code, paste it into the Cloud Shell, and then press enter to run it. There are a few ways to launch the Cloud Shell:
+This article uses PowerShell cmdlets. To run the cmdlets, you can use Azure Cloud Shell, an interactive shell environment hosted in Azure and used
+through the browser. Azure Cloud Shell comes with the Azure PowerShell cmdlets pre-installed.
+
+To run any code contained in this article on Azure Cloud Shell, open a Cloud Shell session, use the **Copy** button on a code block to copy the code,
+and paste it into the Cloud Shell session with __Ctrl+Shift+V__ on Windows and Linux, or __Cmd+Shift+V__ on macOS. Pasted text is not automatically
+executed, so press **Enter** to run code.
+
+You can launch Azure Cloud Shell with:
 
 |  |   |
 |-----------------------------------------------|---|
-| Click **Try It** in the upper right corner of a code block. | ![Cloud Shell in this article](./media/vpn-gateway-cloud-shell-powershell/cloud-shell-powershell-try-it.png) |
-| Open Cloud Shell in your browser. | [![https://shell.azure.com/powershell](./media/vpn-gateway-cloud-shell-powershell/launchcloudshell.png)](https://shell.azure.com/powershell) |
-| Click the **Cloud Shell** button on the menu in the upper right of the Azure portal. | [![Cloud Shell in the portal](./media/vpn-gateway-cloud-shell-powershell/cloud-shell-menu.png)](https://portal.azure.com) |
-|  |  |
+| Select **Try It** in the upper-right corner of a code block. This __doesn't__ automatically copy text to Cloud Shell. | ![Example of Try It for Azure Cloud Shell](./media/cloud-shell-try-it/cli-try-it.png) |
+| Open [shell.azure.com](https://shell.azure.com) in your browser. | [![Launch Azure Cloud Shell button](./media/cloud-shell-try-it/launchcloudshell.png)](https://shell.azure.com) |
+| Select the **Cloud Shell** button on the menu in the upper-right corner of the [Azure portal](https://portal.azure.com). | ![Cloud Shell button in the Azure portal](./media/cloud-shell-try-it/cloud-shell-menu.png) |
 
-If you don't want to use Azure Cloud Shell, you can install PowerShell locally instead. If you choose to install and use PowerShell locally, be sure to install the latest version of the Azure Resource Manager PowerShell cmdlets to get the latest feature functionality. For more information, see [How to install and configure Azure PowerShell](/powershell/azure/overview).
+If you don't want to use Azure Cloud Shell, install Azure PowerShell locally instead. Be sure to install the latest version of the Azure PowerShell Az
+module to get up-to-date functionality. For more information, see [Install Azure PowerShell](/powershell/azure/overview).

includes/vpn-gateway-cloud-shell-powershell-about.md

@@ -5,20 +5,26 @@
  author: cherylmc
  ms.service: vpn-gateway
  ms.topic: include
- ms.date: 02/13/2019
+ ms.date: 06/04/2019
  ms.author: cherylmc
  ms.custom: include file
 ---
 
-This article uses PowerShell cmdlets. To run the cmdlets, you can use Azure Cloud Shell. Azure Cloud Shell is a free interactive shell which  has common Azure tools that are preinstalled and configured to use with your account. Just click **Copy** to copy the code, paste it into the Cloud Shell, and then press enter to run it. There are a few ways to launch the Cloud Shell:
+This article uses PowerShell cmdlets. To run the cmdlets, you can use Azure Cloud Shell, an interactive shell environment hosted in Azure and used
+through the browser. Azure Cloud Shell comes with the Azure PowerShell cmdlets pre-installed.
+
+To run any code contained in this article on Azure Cloud Shell, open a Cloud Shell session, use the **Copy** button on a code block to copy the code,
+and paste it into the Cloud Shell session with __Ctrl+Shift+V__ on Windows and Linux, or __Cmd+Shift+V__ on macOS. Pasted text is not automatically
+executed, so press **Enter** to run code.
+
+You can launch Azure Cloud Shell with:
 
 |  |   |
 |-----------------------------------------------|---|
-| Click **Try It** in the upper right corner of a code block. | ![Cloud Shell in this article](./media/vpn-gateway-cloud-shell-powershell/cloud-shell-powershell-try-it.png) |
-| Open Cloud Shell in your browser. | [![https://shell.azure.com/powershell](./media/vpn-gateway-cloud-shell-powershell/launchcloudshell.png)](https://shell.azure.com/powershell) |
-| Click the **Cloud Shell** button on the menu in the upper right of the Azure portal. | [![Cloud Shell in the portal](./media/vpn-gateway-cloud-shell-powershell/cloud-shell-menu.png)](https://portal.azure.com) |
-|  |  |
+| Select **Try It** in the upper-right corner of a code block. This __doesn't__ automatically copy text to Cloud Shell. | ![Example of Try It for Azure Cloud Shell](./media/cloud-shell-try-it/cli-try-it.png) |
+| Open [shell.azure.com](https://shell.azure.com) in your browser. | [![Launch Azure Cloud Shell button](./media/cloud-shell-try-it/launchcloudshell.png)](https://shell.azure.com) |
+| Select the **Cloud Shell** button on the menu in the upper-right corner of the [Azure portal](https://portal.azure.com). | ![Cloud Shell button in the Azure portal](./media/cloud-shell-try-it/cloud-shell-menu.png) |
 
 **Running PowerShell locally**
 
-You can also install and run the Azure PowerShell cmdlets locally on your computer. PowerShell cmdlets are updated frequently. If you are not running the latest version, the values specified in the instructions may fail. To find the version of PowerShell that you are running locally, use the `Get-Module -ListAvailable Az` cmdlet. To install or update, see [Install the Azure PowerShell module](/powershell/azure/install-az-ps).
+You can also install and run the Azure PowerShell cmdlets locally on your computer. PowerShell cmdlets are updated frequently. If you are not running the latest version, the values specified in the instructions may fail. To find the version of PowerShell that you are running locally, use the `Get-Module -ListAvailable Az` cmdlet. To install or update, see [Install the Azure PowerShell module](/powershell/azure/install-az-ps).

includes/vpn-gateway-cloud-shell-powershell.md

@@ -5,16 +5,23 @@
  author: cherylmc
  ms.service: vpn-gateway
  ms.topic: include
- ms.date: 05/14/2018
+ ms.date: 06/04/2019
  ms.author: cherylmc
  ms.custom: include file
 ---
 
-The Azure Cloud Shell is a free interactive shell that you can use to run the steps in this article. It has common Azure tools preinstalled and configured to use with your account. Just click the **Copy** to copy the code, paste it into the Cloud Shell, and then press enter to run it. There are a few ways to launch the Cloud Shell:
+This article uses PowerShell cmdlets. To run the cmdlets, you can use Azure Cloud Shell, an interactive shell environment hosted in Azure and used
+through the browser. Azure Cloud Shell comes with the Azure PowerShell cmdlets pre-installed.
+
+To run any code contained in this article on Azure Cloud Shell, open a Cloud Shell session, use the **Copy** button on a code block to copy the code,
+and paste it into the Cloud Shell session with __Ctrl+Shift+V__ on Windows and Linux, or __Cmd+Shift+V__ on macOS. Pasted text is not automatically
+executed, so press **Enter** to run code.
+
+You can launch Azure Cloud Shell with:
 
 |  |   |
 |-----------------------------------------------|---|
-| Click **Try It** in the upper right corner of a code block. | ![Cloud Shell in this article](./media/vpn-gateway-cloud-shell-powershell/cloud-shell-powershell-try-it.png) |
-| Open Cloud Shell in your browser. | [![https://shell.azure.com/powershell](./media/vpn-gateway-cloud-shell-powershell/launchcloudshell.png)](https://shell.azure.com/powershell) |
-| Click the **Cloud Shell** button on the menu in the upper right of the Azure portal. | [![Cloud Shell in the portal](./media/vpn-gateway-cloud-shell-powershell/cloud-shell-menu.png)](https://portal.azure.com) |
-|  |  |
+| Select **Try It** in the upper-right corner of a code block. This __doesn't__ automatically copy text to Cloud Shell. | ![Example of Try It for Azure Cloud Shell](./media/cloud-shell-try-it/cli-try-it.png) |
+| Open [shell.azure.com](https://shell.azure.com) in your browser. | [![Launch Azure Cloud Shell button](./media/cloud-shell-try-it/launchcloudshell.png)](https://shell.azure.com) |
+| Select the **Cloud Shell** button on the menu in the upper-right corner of the [Azure portal](https://portal.azure.com). | ![Cloud Shell button in the Azure portal](./media/cloud-shell-try-it/cloud-shell-menu.png) |
+