Skip to main content

dsc_nodes

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

Overview

Namedsc_nodes
TypeResource
Idazure.automation.dsc_nodes

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
propertiesobjectThe properties of a DscNode.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectresourceGroupName, automationAccountName, nodeId, subscriptionIdRetrieve the dsc node identified by node id.
list_by_automation_accountselectresourceGroupName, automationAccountName, subscriptionId$filter, $skip, $top, $inlinecountRetrieve a list of dsc nodes.
updateupdateresourceGroupName, automationAccountName, nodeId, subscriptionIdUpdate the dsc node.
deletedeleteresourceGroupName, automationAccountName, nodeId, subscriptionIdDelete the dsc node identified by node id.

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
automationAccountNamestringThe name of the automation account.
nodeIdstringThe node id.
resourceGroupNamestringName of an Azure Resource group.
subscriptionIdstringGets subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call.
$filterstringThe filter to apply on the operation.
$inlinecountstringReturn total rows.
$skipintegerThe number of rows to skip.
$topintegerThe number of rows to take.

SELECT examples

Retrieve the dsc node identified by node id.

SELECT
properties
FROM azure.automation.dsc_nodes
WHERE resourceGroupName = '{{ resourceGroupName }}' -- required
AND automationAccountName = '{{ automationAccountName }}' -- required
AND nodeId = '{{ nodeId }}' -- required
AND subscriptionId = '{{ subscriptionId }}' -- required
;

UPDATE examples

Update the dsc node.

UPDATE azure.automation.dsc_nodes
SET
data__nodeId = '{{ nodeId }}',
data__properties = '{{ properties }}'
WHERE
resourceGroupName = '{{ resourceGroupName }}' --required
AND automationAccountName = '{{ automationAccountName }}' --required
AND nodeId = '{{ nodeId }}' --required
AND subscriptionId = '{{ subscriptionId }}' --required
RETURNING
properties;

DELETE examples

Delete the dsc node identified by node id.

DELETE FROM azure.automation.dsc_nodes
WHERE resourceGroupName = '{{ resourceGroupName }}' --required
AND automationAccountName = '{{ automationAccountName }}' --required
AND nodeId = '{{ nodeId }}' --required
AND subscriptionId = '{{ subscriptionId }}' --required
;