You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/automation/automation-dsc-onboarding.md
+38-37Lines changed: 38 additions & 37 deletions
Original file line number
Diff line number
Diff line change
@@ -27,7 +27,8 @@ Configuration, see [Azure Automation State Configuration overview](automation-ds
27
27
28
28
Azure Automation State Configuration can be used to manage a variety of machines:
29
29
30
-
- Azure virtual machines (deployed both in classic and Azure Resource Manager deployment model)
30
+
- Azure virtual machines
31
+
- Azure virtual machines (classic)
31
32
- Amazon Web Services (AWS) EC2 instances
32
33
- Physical/virtual Windows machines on-premises, or in a cloud other than Azure/AWS
33
34
- Physical/virtual Linux machines on-premises, in Azure, or in a cloud other than Azure
@@ -42,6 +43,42 @@ with the desired state in Azure Automation.
42
43
43
44
The following sections outline how you can onboard each type of machine to Azure Automation State Configuration.
44
45
46
+
## Azure virtual machines
47
+
48
+
Azure Automation State Configuration lets you easily onboard Azure virtual machines for
49
+
configuration management, using either the Azure portal, Azure Resource Manager templates, or
50
+
PowerShell. Under the hood, and without an administrator having to remote into the VM, the Azure VM
51
+
Desired State Configuration extension registers the VM with Azure Automation State Configuration.
52
+
Since the Azure VM Desired State Configuration extension runs asynchronously, steps to track its
53
+
progress or troubleshoot it are provided in the following [**Troubleshooting Azure virtual machine onboarding**](#troubleshooting-azure-virtual-machine-onboarding) section.
54
+
55
+
### Azure portal
56
+
57
+
In the [Azure portal](https://portal.azure.com/), navigate to the Azure Automation account where
58
+
you want to onboard virtual machines. On the State Configuration page and the **Nodes** tab, click
59
+
**+ Add**.
60
+
61
+
Select an Azure virtual machine to onboard.
62
+
63
+
If the machine does not have the PowerShell desired state extension installed and the power state is running, click **Connect**.
64
+
65
+
Under **Registration**, enter the [PowerShell DSC Local Configuration Manager values](/powershell/dsc/metaconfig4)
66
+
required for your use case, and optionally a node configuration to assign to the VM.
Azure virtual machines can be deployed and onboarded to Azure Automation State Configuration via
73
+
Azure Resource Manager templates. See [Configure a VM via DSC extension and Azure Automation DSC](https://azure.microsoft.com/documentation/templates/dsc-extension-azure-automation-pullserver/)
74
+
for an example template that onboards an existing VM to Azure Automation State Configuration. To find the
75
+
registration key and registration URL taken as input in this template, see the following [**Secure registration**](#secure-registration) section.
76
+
77
+
### PowerShell
78
+
79
+
The [Register-AzureRmAutomationDscNode](/powershell/module/azurerm.automation/register-azurermautomationdscnode)
80
+
cmdlet can be used to onboard virtual machines in the Azure portal via PowerShell.
81
+
45
82
## Azure virtual machines (classic)
46
83
47
84
With Azure Automation State Configuration, you can easily onboard Azure virtual machines (classic)
@@ -133,42 +170,6 @@ $VM | Update-AzureVM
133
170
> [!NOTE]
134
171
> State Configuration Node Configuration names are case sensitive in the portal. If the case is mismatched the node will not show up under the **Nodes** tab.
135
172
136
-
## Azure virtual machines
137
-
138
-
Azure Automation State Configuration lets you easily onboard Azure virtual machines for
139
-
configuration management, using either the Azure portal, Azure Resource Manager templates, or
140
-
PowerShell. Under the hood, and without an administrator having to remote into the VM, the Azure VM
141
-
Desired State Configuration extension registers the VM with Azure Automation State Configuration.
142
-
Since the Azure VM Desired State Configuration extension runs asynchronously, steps to track its
143
-
progress or troubleshoot it are provided in the following [**Troubleshooting Azure virtual machine onboarding**](#troubleshooting-azure-virtual-machine-onboarding) section.
144
-
145
-
### Azure portal
146
-
147
-
In the [Azure portal](https://portal.azure.com/), navigate to the Azure Automation account where
148
-
you want to onboard virtual machines. On the State Configuration page and the **Nodes** tab, click
149
-
**+ Add**.
150
-
151
-
Select an Azure virtual machine to onboard.
152
-
153
-
If the machine does not have the PowerShell desired state extension installed and the power state is running, click **Connect**.
154
-
155
-
Under **Registration**, enter the [PowerShell DSC Local Configuration Manager values](/powershell/dsc/metaconfig4)
156
-
required for your use case, and optionally a node configuration to assign to the VM.
Azure virtual machines can be deployed and onboarded to Azure Automation State Configuration via
163
-
Azure Resource Manager templates. See [Configure a VM via DSC extension and Azure Automation DSC](https://azure.microsoft.com/documentation/templates/dsc-extension-azure-automation-pullserver/)
164
-
for an example template that onboards an existing VM to Azure Automation State Configuration. To find the
165
-
registration key and registration URL taken as input in this template, see the following [**Secure registration**](#secure-registration) section.
166
-
167
-
### PowerShell
168
-
169
-
The [Register-AzureRmAutomationDscNode](/powershell/module/azurerm.automation/register-azurermautomationdscnode)
170
-
cmdlet can be used to onboard virtual machines in the Azure portal via PowerShell.
171
-
172
173
## Amazon Web Services (AWS) virtual machines
173
174
174
175
You can easily onboard Amazon Web Services virtual machines for configuration management by Azure
0 commit comments