add windows machine

v-thepet · v-thepet · commit 4c8eb763ac49 · 2023-03-20T14:51:21.000-07:00
diff --git a/articles/virtual-network/create-vm-accelerated-networking-cli.md b/articles/virtual-network/create-vm-accelerated-networking-cli.md
@@ -1,6 +1,6 @@
 ---
-title: Use Azure CLI to create a Linux VM with Accelerated Networking
-description: Use Azure CLI to create and manage Linux virtual machines that have Accelerated Networking enabled for improved network performance.
+title: Use Azure CLI to create a Windows or Linux VM with Accelerated Networking
+description: Use Azure CLI to create and manage virtual machines that have Accelerated Networking enabled for improved network performance.
 services: virtual-network
 author: asudbring
 manager: gedegrac
@@ -12,9 +12,9 @@ ms.date: 03/20/2023
 ms.author: allensu
 ms.custom: fasttrack-edit, devx-track-azurecli
 ---
-# Use Azure CLI to create a Linux VM with Accelerated Networking
+# Use Azure CLI to create a VM with Accelerated Networking
 
-This article describes how to create a Linux virtual machine (VM) with Accelerated Networking (AccelNet) enabled by using the Azure command-line interface, Azure CLI. The article also discusses application binding requirements, and how to enable and manage Accelerated Networking on existing VMs.
+This article describes how to create a Linux or Windows virtual machine (VM) with Accelerated Networking (AccelNet) enabled by using the Azure command-line interface, Azure CLI. The article also discusses application binding requirements, and how to enable and manage Accelerated Networking on existing VMs.
 
 You can also create a VM with Accelerated Networking enabled by using the [Azure portal](quick-create-portal.md). For more information about managing Accelerated Networking on VMs through the Azure portal, see [Manage Accelerated Networking through the portal](#manage-accelerated-networking-through-the-portal).
 
@@ -27,17 +27,17 @@ To use Azure PowerShell to create a Windows VM with Accelerated Networking enabl
 
 ## Create a VM with Accelerated Networking
 
-In the following examples, replace the example parameters such as `<myResourceGroup>`, `<myNic>`, and `<myVm>` with your own values.
+In the following examples, you can replace the example parameters such as `<myResourceGroup>`, `<myNic>`, and `<myVm>` with your own values.
 
 ### Create a virtual network
 
-1. Use [az group create](/cli/azure/group) to create a resource group to contain the resources. Be sure to select a supported Linux region as listed in [Linux Accelerated Networking](https://azure.microsoft.com/updates/accelerated-networking-in-expanded-preview).
+1. Use [az group create](/cli/azure/group#az-group-create) to create a resource group to contain the resources. Be sure to select a supported Windows or Linux region as listed in [Windows and Linux Accelerated Networking](https://azure.microsoft.com/updates/accelerated-networking-in-expanded-preview).
 
    ```azurecli
    az group create --name <myResourceGroup> --location <myAzureRegion>
    ```
 
-1. Use [az network vnet create](/cli/azure/network/vnet) to create a virtual network with one subnet in the resource group:
+1. Use [az network vnet create](/cli/azure/network/vnet#az-network-vnet-create) to create a virtual network with one subnet in the resource group:
 
    ```azurecli
    az network vnet create \
@@ -50,15 +50,34 @@ In the following examples, replace the example parameters such as `<myResourceGr
 
 ### Create a network security group
 
-1. Use [az network nsg create](/cli/azure/network/nsg) to create a network security group (NSG).
+1. Use [az network nsg create](/cli/azure/network/nsg#az-network-nsg-create) to create a network security group (NSG).
 
    ```azurecli
    az network nsg create \
      --resource-group <myResourceGroup> \
      --name <myNsg>
    ```
 
-1. The NSG contains several default rules, one of which disables all inbound access from the internet. Use [az network nsg rule create](/cli/azure/network/nsg/rule) to open a port to allow secure shell (SSH) access to the VM.
+1. The NSG contains several default rules, one of which disables all inbound access from the internet. Use [az network nsg rule create](/cli/azure/network/nsg/rule#az-network-nsg-rule-create) to open a port to allow remote desktop protocol (RDP) or secure shell (SSH) access to the VM.
+
+# [Windows](#tab/windows)
+
+   ```azurecli
+   az network nsg rule create \
+     --resource-group <myResourceGroup> \
+     --nsg-name <myNsg> \
+     --name Allow-RDP-Internet \
+     --access Allow \
+     --protocol Tcp \
+     --direction Inbound \
+     --priority 100 \
+     --source-address-prefix Internet \
+     --source-port-range "*" \
+     --destination-address-prefix "*" \
+     --destination-port-range 3389
+   ```
+
+# [Linux](#tab/linux)
 
    ```azurecli
    az network nsg rule create \
@@ -75,17 +94,18 @@ In the following examples, replace the example parameters such as `<myResourceGr
      --destination-port-range 22
    ```
 
+---
 ### Create a network interface with Accelerated Networking
 
-1. Use [az network public-ip create](/cli/azure/network/public-ip) to create a public IP address. The VM doesn't need a public IP address if you don't access it from the internet, but you need the public IP to complete the steps for this article.
+1. Use [az network public-ip create](/cli/azure/network/public-ip#az-network-public-ip-create) to create a public IP address. The VM doesn't need a public IP address if you don't access it from the internet, but you need the public IP to complete the steps for this article.
 
    ```azurecli
    az network public-ip create \
      --name <myPublicIp> \
      --resource-group <myResourceGroup>
    ```
 
-1. Use [az network nic create](/cli/azure/network/nic) to create a network interface (NIC) with Accelerated Networking enabled. The following example creates a NIC in the subnet of the virtual network, and associates the NSG to the NIC.
+1. Use [az network nic create](/cli/azure/network/nic#az-network-nic-create) to create a network interface (NIC) with Accelerated Networking enabled. The following example creates a NIC in the subnet of the virtual network, and associates the NSG to the NIC.
 
    ```azurecli
    az network nic create \
@@ -100,7 +120,24 @@ In the following examples, replace the example parameters such as `<myResourceGr
 
 ### Create a VM and attach the NIC
 
-Use [az vm create](/cli/azure/vm) to create the VM, and use the `--nics` option to attach the NIC you created. Make sure to select a VM size and distribution that's listed in [Linux Accelerated Networking](https://azure.microsoft.com/updates/accelerated-networking-in-expanded-preview). For a list of all VM sizes and characteristics, see [Linux VM sizes](../virtual-machines/sizes.md?toc=%2fazure%2fvirtual-network%2ftoc.json).
+Use [az vm create](/cli/azure/vm#az-vm-create) to create the VM, and use the `--nics` option to attach the NIC you created. Make sure to select a VM size and distribution that's listed in [[Windows and Linux Accelerated Networking]](https://azure.microsoft.com/updates/accelerated-networking-in-expanded-preview). For a list of all VM sizes and characteristics, see [Sizes for virtual machines in Azure](../virtual-machines/sizes.md).
+
+# [Windows](#tab/windows)
+
+The following example creates a Windows Server 2019 Datacenter VM with a size that supports Accelerated Networking, Standard_DS4_v2.
+
+```azurecli
+az vm create \
+  --resource-group <myResourceGroup> \
+  --name <myVm> \
+  --image Win2019Datacenter \
+  --size Standard_DS4_v2 \
+  --admin-username <myAdminUser> \
+  --admin-password <myAdminPassword> \
+  --nics <myNic>
+```
+
+# [Linux](#tab/linux)
 
 The following example creates a VM with the UbuntuLTS OS image and a size that supports Accelerated Networking, Standard_DS4_v2.
 
@@ -115,6 +152,8 @@ az vm create \
   --nics <myNic>
 ```
 
+---
+
 After the VM is created, you get output similar to the following example. Take note of the `publicIpAddress`, which you use to access the VM in later steps.
 
 ```output
@@ -132,6 +171,39 @@ After the VM is created, you get output similar to the following example. Take n
 
 ## Confirm that accelerated networking is enabled
 
+# [Windows](#tab/windows)
+
+Once you create the VM in Azure, connect to the VM and confirm that the Ethernet controller is installed in Windows.
+
+1. In the [Azure portal](https://portal.azure.com), search for and select *virtual machines*.
+
+1. On the **Virtual machines** page, select your new VM.
+
+1. On the VM's **Overview** page, select **Connect**.
+
+1. On the **Connect** screen, select **Native RDP**.
+
+1. On the **Native RDP** screen, select **Download RDP file**.
+
+1. Open the downloaded RDP file, and then sign in with the credentials you entered when you created the VM.
+
+1. On the remote VM, right-click **Start** and select **Device Manager**.
+
+1. In the **Device Manager** window, expand the **Network adapters** node.
+
+1. Confirm that the **Mellanox ConnectX-4 Lx Virtual Ethernet Adapter** appears, as shown in the following image:
+
+   ![Mellanox ConnectX-3 Virtual Function Ethernet Adapter, new network adapter for accelerated networking, Device Manager](./media/create-vm-accelerated-networking/device-manager.png)
+
+   The presence of the adapter confirms that Accelerated Networking is enabled for your VM.
+
+> [!NOTE]
+> If the Mellanox adapter fails to start, open an administrator command prompt on the remote VM and enter the following command:
+>
+> `netsh int tcp set global rss = enabled`
+
+# [Linux](#tab/linux)
+
 1. Use the following command to create an SSH session with the VM. Replace `<myPublicIp>` with the public IP address assigned to the VM you created, and replace `<myAdminUser>` with the `--admin-username` you specified when you created the VM.
 
    ```bash
@@ -177,6 +249,8 @@ You must run an application over the synthetic NIC to guarantee that the applica
 
 For more information about application binding requirements, see [How Accelerated Networking works in Linux and FreeBSD VMs](./accelerated-networking-how-it-works.md#application-usage).
 
+---
+
 <a name="enable-accelerated-networking-on-existing-vms"></a>
 ## Manage Accelerated Networking on existing VMs
 
diff --git a/articles/virtual-network/create-vm-accelerated-networking-powershell.md b/articles/virtual-network/create-vm-accelerated-networking-powershell.md
@@ -1,5 +1,5 @@
 ---
-title: Use PowerShell to create a Windows VM with Accelerated Networking
+title: Use PowerShell to create a VM with Accelerated Networking
 description: Use Azure PowerShell to create and manage Windows virtual machines that have Accelerated Networking enabled for improved network performance.
 services: virtual-network
 author: asudbring
@@ -13,13 +13,13 @@ ms.date: 03/20/2023
 ms.author: allensu
 ---
 
-# Use Azure PowerShell to create a Windows VM with Accelerated Networking
+# Use Azure PowerShell to create a VM with Accelerated Networking
 
 This article describes how to use Azure PowerShell to create a Windows virtual machine (VM) with Accelerated Networking (AccelNet) enabled. The article also discusses how to enable and manage Accelerated Networking on existing VMs.
 
 You can also create a VM with Accelerated Networking enabled by using the [Azure portal](quick-create-portal.md). For more information about managing Accelerated Networking on VMs through the Azure portal, see [Manage Accelerated Networking through the portal](#manage-accelerated-networking-through-the-portal).
 
-To use Azure CLI to create a Linux VM with Accelerated Networking enabled, see [Use Azure CLI to create a Linux VM with Accelerated Networking](create-vm-accelerated-networking-cli.md).
+To use Azure CLI to create a Linux or Windows VM with Accelerated Networking enabled, see [Use Azure CLI to create a VM with Accelerated Networking](create-vm-accelerated-networking-cli.md).
 
 ## Prerequisites
 
@@ -31,7 +31,7 @@ To use Azure CLI to create a Linux VM with Accelerated Networking enabled, see [
 
 ## Create a VM with Accelerated Networking
 
-In the following examples, replace the example parameters such as `<myResourceGroup>`, `<myNic>`, and `<myVm>` with your own values.
+In the following examples, you can replace the example parameters such as `<myResourceGroup>`, `<myNic>`, and `<myVm>` with your own values.
 
 ### Create a virtual network
 
@@ -135,7 +135,7 @@ In the following examples, replace the example parameters such as `<myResourceGr
    $vmConfig = New-AzVMConfig -VMName "<myVm>" -VMSize "Standard_DS4_v2"
    ```
 
-1. Use [Set-AzVMOperatingSystem](/powershell/module/az.compute/set-azvmoperatingsystem) and [Set-AzVMSourceImage](/powershell/module/az.compute/set-azvmsourceimage) to create the rest of the VM configuration. The following example creates a Windows Server 2019 VM:
+1. Use [Set-AzVMOperatingSystem](/powershell/module/az.compute/set-azvmoperatingsystem) and [Set-AzVMSourceImage](/powershell/module/az.compute/set-azvmsourceimage) to create the rest of the VM configuration. The following example creates a Windows Server 2019 Datacenter VM:
 
    ```azurepowershell
    $vmConfig = Set-AzVMOperatingSystem -VM $vmConfig `
@@ -231,7 +231,7 @@ You can enable Accelerated Networking on an existing VM. The VM must meet the fo
    Start-AzVM -ResourceGroup "<myResourceGroup>" -Name "<myVM>"
    ```
 
-### Virtual Machine Scale Sets
+### Enable Accelerated Networking on Virtual Machine Scale Sets
 
 Azure Virtual Machine Scale Sets is slightly different but follows the same workflow.
 
diff --git a/articles/virtual-network/virtual-network-network-interface.md b/articles/virtual-network/virtual-network-network-interface.md
@@ -20,17 +20,20 @@ A VM you create in the Azure portal has one NIC with default settings. You can c
 
 # [Portal](#tab/azure-portal)
 
-To run the procedures in this article, you need the following prerequisites:
+You need the following prerequisites:
 
 - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
 - An existing Azure virtual network. To create one, see [Quickstart: Create a virtual network by using the Azure portal](quick-create-portal.md).
-- To run the following procedures, sign in to the [Azure portal](https://portal.azure.com) with your Azure account.
 
-  In the procedures, you can replace the example names with your own values.
+To run the procedures in this article:
+
+- Sign in to the [Azure portal](https://portal.azure.com) with your Azure account.
+
+- Replace the placeholders in the examples with your own values.
 
 # [Azure CLI](#tab/azure-cli)
 
-To run the examples in this article, you need the following prerequisites:
+To run the commands in this article, you need the following prerequisites:
 
 - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
 - An existing Azure virtual network. To create one, see [Quickstart: Create a virtual network by using Azure CLI](quick-create-cli.md).
@@ -45,11 +48,11 @@ You can run the commands either in the [Azure Cloud Shell](/azure/cloud-shell/ov
 
   Run [az login](/cli/azure/reference-index#az-login) to connect to Azure. For more information, see [Sign in with Azure CLI](/cli/azure/authenticate-azure-cli).
 
-In the following code examples, you can replace the example placeholder names with your own values.
+In the following procedures, you can replace the example placeholder names with your own values.
 
 # [PowerShell](#tab/azure-powershell)
 
-To run the procedures in this article, you need the following prerequisites:
+To run the commands in this article, you need the following prerequisites:
 
 - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
 - An existing Azure virtual network. To create one, see [Quickstart: Create a virtual network by using Azure PowerShell](quick-create-powershell.md).
@@ -64,7 +67,7 @@ You can run the commands either in the [Azure Cloud Shell](/azure/cloud-shell/ov
 
   Then run `Connect-AzAccount` to connect to Azure. For more information, see [Sign in with Azure PowerShell](/powershell/azure/authenticate-azureps).
 
-In the following code examples, you can replace the example placeholder names with your own values.
+In the following procedures, you can replace the example placeholder names with your own values.
 
 ---
 
