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/runbooks.md
+11-11Lines changed: 11 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,15 +20,15 @@ ms.custom: has-adal-ref
20
20
21
21
## Diagnose runbook issues
22
22
23
-
When you receive errors during runbook execution in Azure Automation, you can use the following steps to help diagnose the issues.
23
+
When you receive errors during runbook execution in Azure Automation, you can use the following steps to help diagnose the issues:
24
24
25
25
1. Ensure that your runbook script executes successfully on your local machine.
26
26
27
27
For language reference and learning modules, see the [PowerShell Docs](/powershell/scripting/overview) or [Python Docs](https://docs.python.org/3/). Running your script locally can discover and resolve common errors, such as:
@@ -84,7 +84,7 @@ These errors occur if the credential asset name isn't valid. They might also occ
84
84
85
85
### Resolution
86
86
87
-
To determine what's wrong, follow these steps.
87
+
To determine what's wrong, follow these steps:
88
88
89
89
1. Make sure that you don't have any special characters. These characters include the `\@` character in the Automation credential asset name that you're using to connect to Azure.
90
90
1. Check to see if you can use the user name and password that are stored in the Azure Automation credential in your local PowerShell ISE editor. Run the following cmdlets in the PowerShell ISE.
@@ -97,7 +97,7 @@ To determine what's wrong, follow these steps.
97
97
Connect-AzAccount –Credential $Cred
98
98
```
99
99
100
-
1. If your authentication fails locally, you haven't set up your Azure Active Directory credentials properly. To get the Azure Active Directory account set up correctly, see the blog post [Authenticating to Azure using Azure Active Directory](https://azure.microsoft.com/blog/azure-automation-authenticating-to-azure-using-azure-active-directory/).
100
+
1. If your authentication fails locally, you haven't set up your Azure Active Directory (Azure AD) credentials properly. To get the Azure AD account set up correctly, see the blog post [Authenticating to Azure using Azure Active Directory](https://azure.microsoft.com/blog/azure-automation-authenticating-to-azure-using-azure-active-directory/).
101
101
102
102
1. If the error appears to be transient, try adding retry logic to your authentication routine to make authenticating more robust.
103
103
@@ -146,7 +146,7 @@ This error has two primary causes:
146
146
147
147
If you receive this error after you update one AzureRM or Az module, update all your modules to the same version.
148
148
149
-
If you're trying to access resources in another subscription, follow these steps to configure permissions.
149
+
If you're trying to access resources in another subscription, follow these steps to configure permissions:
150
150
151
151
1. Go to the Automation Run As account, and copy the **Application ID** and **Thumbprint**.
152
152
@@ -194,12 +194,12 @@ The subscription named <subscription name> cannot be found.
194
194
This error can occur if:
195
195
196
196
* The subscription name isn't valid.
197
-
* The Azure Active Directory (Azure AD) user who's trying to get the subscription details isn't configured as an administrator of the subscription.
197
+
* The Azure AD user who's trying to get the subscription details isn't configured as an administrator of the subscription.
198
198
* The cmdlet isn't available.
199
199
200
200
### Resolution
201
201
202
-
Follow these steps to determine if you've authenticated to Azure and have access to the subscription that you're trying to select.
202
+
Follow these steps to determine if you've authenticated to Azure and have access to the subscription that you're trying to select:
203
203
204
204
1. To make sure that your script works standalone, test it outside of Azure Automation.
205
205
1. Make sure that your script runs the [Connect-AzAccount](https://docs.microsoft.com/powershell/module/Az.Accounts/Connect-AzAccount?view=azps-3.7.0) cmdlet before running the `Select-*` cmdlet.
@@ -290,7 +290,7 @@ This error can be caused by using outdated Azure modules.
290
290
291
291
### Resolution
292
292
293
-
You can resolve this error by updating your Azure modules to the latest version.
293
+
You can resolve this error by updating your Azure modules to the latest version:
294
294
295
295
1. In your Automation account, select **Modules**, and then select **Update Azure modules**.
296
296
1. The update takes roughly 15 minutes. After it's finished, rerun the runbook that failed.
@@ -504,7 +504,7 @@ This error occurs when the job execution exceeds the 500-minute free quota for y
504
504
505
505
### Resolution
506
506
507
-
If you want to use more than 500 minutes of processing per month, change your subscription from the Free tier to the Basic tier.
507
+
If you want to use more than 500 minutes of processing per month, change your subscription from the Free tier to the Basic tier:
0 commit comments