Skip to content

Commit 9b2df7e

Browse files
committed
Merge branch 'main' of https://github.com/MicrosoftDocs/SupportArticles-docs-pr into dotnet-freshness-2025-batch2
2 parents d5f1c92 + 238ede3 commit 9b2df7e

File tree

28 files changed

+842
-444
lines changed

28 files changed

+842
-444
lines changed
Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,8 @@
11
{
22
"redirections": [
3-
3+
{
4+
"source_path": "Teams/teams-rooms-and-devices/mtr-device-cannot-fetch-calendar.md",
5+
"redirect_url": "/previous-versions/troubleshoot/content-retirement"
6+
}
47
]
58
}

Exchange/ExchangeOnline/outlook-on-the-web-issues/cannot-open-attachments.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -14,8 +14,8 @@ search.appverid:
1414
- MET150
1515
appliesto:
1616
- Exchange Online
17-
ms.date: 07/01/2025
18-
ms.reviewer: v-six
17+
ms.date: 07/15/2025
18+
ms.reviewer: fernandog
1919
---
2020
# Can't open or view attachments in Outlook on the web
2121

@@ -30,7 +30,7 @@ When Microsoft 365 users try to open or view attachments in email messages in Ou
3030

3131
This issue occurs if the attachment is blocked by Outlook on the web. By default, Outlook on the web blocks attachments that have the following file name extensions:
3232

33-
`.ade`,`.adp`,`.apk`,`.app`,`.appx`,`.appcontent-ms`,`.application`,`.appref-ms`,`.asp`,`.aspx`,`.asx`,`.bas`,`.bat`,`.bgi`,`.cab`,`.cdxml`,`.cer`,`.chm`,`.cmd`,`.cnt`,`.com`,`.cpl`,`.crt`,`.csh`,`.der`,`.diagcab`,`.exe`,`.fxp`,`.gadget`,`.grp`,`.hlp`,`.hpj`,`.hta`,`.htc`,`.img`,`.inf`,`.ins`,`.iso`,`.isp`,`.its`,`.jar`,`.jnlp`,`.js`,`.jse`,`.ksh`,`.lnk`,`.mad`,`.maf`,`.mag`,`.mam`,`.maq`,`.mar`,`.mas`,`.mat`,`.mau`,`.mav`,`.maw`,`.mcf`,`.mda`,`.mdb`,`.mde`,`.mdt`,`.mdw`,`.mdz`,`.mht`,`.mhtml`,`.msc`,`.msh`,`.msh1`,`.msh1xml`,`.msh2`,`.msh2xml`,`.mshxml`,`.msi`,`.msp`,`.mst`,`.msu`,`.ops`,`.osd`,`.pcd`,`.pif`,`.pl`,`.plg`,`.prf`,`.prg`,`.printerexport`,`.ps1`,`.ps1xml`,`.ps2`,`.ps2xml`,`.psc1`,`.psc2`,`.psd1`,`.psdm1`,`.pssc`,`.pst`,`.py`,`.pyc`,`.pyo`,`.pyw`,`.pyz`,`.pyzw`,`.reg`,`.scf`,`.scr`,`.sct`,`.settingcontent-ms`,`.shb`,`.shs`,`.theme`,`.tmp`,`.udl`,`.url`,`.vb`,`.vbe`,`.vbp`,`.vbs`,`.vhd`,`.vhdx`,`.vsmacros`,`.vsw`,`.webpnp`,`.website`,`.ws`,`.wsb`,`.wsc`,`.wsf`,`.wsh`,`.xbap`,`.xll`,`.xnk`,`.library-ms`,`.search-ms`
33+
`.ade`,`.adp`,`.apk`,`.app`,`.appx`,`.appcontent-ms`,`.application`,`.appref-ms`,`.asp`,`.aspx`,`.asx`,`.bas`,`.bat`,`.bgi`,`.cab`,`.cdxml`,`.cer`,`.chm`,`.cmd`,`.cnt`,`.com`,`.cpl`,`.crt`,`.csh`,`.der`,`.diagcab`,`.exe`,`.fxp`,`.gadget`,`.grp`,`.hlp`,`.hpj`,`.hta`,`.htc`,`.img`,`.inf`,`.ins`,`.iso`,`.isp`,`.its`,`.jar`,`.jnlp`,`.js`,`.jse`,`.ksh`,`.library-ms`,`.lnk`,`.mad`,`.maf`,`.mag`,`.mam`,`.maq`,`.mar`,`.mas`,`.mat`,`.mau`,`.mav`,`.maw`,`.mcf`,`.mda`,`.mdb`,`.mde`,`.mdt`,`.mdw`,`.mdz`,`.mht`,`.mhtml`,`.msc`,`.msh`,`.msh1`,`.msh1xml`,`.msh2`,`.msh2xml`,`.mshxml`,`.msi`,`.msp`,`.mst`,`.msu`,`.ops`,`.osd`,`.pcd`,`.pif`,`.pl`,`.plg`,`.prf`,`.prg`,`.printerexport`,`.ps1`,`.ps1xml`,`.ps2`,`.ps2xml`,`.psc1`,`.psc2`,`.psd1`,`.psdm1`,`.pssc`,`.pst`,`.py`,`.pyc`,`.pyo`,`.pyw`,`.pyz`,`.pyzw`,`.reg`,`.scf`,`.scr`,`.search-ms`,`.sct`,`.settingcontent-ms`,`.shb`,`.shs`,`.theme`,`.tmp`,`.udl`,`.url`,`.vb`,`.vbe`,`.vbp`,`.vbs`,`.vhd`,`.vhdx`,`.vsmacros`,`.vsw`,`.webpnp`,`.website`,`.ws`,`.wsb`,`.wsc`,`.wsf`,`.wsh`,`.xbap`,`.xll`,`.xnk`
3434

