dsc_nodes
Creates, updates, deletes, gets or lists a dsc_nodes resource.
Overview
| Name | dsc_nodes |
| Type | Resource |
| Id | azure.automation.dsc_nodes |
Fields
The following fields are returned by SELECT queries:
- get
- list_by_automation_account
| Name | Datatype | Description |
|---|---|---|
properties | object | The properties of a DscNode. |
| Name | Datatype | Description |
|---|---|---|
properties | object | The properties of a DscNode. |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get | select | resourceGroupName, automationAccountName, nodeId, subscriptionId | Retrieve the dsc node identified by node id. | |
list_by_automation_account | select | resourceGroupName, automationAccountName, subscriptionId | $filter, $skip, $top, $inlinecount | Retrieve a list of dsc nodes. |
update | update | resourceGroupName, automationAccountName, nodeId, subscriptionId | Update the dsc node. | |
delete | delete | resourceGroupName, automationAccountName, nodeId, subscriptionId | Delete 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.
| Name | Datatype | Description |
|---|---|---|
automationAccountName | string | The name of the automation account. |
nodeId | string | The node id. |
resourceGroupName | string | Name of an Azure Resource group. |
subscriptionId | string | Gets subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. |
$filter | string | The filter to apply on the operation. |
$inlinecount | string | Return total rows. |
$skip | integer | The number of rows to skip. |
$top | integer | The number of rows to take. |
SELECT examples
- get
- list_by_automation_account
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
;
Retrieve a list of dsc nodes.
SELECT
properties
FROM azure.automation.dsc_nodes
WHERE resourceGroupName = '{{ resourceGroupName }}' -- required
AND automationAccountName = '{{ automationAccountName }}' -- required
AND subscriptionId = '{{ subscriptionId }}' -- required
AND $filter = '{{ $filter }}'
AND $skip = '{{ $skip }}'
AND $top = '{{ $top }}'
AND $inlinecount = '{{ $inlinecount }}'
;
UPDATE examples
- update
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
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
;