Skip to content

Commit aefeef8

Browse files
authored
Update title and wording in reset RDP documentation
1 parent 1ac724b commit aefeef8

1 file changed

Lines changed: 12 additions & 11 deletions

File tree

support/azure/virtual-machines/windows/reset-rdp.md

Lines changed: 12 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Reset Remote Desktop Services or its Admin Password in a Windows VM
2+
title: Reset Remote Desktop Services or its Admin Password on a Windows VM
33
description: Learn how to reset an account password or Remote Desktop Services on a Windows VM by using the Azure portal or Azure PowerShell.
44
services: virtual-machines
55
documentationcenter: ''
@@ -16,18 +16,18 @@ ms.date: 03/26/2025
1616
ms.author: jarrettr
1717
ms.reviewer: herensin, v-monicaba
1818
---
19-
# Reset Remote Desktop Services or its admin password in a Windows VM
19+
# Reset Remote Desktop Services or its admin password on a Windows VM
2020

2121
**Applies to:** :heavy_check_mark: Windows VMs
2222

2323
[!INCLUDE [Feedback](../../../includes/feedback.md)]
2424

25-
If you can't connect to a Windows virtual machine (VM), you can reset Remote Desktop Services and credentials by using the VMAccess Extension. Here are the available methods to do this:
25+
If you can't connect to a Windows virtual machine (VM), you can reset Remote Desktop Services and credentials by using the VMAccess extension. Use either of the following methods to perform this action:
2626

2727
- [Reset by using the Azure portal](#reset-by-using-the-azure-portal)
28-
- [Reset by using the Azure PowerShell](#reset-by-using-the-azure-powershell)
28+
- [Reset by using Azure PowerShell](#reset-by-using-the-azure-powershell)
2929

30-
If you're using PowerShell, make sure that you have the [latest PowerShell module installed and configured](/powershell/azure/) and are signed in to your Azure subscription. You can also [perform these steps for VMs created with the classic deployment model](/previous-versions/azure/virtual-machines/windows/classic/reset-rdp).
30+
If you're using PowerShell, make sure that you have the [latest PowerShell module installed and configured](/powershell/azure/) and that you're signed in to your Azure subscription. You can also perform these steps for [VMs that are created by using the classic deployment model](/previous-versions/azure/virtual-machines/windows/classic/reset-rdp).
3131

3232

3333
> [!NOTE]
@@ -37,16 +37,17 @@ If you're using PowerShell, make sure that you have the [latest PowerShell modul
3737

3838
## Reset by using the Azure portal
3939

40-
First, sign in to the [Azure portal](https://portal.azure.com) and then select **Virtual machines** on the left menu.
40+
Sign in to the [Azure portal](https://portal.azure.com), open the left menu, and then select **Virtual machines**.
4141

4242
### **Reset the local admin account password**
4343

44-
1. Select your Windows VM and then select **Reset password** under **Help**. The **Reset password** window is displayed.
44+
1. Select your Windows VM, open the **Help** menu, and then select **Reset password**. The **Reset password** window is displayed.
4545

4646
2. Select **Reset password**, enter a username and a password, and then select **Update**.
47+
4748
> [!TIP]
48-
> If you enter a different name than the current local admin account on your VM, the VMAccess extension adds a local admin account with that name, and assign your specified password to that account. If the local admin account on your VM exists, the VMAccess extension resets the password. If the account is disabled, the VMAccess extension enables it.
49-
3. Try connecting to your VM again.
49+
> If you enter a different name than the current local admin account on your VM, the VMAccess extension adds a local admin account that has that name, and assigns your specified password to that account. If the local admin account on your VM exists, the VMAccess extension resets the password. If the account is disabled, the VMAccess extension enables it.
50+
3. Try again to connect to your VM.
5051

5152
### **Reset the Remote Desktop Services configuration**
5253

@@ -60,7 +61,7 @@ This process enables Remote Desktop service in the VM, and creates a firewall ru
6061

6162
## Reset by using the Azure PowerShell
6263

63-
Make sure that you have the [latest PowerShell module installed and configured](/powershell/azure/) and that you're signed in to your Azure subscription by using the [Connect-AzAccount](/powershell/module/az.accounts/connect-azaccount) cmdlet.
64+
Make sure that you have the [latest PowerShell module installed and configured](/powershell/azure/) and that you're signed in to your Azure subscription by using the [Connect-AzAccount](/powershell/module/az.accounts/connect-azaccount) cmdlet.
6465

6566
### Reset the local admin account password
6667

@@ -90,7 +91,7 @@ Make sure that you have the [latest PowerShell module installed and configured]
9091
```
9192
9293
> [!TIP]
93-
> At any point, a VM can have only a single VM access agent. To set the VM access agent properties, use the `-ForceRerun` option. When you use `-ForceRerun`, make sure that you use the same name for the VM access agent that you used in any previous commands.
94+
> At any time, a VM can have only a single VM access agent. To set the VM access agent properties, use the `-ForceRerun` option. When you use `-ForceRerun`. Make sure that you use the same name for the VM access agent that you used in any previous commands.
9495
9596
If you still can't connect remotely to your VM, see [Troubleshoot Remote Desktop connections to a Windows-based Azure virtual machine](troubleshoot-rdp-connection.md). If you lose the connection to the Windows domain controller, restore it from a domain controller backup.
9697

0 commit comments

Comments
 (0)