You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The VMAccess Extension is used to manage administrative users, configure SSH, and check or repair disks on Azure Linux virtual machines (VMs). The extension integrates with Azure Resource Manager templates. It can also be invoked using Azure CLI, Azure Powershell, the Azure portal, and the Azure Virtual Machines REST API.
16
+
The VMAccess Extension is used to manage administrative users, configure SSH, and check or repair disks on Azure Linux virtual machines. The extension integrates with Azure Resource Manager templates. It can also be invoked using Azure CLI, Azure PowerShell, the Azure portal, and the Azure Virtual Machines REST API.
17
17
18
18
This article describes how to run the VMAccess Extension from the Azure CLI and through an Azure Resource Manager template. This article also provides troubleshooting steps for Linux systems.
19
19
@@ -39,7 +39,7 @@ This article describes how to run the VMAccess Extension from the Azure CLI and
* VMAccess was designed for the purpose of regaining access to a VM in the event that access is lost. Based on this principle, it will grant sudo permission to account specified in the username field. If you don't wish a user to gain sudo permissions, login to the VM and use built-in tools (e.g. usermod, chage, etc.) to manage unprivileged users.
42
+
* VMAccess was designed for the purpose of regaining access to a VM in the event that access is lost. Based on this principle, it will grant sudo permission to account specified in the username field. If you don't wish a user to gain sudo permissions, login to the VM and use built-in tools (for example, usermod, chage, etc.) to manage unprivileged users.
43
43
* You can only have one version of the extension applied to a VM. To run a second action, update the existing extension with a new configuration.
44
44
* During a user update, VMAccess alters the `sshd_config` file and takes a backup of it beforehand. To restore the original backed-up SSH configuration, run VMAccess with `restore_backup_ssh` set to `True`.
45
45
@@ -99,7 +99,7 @@ The VMAccess Extension configuration includes settings for username, passwords,
99
99
| username | string | The name of the user to manage (required for all actions on a user account). |
100
100
| password | string | The password to set for the user account. |
101
101
| ssh_key | string | The SSH public key to add for the user account. The SSH key can be in `ssh-rsa`, `ssh-ed25519`, or `.pem` format. |
102
-
| reset_ssh | boolean | Whether or not to reset the SSH. If `true`, it will replace the sshd_config file with an internal resource file corresponding to the default SSH config for that distro. |
102
+
| reset_ssh | boolean | Whether or not to reset the SSH. If `true`, it replaces the sshd_config file with an internal resource file corresponding to the default SSH config for that distro. |
103
103
| remove_user | string | The name of the user to remove. Can't be used with `reset_ssh`, `restore_backup_ssh`, and `password`. |
104
104
| expiration | string | Expiration to set to for the account, in the form of `yyyy-mm-dd`. Defaults to never. |
105
105
| remove_prior_keys | boolean | Whether or not to remove old SSH keys when adding a new one. Must be used with `ssh_key`. |
You can also provide and modify extension settings through the use of strings:
242
+
You can also provide and modify extension settings by using strings:
243
243
244
244
```azurepowershell-interactive
245
245
$username = "<username>"
@@ -301,7 +301,7 @@ The VMAccess extension logs exist locally on the VM and are most informative whe
301
301
| Location | Description |
302
302
| ---- | ---- |
303
303
| /var/log/waagent.log | Shows when an update to the extension occurred. This contains logs from the Linux Agent, and we can check it to ensure the extension ran. |
304
-
| /var/log/azure/Microsoft.OSTCExtensions.VMAccessForLinux/*| The VMAccess Extension produces logs which can be found here. Here you will see a `CommandExecution.log` where you can find each command executed along with its result. There is also an `extension.log` file which contains individual logs for each execution. |
304
+
| /var/log/azure/Microsoft.OSTCExtensions.VMAccessForLinux/*| The VMAccess Extension produces logs, which can be found here. The directory contains `CommandExecution.log` where you can find each command executed along with its result, along with `extension.log` which contains individual logs for each execution. |
305
305
| /var/lib/waagent/Microsoft.OSTCExtensions.VMAccessForLinux-\<most recent version\>/config/*| The configuration and binaries for VMAccess VM Extension. |
0 commit comments