Skip to content

Commit b70b685

Browse files
committed
Feedback incorporated
1 parent 8573fe2 commit b70b685

File tree

1 file changed

+25
-26
lines changed

1 file changed

+25
-26
lines changed

articles/automation/extension-based-hybrid-runbook-worker-install.md

Lines changed: 25 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: This article provides information about deploying the extension-bas
44
services: automation
55
ms.subservice: process-automation
66
ms.custom: devx-track-azurepowershell, devx-track-azurecli, devx-track-bicep, linux-related-content
7-
ms.date: 04/21/2025
7+
ms.date: 04/22/2025
88
ms.topic: how-to
99
#Customer intent: As a developer, I want to learn about extension so that I can efficiently deploy Hybrid Runbook Workers.
1010
ms.service: azure-automation
@@ -80,7 +80,28 @@ If extension-based Hybrid Worker is using custom Hybrid Worker credentials, then
8080
> - When a system has UAC/LUA in place, permissions must be granted directly and not through any group membership. [Learn more](troubleshoot/extension-based-hybrid-runbook-worker.md#scenario-runbooks-go-into-a-suspended-state-on-a-hybrid-runbook-worker-when-using-a-custom-account-on-a-server-with-user-account-control-uac-enabled).
8181
> - Due to a current limitation, these folder permissions are removed from the C:\ProgramData\AzureConnectedMachineAgent\Tokens folder on Azure Arc-enabled machines when the Azure Connected Machine agent is updated. The current resolution is to reapply these permissions to the folder. [Learn more](troubleshoot/extension-based-hybrid-runbook-worker.md#scenario-hybrid-runbook-worker-job-execution-on-azure-arc-enabled-windows-server-that-uses-a-custom-credential-is-unexpectedly-suspended).
8282
83+
## Automation account hybrid service url
8384

85+
You must retrieve and use the AutomationHybridServiceURL to deploy the Hybrid Worker extension to the VM/Arc machine.
86+
87+
> [!NOTE]
88+
> The necessary URL is the automationHybridServiceUrl, NOT the RegistrationUrl.
89+
90+
There are multiple ways to retrieve the value for AutomationHybridServiceUrl:
91+
92+
- Copy it from the **Azure portal**, **Automation Account**, **Properties**, **Automation hybrid service URL**.
93+
94+
Or
95+
96+
- Copy it from the **Azure portal**, **Automation Account**, **Overview**, **JSON** view. </br> Select the latest API version, otherwise AutomationHybridServiceUrl might not be displayed.
97+
98+
Or
99+
- The below REST API call:
100+
101+
```rest
102+
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}?api-version=2023-11-01
103+
104+
```
84105

85106
## Network requirements
86107

@@ -103,30 +124,6 @@ If you use a proxy server for communication between Azure Automation and machine
103124
The API call will provide the value with the key: `AutomationHybridServiceUrl`. Use the URL in the next step to enable extension on the VM.
104125

105126
1. Install the Hybrid Worker Extension on the VM by running the following PowerShell cmdlet (Required module: Az.Compute). Use the `properties.automationHybridServiceUrl` provided by the above API call
106-
107-
108-
## Automation Account Hybrid Service URL
109-
110-
You must retrieve and use the AutomationHybridServiceURL to deploy the Hybrid Worker extension to the VM/Arc machine.
111-
112-
> [!NOTE]
113-
> The necessary URL is the automationHybridServiceUrl, NOT the RegistrationUrl.
114-
115-
There are multiple ways to retrieve the value for AutomationHybridServiceUrl:
116-
117-
- Copy it from the **Azure portal**, **Automation Account**, **Properties**, **Automation hybrid service URL**.
118-
119-
Or
120-
121-
- Copy it from the **Azure portal**, **Automation Account**, **Overview**, **JSON** view. </br> Select the latest API version, otherwise AutomationHybridServiceUrl might not be displayed.
122-
123-
Or
124-
- The below REST API call:
125-
126-
```rest
127-
GET https://westcentralus.management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}?api-version=2021-06-22
128-
129-
```
130127

131128
# [Windows](#tab/windows)
132129

@@ -364,9 +361,11 @@ Follow the steps mentioned below as an example:
364361
```
365362
1. Follow the steps [here](../active-directory/managed-identities-azure-resources/qs-configure-portal-windows-vm.md#enable-system-assigned-managed-identity-on-an-existing-vm) to enable the System-assigned managed identity on the VM.
366363
367-
1. Install Hybrid Worker Extension on the VM and Hybrid Worker extension settings for [proxy server use](#proxy-server-use).
364+
1. Install Hybrid Worker Extension on the VM.
368365
369366
**Hybrid Worker extension settings**
367+
368+
If you want to add proxy server, see [proxy server use](#proxy-server-use).
370369
371370
```powershell-interactive
372371
$settings = @{

0 commit comments

Comments
 (0)