Skip to content

Commit 3c719c7

Browse files
committed
Update instructions on how to install PowerShell
update update
1 parent d2a2e27 commit 3c719c7

6 files changed

+36
-57
lines changed

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

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,23 +6,25 @@ author: cherylmc
66

77
ms.service: vpn-gateway
88
ms.topic: article
9-
ms.date: 02/11/2019
9+
ms.date: 02/10/2020
1010
ms.author: cherylmc
1111
---
1212

1313
# Create a route-based VPN gateway using PowerShell
1414

1515
This article helps you quickly create a route-based Azure VPN gateway using PowerShell. A VPN gateway is used when creating a VPN connection to your on-premises network. You can also use a VPN gateway to connect VNets.
1616

17+
## Before you begin
18+
1719
The steps in this article will create a VNet, a subnet, a gateway subnet, and a route-based VPN gateway (virtual network gateway). Once the gateway creation has completed, you can then create connections. These steps require an Azure subscription. If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
1820

19-
[!INCLUDE [updated-for-az](../../includes/updated-for-az.md)]
21+
### Working with Azure PowerShell
2022

21-
[!INCLUDE [cloud-shell-try-it.md](../../includes/cloud-shell-try-it.md)]
23+
[!INCLUDE [powershell](../../includes/vpn-gateway-cloud-shell-powershell-about.md)]
2224

2325
## Create a resource group
2426

25-
Create an Azure resource group with [New-AzResourceGroup](/powershell/module/az.resources/new-azresourcegroup). A resource group is a logical container into which Azure resources are deployed and managed.
27+
Create an Azure resource group with [New-AzResourceGroup](/powershell/module/az.resources/new-azresourcegroup). A resource group is a logical container into which Azure resources are deployed and managed. Create a resource group. If you are running PowerShell locally, open your PowerShell console with elevated privileges and connect to Azure using the `Connect-AzAccount` command.
2628

2729
```azurepowershell-interactive
2830
New-AzResourceGroup -Name TestRG1 -Location EastUS

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

Lines changed: 3 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ author: cherylmc
77

88
ms.service: vpn-gateway
99
ms.topic: article
10-
ms.date: 04/26/2019
10+
ms.date: 02/10/2020
1111
ms.author: cherylmc
1212

1313
---
@@ -17,27 +17,11 @@ You can deploy VPN and ExpressRoute gateways in Azure Availability Zones. This b
1717

1818
## Before you begin
1919

20-
[!INCLUDE [updated-for-az](../../includes/updated-for-az.md)]
21-
22-
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.
23-
24-
[!INCLUDE [Cloud shell](../../includes/vpn-gateway-cloud-shell-powershell.md)]
25-
26-
### To use PowerShell locally
27-
28-
If you are using PowerShell locally on your computer, rather than using Cloud Shell, you must install PowerShell module 1.0.0 or higher. To check the version of PowerShell that you have installed, use the following command:
29-
30-
```azurepowershell
31-
Get-Module Az -ListAvailable | Select-Object -Property Name,Version,Path
32-
```
33-
34-
If you need to upgrade, see [Install Azure PowerShell module](/powershell/azure/install-az-ps).
35-
36-
[!INCLUDE [PowerShell login](../../includes/vpn-gateway-cloud-shell-ps-login.md)]
20+
[!INCLUDE [powershell](../../includes/vpn-gateway-cloud-shell-powershell-about.md)]
3721

3822
## <a name="variables"></a>1. Declare your variables
3923

40-
The values used for the example steps are listed below. Additionally, some of the examples use declared variables within the steps. If you are using these steps in your own environment, be sure to replace these values with your own. When specifying location, verify that the region you specify is supported. For more information, see the [FAQ](#faq).
24+
Declare the variables that you want to use. Use the following sample, substituting the values for your own when necessary. If you close your PowerShell/Cloud Shell session at any point during the exercise, just copy and paste the values again to re-declare the variables. When specifying location, verify that the region you specify is supported. For more information, see the [FAQ](#faq).
4125

4226
```azurepowershell-interactive
4327
$RG1 = "TestRG1"

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

