Skip to main content

consoles

Creates, updates, deletes, gets or lists a consoles resource.

Overview

Nameconsoles
TypeResource
Idazure.serial_console.consoles

Fields

The following fields are returned by SELECT queries:

OK - Returns a JSON object

NameDatatypeDescription
propertiesobject

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_statusselectsubscriptionId, defaultGets whether or not Serial Console is disabled for a given subscription
disableexecsubscriptionId, defaultDisables the Serial Console service for all VMs and VM scale sets in the provided subscription
enableexecsubscriptionId, defaultEnables the Serial Console service for all VMs and VM scale sets in the provided subscription

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
defaultstringDefault parameter. Leave the value as "default".
subscriptionIdstring (uuid)The ID of the target subscription. The value must be an UUID.

SELECT examples

Gets whether or not Serial Console is disabled for a given subscription

SELECT
properties
FROM azure.serial_console.consoles
WHERE subscriptionId = '{{ subscriptionId }}' -- required
AND default = '{{ default }}' -- required
;

Lifecycle Methods

Disables the Serial Console service for all VMs and VM scale sets in the provided subscription

EXEC azure.serial_console.consoles.disable 
@subscriptionId='{{ subscriptionId }}' --required,
@default='{{ default }}' --required
;