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/troubleshoot/desired-state-configuration.md
+9-9Lines changed: 9 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -21,7 +21,7 @@ This article provides information on troubleshooting issues that arise while you
21
21
22
22
When you receive a compilation or deployment error for configuration, here are a few steps to help you diagnose the issue.
23
23
24
-
### 1. Ensure that your configuration compiles successfully on the local machine.
24
+
### 1. Ensure that your configuration compiles successfully on the local machine
25
25
26
26
Azure Automation State Configuration is built on PowerShell Desired State Configuration (DSC). You can find the documentation for the DSC language and syntax in the [PowerShell DSC Docs](https://docs.microsoft.com/powershell/scripting/overview).
27
27
@@ -31,7 +31,7 @@ By compiling a DSC configuration on your local machine, you can discover and res
31
31
- Syntax errors.
32
32
- Logic errors.
33
33
34
-
### 2. View DSC logs on your node.
34
+
### 2. View DSC logs on your node
35
35
36
36
If your configuration compiles successfully, but fails when applied to a node, you can find detailed information in the DSC logs. For information about where to find these logs, see [Where are the DSC Event Logs](/powershell/scripting/dsc/troubleshooting/troubleshooting#where-are-dsc-event-logs).
37
37
@@ -43,7 +43,7 @@ To install the `xDscDiagnostics` module on your Azure machine, use [Invoke-AzVMR
43
43
44
44
For information on using **xDscDiagnostics**, see [Using xDscDiagnostics to analyze DSC logs](/powershell/scripting/dsc/troubleshooting/troubleshooting#using-xdscdiagnostics-to-analyze-dsc-logs). See also [xDscDiagnostics Cmdlets](https://github.com/PowerShell/xDscDiagnostics#cmdlets).
45
45
46
-
### 3. Ensure that nodes and the Automation workspace have required modules.
46
+
### 3. Ensure that nodes and the Automation workspace have required modules
47
47
48
48
DSC depends on modules installed on the node. When you use Azure Automation State Configuration, import any required modules into your Automation account by following the steps in [Import Modules](../shared-resources/modules.md#importing-modules). Configurations can also have a dependency on specific versions of modules. For more information, see [Troubleshoot modules](shared-resources.md#modules).
49
49
@@ -114,19 +114,19 @@ This issue might also be caused by a proxy configuration not allowing access to
114
114
115
115
Use the following steps to reregister the failing DSC node.
116
116
117
-
#### Step 1: Unregister the node.
117
+
#### Step 1: Unregister the node
118
118
119
119
1. In the Azure portal, go to **Home** > **Automation Accounts** > (your Automation account) > **State configuration (DSC)**.
120
120
1. Select **Nodes**, and select the node having trouble.
121
121
1. Select **Unregister** to unregister the node.
122
122
123
-
#### Step 2: Uninstall the DSC extension from the node.
123
+
#### Step 2: Uninstall the DSC extension from the node
124
124
125
125
1. In the Azure portal, go to **Home** > **Virtual Machine** > (failing node) > **Extensions**.
126
126
1. Select **Microsoft.Powershell.DSC**, the PowerShell DSC extension.
127
127
1. Select **Uninstall** to uninstall the extension.
128
128
129
-
#### Step 3: Remove all bad or expired certificates from the node.
129
+
#### Step 3: Remove all bad or expired certificates from the node
130
130
131
131
On the failing node from an elevated PowerShell prompt, run these commands:
132
132
@@ -146,7 +146,7 @@ If (($certs.Count) -gt 0)
146
146
}
147
147
```
148
148
149
-
#### Step 4: Reregister the failing node.
149
+
#### Step 4: Reregister the failing node
150
150
151
151
1. In the Azure portal, go to **Home** > **Automation Accounts** > (your Automation account) > **State configuration (DSC)**.
152
152
1. Select **Nodes**.
@@ -274,7 +274,7 @@ Treat the cross-subscription node as though it's defined for a separate cloud, o
274
274
* Windows: [Physical/virtual Windows machines on-premises, or in a cloud other than Azure/AWS](../automation-dsc-onboarding.md#onboarding-physicalvirtual-windows-machines).
275
275
* Linux: [Physical/virtual Linux machines on-premises, or in a cloud other than Azure](../automation-dsc-onboarding.md#onboarding-physicalvirtual-linux-machines).
## <aname="agent-has-a-problem"></a>Scenario: "Provisioning has failed" error message
278
278
279
279
### Issue
280
280
@@ -344,4 +344,4 @@ If you don't see your problem here or you can't resolve your issue, try one of t
344
344
345
345
* Get answers from Azure experts through [Azure Forums](https://azure.microsoft.com/support/forums/).
346
346
* Connect with [@AzureSupport](https://twitter.com/azuresupport), the official Microsoft Azure account for improving customer experience. Azure Support connects the Azure community to answers, support, and experts.
347
-
* File an Azure support incident. Go to the [Azure support site](https://azure.microsoft.com/support/options/), and select **Get Support**.
347
+
* File an Azure support incident. Go to the [Azure support site](https://azure.microsoft.com/support/options/), and select **Get Support**.
0 commit comments