Lines changed: 10 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: cherylmc
66

77
ms.service: vpn-gateway
88
ms.topic: conceptual
9-
ms.date: 02/27/2019
9+
ms.date: 02/10/2020
1010
ms.author: cherylmc
1111

1212
---
@@ -39,8 +39,6 @@ P2S connections require the following:
3939
* A RADIUS server to handle user authentication. The RADIUS server can be deployed on-premises, or in the Azure VNet.
4040
* A VPN client configuration package for the Windows devices that will connect to the VNet. A VPN client configuration package provides the settings required for a VPN client to connect over P2S.
4141

42-
[!INCLUDE [updated-for-az](../../includes/updated-for-az.md)]
43-
4442
## <a name="aboutad"></a>About Active Directory (AD) Domain Authentication for P2S VPNs
4543

4644
AD Domain authentication allows users to sign in to Azure using their organization domain credentials. It requires a RADIUS server that integrates with the AD server. Organizations can also leverage their existing RADIUS deployment.
@@ -60,6 +58,8 @@ Apart from Active Directory, a RADIUS server can also integrate with other exter
6058

6159
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).
6260

61+
### Working with Azure PowerShell
62+
6363
[!INCLUDE [powershell](../../includes/vpn-gateway-cloud-shell-powershell-about.md)]
6464

6565
### <a name="example"></a>Example values
@@ -83,12 +83,7 @@ You can use the example values to create a test environment, or refer to these v
8383
* **Public IP name: VNet1GWPIP**
8484
* **VpnType: RouteBased**
8585

86-
87-
## <a name="signin"></a>Sign in and set variables
88-
89-
[!INCLUDE [sign in](../../includes/vpn-gateway-cloud-shell-ps-login.md)]
90-
91-
### Declare variables
86+
## <a name="signin"></a>1. Set the variables
9287

9388
Declare the variables that you want to use. Use the following sample, substituting the values for your own when necessary. If you close your PowerShell/Cloud Shell session at any point during the exercise, just copy and paste the values again to re-declare the variables.
9489

@@ -110,7 +105,7 @@ Declare the variables that you want to use. Use the following sample, substituti
110105
$GWIPconfName = "gwipconf"
111106
```
112107

113-
## 1. <a name="vnet"></a>Create the resource group, VNet, and Public IP address
108+
## 2. <a name="vnet"></a>Create the resource group, VNet, and Public IP address
114109

115110
The following steps create a resource group and a virtual network in the resource group with three subnets. When substituting values, it's important that you always name your gateway subnet specifically 'GatewaySubnet'. If you name it something else, your gateway creation fails;
116111

@@ -144,7 +139,7 @@ The following steps create a resource group and a virtual network in the resourc
144139
$ipconf = New-AzVirtualNetworkGatewayIpConfig -Name "gwipconf" -Subnet $subnet -PublicIpAddress $pip
145140
```
146141

147-
## 2. <a name="radius"></a>Set up your RADIUS server
142+
## 3. <a name="radius"></a>Set up your RADIUS server
148143

149144
Before creating and configuring the virtual network gateway, your RADIUS server should be configured correctly for authentication.
150145

@@ -154,7 +149,7 @@ Before creating and configuring the virtual network gateway, your RADIUS server
154149

