Skip to main content

agent_registration_information

Creates, updates, deletes, gets or lists an agent_registration_information resource.

Overview

Nameagent_registration_information
TypeResource
Idazure.automation.agent_registration_information

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringGets or sets the id.
dscMetaConfigurationstringGets or sets the dsc meta configuration.
endpointstringGets or sets the dsc server endpoint.
keysobjectGets or sets the agent registration keys.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectsubscriptionId, resourceGroupName, automationAccountNameRetrieve the automation agent registration information.
regenerate_keyexecsubscriptionId, resourceGroupName, automationAccountName, keyNameRegenerate a primary or secondary agent registration key

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.
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.

SELECT examples

Retrieve the automation agent registration information.

SELECT
id,
dscMetaConfiguration,
endpoint,
keys
FROM azure.automation.agent_registration_information
WHERE subscriptionId = '{{ subscriptionId }}' -- required
AND resourceGroupName = '{{ resourceGroupName }}' -- required
AND automationAccountName = '{{ automationAccountName }}' -- required
;

Lifecycle Methods

Regenerate a primary or secondary agent registration key

EXEC azure.automation.agent_registration_information.regenerate_key 
@subscriptionId='{{ subscriptionId }}' --required,
@resourceGroupName='{{ resourceGroupName }}' --required,
@automationAccountName='{{ automationAccountName }}' --required
@@json=
'{
"keyName": "{{ keyName }}"
}'
;