Skip to content

Commit 17218a7

Browse files
committed
Clarify enable/disable and update screenshots
1 parent 3a53927 commit 17218a7

File tree

4 files changed

+6
-3
lines changed

4 files changed

+6
-3
lines changed
Loading
Loading

articles/virtual-machines/troubleshooting/serial-console-enable-disable.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -27,11 +27,11 @@ You can also disable serial console for an individual VM or virtual machine scal
2727
The serial console can be disabled for a specific VM or virtual machine scale set by disabling the boot diagnostics setting. Turn off boot diagnostics from the Azure Portal to disable the serial console for the VM or the virtual machine scale set. If you are using serial console on a virtual machine scale set, ensure you upgrade your virtual machine scale set instances to the latest model.
2828

2929

30-
## Subscription-level disable
30+
## Subscription-level enable/disable
3131

3232
### Azure CLI
3333

34-
Serial console can be disabled and re-enabled for an entire subscription by using the following commands in the Azure CLI:
34+
Serial console can be disabled and re-enabled for an entire subscription by using the following commands in the Azure CLI (you may use the "Try it" button to launch an instance of the Azure Cloud Shell in which you can run the commands):
3535

3636
To disable serial console for a subscription, use the following commands:
3737
```azurecli-interactive
@@ -54,6 +54,9 @@ subscriptionId=$(az account show --output=json | jq -r .id)
5454
az resource show --ids "/subscriptions/$subscriptionId/providers/Microsoft.SerialConsole/consoleServices/default" --output=json --api-version="2018-05-01" | jq .properties
5555
```
5656

57+
> [!NOTE]
58+
> Ensure you are in the right cloud (Azure Public Cloud, Azure US Government Cloud) before running this command. You can check with `az cloud list` and set your cloud with `az cloud set -n <Name of cloud>`.
59+
5760
### PowerShell
5861

5962
Serial console can also be enabled and disabled using PowerShell.

articles/virtual-machines/troubleshooting/serial-console-errors.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ There are a set of known errors within the Azure Serial Console. This is a list
2424

2525
Error | Mitigation
2626
:---------------------------------|:--------------------------------------------|
27-
Unable to retrieve boot diagnostics settings for *&lt;VMNAME&gt;*. To use the serial console, ensure that boot diagnostics is enabled for this VM. ![Boot diagnostics error](./media/virtual-machines-serial-console/virtual-machines-serial-console-boot-diagnostics-error.png) | Ensure that the VM or virtual machine scale set has [boot diagnostics](boot-diagnostics.md) enabled. If you are using serial console on a virtual machine scale set instance, ensure that your instance has the latest model.
27+
Azure Serial Console requires boot diagnostics to be enabled. Click here to configure boot diagnostics for your virtual machine.![Boot diagnostics error](./media/virtual-machines-serial-console/virtual-machines-serial-console-boot-diagnostics-error.png) | Ensure that the VM or virtual machine scale set has [boot diagnostics](boot-diagnostics.md) enabled. If you are using serial console on a virtual machine scale set instance, ensure that your instance has the latest model.
2828
The VM is in a stopped deallocated state. Start the VM and retry the serial console connection. ![Deallocated error](./media/virtual-machines-serial-console/virtual-machines-serial-console-deallocating-error.png) | The VM or virtual machine scale set instance must be in a started state to access the serial console. Start your VM or virtual machine scale set instance and try again.
2929
A "Forbidden" response was encountered when accessing this VM's boot diagnostic storage account. ![Storage account firewall error](./media/virtual-machines-serial-console/virtual-machines-serial-console-firewall-error.png)| Ensure that boot diagnostics doesn't have an account firewall. An accessible boot diagnostic storage account is necessary for the serial console to function. Serial console by design cannot work with storage account firewalls enabled on the boot diagnostics storage account.
3030
You do not have the required permissions to use this VM with the serial console. Ensure you have at least Virtual Machine Contributor role permissions.| The serial console access requires you to have contributor level access or above on your VM or virtual machine scale set. For more information, see the [overview page](serial-console-overview.md).

0 commit comments

Comments
 (0)