155150
The [Network Policy Server (NPS)](https://docs.microsoft.com/windows-server/networking/technologies/nps/nps-top) article provides guidance about configuring a Windows RADIUS server (NPS) for AD domain authentication.
156151

157-
## 3. <a name="creategw"></a>Create the VPN gateway
152+
## 4. <a name="creategw"></a>Create the VPN gateway
158153

159154
Configure and create the VPN gateway for your VNet.
160155

@@ -167,7 +162,7 @@ New-AzVirtualNetworkGateway -Name $GWName -ResourceGroupName $RG `
167162
-VpnType RouteBased -EnableBgp $false -GatewaySku VpnGw1
168163
```
169164

170-
## 4. <a name="addradius"></a>Add the RADIUS server and client address pool
165+
## 5. <a name="addradius"></a>Add the RADIUS server and client address pool
171166

172167
* The -RadiusServer can be specified by name or by IP address. If you specify the name and the server resides on-premises, then the VPN gateway may not be able to resolve the name. If that’s the case, then it's better to specify the IP address of the server. 
173168
* The -RadiusSecret should match what is configured on your RADIUS server.
@@ -224,11 +219,11 @@ New-AzVirtualNetworkGateway -Name $GWName -ResourceGroupName $RG `
224219
-RadiusServerAddress "10.51.0.15" -RadiusServerSecret $Secure_Secret
225220
```
226221
227-
## 5. <a name="vpnclient"></a>Download the VPN client configuration package and set up the VPN client
222+
## 6. <a name="vpnclient"></a>Download the VPN client configuration package and set up the VPN client
228223
229224
The VPN client configuration lets devices connect to a VNet over a P2S connection. To generate a VPN client configuration package and set up the VPN client, see [Create a VPN Client Configuration for RADIUS authentication](point-to-site-vpn-client-configuration-radius.md).
230225
231-
## <a name="connect"></a>6. Connect to Azure
226+
## <a name="connect"></a>7. Connect to Azure
232227
233228
### To connect from a Windows VPN client
234229

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

Lines changed: 4 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -5,28 +5,14 @@
55
author: cherylmc
66
ms.service: vpn-gateway
77
ms.topic: include
8-
ms.date: 06/04/2019
8+
ms.date: 02/10/2020
99
ms.author: cherylmc
1010
ms.custom: include file
1111
---
1212

13-
This article uses PowerShell cmdlets. To run the cmdlets, you can use Azure Cloud Shell, an interactive shell environment hosted in Azure and used
14-
through the browser. Azure Cloud Shell comes with the Azure PowerShell cmdlets pre-installed.
1513

16-
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,
17-
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
18-
executed, so press **Enter** to run code.
14+
[!INCLUDE [cloudshell powershell](vpn-gateway-cloud-shell-powershell.md)]
1915

20-
You can launch Azure Cloud Shell with:
16+
[!INCLUDE [powershell locally](vpn-gateway-powershell-locally.md)]
2117

22-
| | |
23-
|-----------------------------------------------|---|
24-
| 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/hdi-azure-cli-try-it.png) |
25-
| Open [shell.azure.com](https://shell.azure.com) in your browser. | [![Launch Azure Cloud Shell button](./media/cloud-shell-try-it/hdi-launch-cloud-shell.png)](https://shell.azure.com) |
26-
| 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/hdi-cloud-shell-menu.png) |
27-
28-
**Running PowerShell locally**
29-
30-
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 versions of Azure PowerShell installed on your computer, use the `Get-Module -ListAvailable Az` cmdlet. To install or update, see [Install the Azure PowerShell module](/powershell/azure/install-az-ps).
31-
32-
If you are running PowerShell locally, be sure to run 'Connect-AzAccount' to create your connection to Azure.
18+
If you are using Azure CloudShell, you are connected to your account automatically and do not need to run the Connect-AzAccount command. If you are running PowerShell locally, open your PowerShell console with elevated privileges and connect to Azure using the `Connect-AzAccount` command.

includes/vpn-gateway-connect-vm-p2s-include.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ You can connect to a VM that is deployed to your VNet by creating a Remote Deskt
1717

1818
- PowerShell - Use the example to view a list of VMs and private IP addresses from your resource groups. You don't need to modify this example before using it.
1919

20-
```powershell
20+
```azurepowershell-interactive
2121
$VMs = Get-AzVM
2222
$Nics = Get-AzNetworkInterface | Where VirtualMachine -ne $null
2323
Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
---
2+
title: include file
3+
description: include file
4+
services: vpn-gateway
5+
author: cherylmc
6+
ms.service: vpn-gateway
7+
ms.topic: include
8+
ms.date: 02/10/2020
9+
ms.author: cherylmc
10+
ms.custom: include file
11+
---
12+
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 versions of Azure PowerShell installed on your computer, use the `Get-Module -ListAvailable Az` cmdlet. To install or update, see [Install the Azure PowerShell module](/powershell/azure/install-az-ps).

0 commit comments

Comments
 (0)