3535
## Resolution
3636

Teams/TOC.yml

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -274,8 +274,6 @@ items:
274274
href: ./teams-rooms-and-devices/teams-rooms-device-keyboard-size-reduced.md
275275
- name: Teams Rooms app doesn't start automatically after updates
276276
href: ./teams-rooms-and-devices/teams-rooms-not-auto-start-after-windows-updates.md
277-
- name: Teams Rooms devices can't fetch calendar
278-
href: ./teams-rooms-and-devices/mtr-device-cannot-fetch-calendar.md
279277
- name: Teams Rooms Pro Management
280278
items:
281279
- name: Get support for Teams Rooms Pro Management
Binary file not shown.

Teams/teams-rooms-and-devices/mtr-device-cannot-fetch-calendar.md

Lines changed: 0 additions & 64 deletions
This file was deleted.
Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
---
2+
title: Troubleshoot Hybrid Runbook Worker Job Failures in Azure Automation
3+
description: Discusses some common issues that might occur when you run a runbook on Hybrid Runbook Worker.
4+
ms.date: 06/13/2025
5+
ms.reviewer: adoyle
6+
ms.service: azure-automation
7+
ms.custom: sap:Runbook not working as expected
8+
---
9+
10+
# Hybrid Runbook Worker job isn't working as expected
11+
12+
This article provides guidance for troubleshooting and resolving issues that affect Hybrid Runbook Worker in Azure Automation.
13+
14+
> [!NOTE]
15+
> Azure Automation enables the recovery of runbooks that are deleted in the past 29 days. For more information, see [Restore deleted runbook](/azure/automation/manage-runbooks#restore-deleted-runbook).
16+
17+
## Troubleshoot connectivity issues
18+
19+
Connectivity problems are a common cause of issues that affect runbooks. Use the [Test Cloud Connectivity tool](/azure/azure-monitor/agents/agent-windows-troubleshoot?tabs=UpdateMMA#connectivity-issues) to verify that your environment is correctly configured.
20+
21+
## General troubleshooting
22+
23+
| **Issue** | **Resolution** |
24+
|----------|----------------|
25+
| Runbooks behave differently on a hybrid worker than in Azure Automation. | See [Runbook permissions](/azure/automation/automation-hrw-run-runbooks#runbook-permissions) for information about authentication differences. |
26+
| Error: No certificate was found. | Follow the "[No Certificate Found](/azure/automation/troubleshoot/hybrid-runbook-worker#no-cert-found)" section in the troubleshooting guide. |
27+
| You need to troubleshoot a custom runbook. | See [Troubleshoot runbook issues](/azure/automation/troubleshoot/runbooks). |
28+
| You need to check job status. | Review [job details and statuses](/azure/automation/automation-runbook-execution#job-statuses). |
29+
| Hybrid worker doesn't run jobs or is unresponsive. | Troubleshoot by using [Hybrid Runbook Worker diagnostics](/azure/automation/troubleshoot/hybrid-runbook-worker). |
30+
| Runbooks suddenly stop working. | Make sure that you [migrated to managed identity](/azure/automation/migrate-run-as-accounts-managed-identity?tabs=sa-managed-identity#cert-renewal) and that webhooks aren't expired. |
31+
| Need help with passing parameters into a webhook. | See [Start a runbook from a webhook](/azure/automation/automation-webhooks#parameters-used-when-the-webhook-starts-a-runbook). |
32+
| You want to use both `Az` and `AzureRM` modules in runbook. | This scenario isn't supported. Use only [Az modules in runbooks](/azure/automation/automation-update-azure-modules). |
33+
| Can't start or schedule a runbook. | Verify that the runbook is in a [published state](/azure/automation/manage-runbooks#publish-a-runbook). |
34+
| Runbook is suspended or failed unexpectedly. | Review [job statuses](/azure/automation/automation-runbook-execution#job-statuses). Add logging to the runbook by using [output streams](/azure/automation/automation-runbook-output-and-messages#working-with-message-streams). If the job fails three times, check [the automation limits](/azure/azure-resource-manager/management/azure-subscription-service-limits#automation-limits) and consider using a [Hybrid Worker](/azure/automation/automation-hybrid-runbook-worker). |
35+
36+
37+
### Windows Hybrid Runbook Worker issues
38+
39+
| **Issue** | **Resolution** |
40+
|-----------|----------------|
41+
| Event 4502 appears in the Operations Manager log. | See [Event 4502](/azure/automation/troubleshoot/hybrid-runbook-worker#event-4502). |
42+
| Script using `Connect-MsolService` can't connect to Microsoft 365. | See [Sandbox can't connect to Microsoft 365](/azure/automation/troubleshoot/hybrid-runbook-worker#scenario-orchestratorsandboxexe-cant-connect-to-microsoft-365-through-proxy). |
43+
| Machine is running but not sending heartbeat data. | See [Hybrid worker not reporting](/azure/automation/troubleshoot/hybrid-runbook-worker#corrupt-cache). |
44+
45+
46+
### Linux Hybrid Runbook Worker issues
47+
48+
| **Issue** | **Resolution** |
49+
|-----------|----------------|
50+
| Unexpected password prompt appears when using `sudo`. | See [Linux runbook worker prompts for password](/azure/automation/troubleshoot/hybrid-runbook-worker#prompt-for-password). |
51+
| Log file shows "The specified class does not exist." | See [Class does not exist error](/azure/automation/troubleshoot/hybrid-runbook-worker#class-does-not-exist). |
52+
| Linux job is stuck in **Running** state | 1. Switch to `sudo` permissions: `sudo su`<br>2. Make sure that the `hwd` service is running: `systemctl status hwd.service`<br>3. Open the following file in Hybrid Worker: `vi /lib/systemd/system/hwd.service`<br>4. Update the setting from `CPUQuota=25%` to `CPUQuota=` to make the usage unrestricted, as shown in the following example: <br><br>`[Unit]`<br>`Description=HW Service`<br>`After=network.target`<br>`[Service]`<br>`Type=simple`<br>`ExecStart=/usr/bin/python3 .../automationWorkerStarterScript.py`<br>`TimeoutStartSec=5`<br>`Restart=always`<br>`RestartSec=10s`<br>`TimeoutStopSec=600`<br>`CPUQuota=`<br>`KillMode=process`<br>`[Install]`<br>`WantedBy=multi-user.target`<br><br> 5. Restart the `hwd` service: <br>`systemctl daemon-reload` <br> `systemctl restart hwd.service`<br>|
53+
54+
## Other error messages
55+
56+
| **Error** | **Resolution** |
57+
|-----------|----------------|
58+
| "The subscription cannot be found" | This error usually means that the runbook isn't using a managed identity. Follow the steps in [Unable to find subscription](/azure/automation/troubleshoot/runbooks#unable-to-find-subscription). |
59+
| "Strong authentication enrollment is required." | See [Authentication to Azure failed due to MFA](/azure/automation/troubleshoot/runbooks#auth-failed-mfa). |
60+
| "No permission" or similar error | Make sure that the [managed identity has appropriate permissions](/azure/role-based-access-control/role-assignments-portal). |
61+
62+
## Reference
63+
64+
- [Automation Hybrid Runbook Worker overview](/azure/automation/automation-hybrid-runbook-worker)
65+
- [Deploy a Windows Hybrid Runbook Worker](/azure/automation/automation-windows-hrw-install)
66+
- [Deploy a Linux Hybrid Runbook Worker](/azure/automation/automation-linux-hrw-install)
67+
- [Run runbooks on a Hybrid Runbook Worker](/azure/automation/automation-hrw-run-runbooks)

support/azure/automation/toc.yml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,8 @@
22
href: welcome-automation.yml
33
- name: Runbook not working as expected
44
items:
5+
- name: Hybrid Runbook Worker job isn't working
6+
href: runbooks/runbook-fails-on-hybrid-worker.md
57
- name: Runbook jobs get suspended
68
href: runbooks/runbook-job-suspended.md
79
- name: Troubleshoot error codes during runbook execution
@@ -14,3 +16,5 @@
1416
href: runbooks/troubleshoot-runbook-execution-issues.md
1517
- name: Troubleshoot runbook execution issues when using PowerShell
1618
href: runbooks/powershell-job-script-cmdlets-not-working.md
19+
- name: Troubleshoot Hybrid Runbook Worker Job Failures
20+
href: runbooks/troubleshoot-runbook-execution-issues.md

0 commit comments

Comments
 (0)