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/extension-based-hybrid-runbook-worker-install.md
+10-10Lines changed: 10 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -301,11 +301,11 @@ Follow the steps mentioned below as an example:
301
301
302
302
1. Create a Hybrid Worker Group.
303
303
1. Create either an Azure VM or Arc-enabled server. Alternatively, you can also use an existing Azure VM or Arc-enabled server.
304
-
1. Connect the Azure VM or Arc-enabled Server to the above created Hybrid Worker Group.
304
+
1. Connect the Azure VM or Arc-enabled server to the above created Hybrid Worker Group.
305
305
1. Generate a new GUID and pass it as the name of the Hybrid Worker.
306
306
1. Enable System-assigned managed identity on the VM.
307
307
1. Install Hybrid Worker Extension on the VM.
308
-
1. To confirm if the extension has been successfully installed on the VM, In**Azure portal**, go to the VM > **Extensions** tab and check the status of Hybrid Worker extension installed on the VM.
308
+
1. To confirm if the extension has been successfully installed on the VM, in**Azure portal**, go to the VM > **Extensions** tab and check the status of the Hybrid Worker extension installed on the VM.
309
309
310
310
```Bicep
311
311
param automationAccount string
@@ -538,11 +538,11 @@ Follow the steps mentioned below as an example:
538
538
539
539
1. Create a Hybrid Worker Group.
540
540
1. Create either an Azure VM or Arc-enabled server. Alternatively, you can also use an existing Azure VM or Arc-enabled server.
541
-
1. Connect the Azure VM or Arc-enabled Server to the above created Hybrid Worker Group.
541
+
1. Connect the Azure VM or Arc-enabled server to the above created Hybrid Worker Group.
542
542
1. Generate a new GUID and pass it as the name of the Hybrid Worker.
543
543
1. Enable System-assigned managed identity on the VM.
544
544
1. Install Hybrid Worker Extension on the VM.
545
-
1. To confirm if the extension has been successfully installed on the VM, In**Azure portal**, go to the VM > **Extensions** tab and check the status of Hybrid Worker extension installed on the VM.
545
+
1. To confirm if the extension has been successfully installed on the VM, in**Azure portal**, go to the VM > **Extensions** tab and check the status of the Hybrid Worker extension installed on the VM.
546
546
547
547
548
548
**Review the template**
@@ -974,15 +974,15 @@ To install and use Hybrid Worker extension using REST API, follow these steps. T
974
974
975
975
#### [Azure CLI](#tab/cli)
976
976
977
-
You can use Azure CLI to create a new Hybrid Worker group, create a new Azure VM, add it to an existing Hybrid Worker Group and install the Hybrid Worker extension. Learn more about [Azure CLI](https://learn.microsoft.com/cli/azure/what-is-azure-cli)
977
+
You can use Azure CLI to create a new Hybrid Worker group, create a new Azure VM, add it to an existing Hybrid Worker Group and install the Hybrid Worker extension. Learn more about [Azure CLI](https://learn.microsoft.com/cli/azure/what-is-azure-cli).
978
978
979
979
Follow the steps mentioned below as an example:
980
980
981
-
1. Create a Hybrid Worker Group
981
+
1. Create a Hybrid Worker Group.
982
982
```azurecli-interactive
983
983
az automation hrwg create --automation-account-name accountName --resource-group groupName --name hybridrunbookworkergroupName
984
984
```
985
-
1. Create an Azure VM or Arc-enabled server and add it to the above created Hybrid Worker Group. Use the below command to add an existing Azure VM or Arc-enabled Server to the Hybrid Worker Group. Generate a new GUID and pass it as `hybridRunbookWorkerGroupName. vmResourceId`. To fetch it, go to the **Properties** tab of the VM on Azure portal.
985
+
1. Create an Azure VM or Arc-enabled server and add it to the above created Hybrid Worker Group. Use the below command to add an existing Azure VM or Arc-enabled Server to the Hybrid Worker Group. Generate a new GUID and pass it as `hybridRunbookWorkerGroupName`. To fetch `vmResourceId`, go to the **Properties** tab of the VM on Azure portal.
@@ -994,7 +994,7 @@ Follow the steps mentioned below as an example:
994
994
az vm extension set --name HybridWorkerExtension --publisher Microsoft.Azure.Automation.HybridWorker --version 1.1 --vm-name <vmname> -g <resourceGroupName> \
1. To confirm if the extension has been successfully installed on the VM, In**Azure portal**, go to the VM > **Extensions** tab and check the status of Hybrid Worker extension installed on the VM.
997
+
1. To confirm if the extension has been successfully installed on the VM, in**Azure portal**, go to the VM > **Extensions** tab and check the status of the Hybrid Worker extension installed on the VM.
998
998
999
999
**Manage Hybrid Worker Extension**
1000
1000
@@ -1010,12 +1010,12 @@ You can use PowerShell cmdlets to create a new Hybrid Worker group, create a new
1. Create an Azure VM or Arc-enabled server and add it to the above created Hybrid Worker Group. Use the below command to add an existing Azure VM or Arc-enabled Server to the Hybrid Worker Group. Generate a new GUID and pass it as `RunbookWorkerName. VmResourceId`. To fetch it, go to the **Properties** tab of the VM on Azure portal.
1018
+
1. Create an Azure VM or Arc-enabled server and add it to the above created Hybrid Worker Group. Use the below command to add an existing Azure VM or Arc-enabled Server to the Hybrid Worker Group. Generate a new GUID and pass it as `hybridRunbookWorkerGroupName`. To fetch `vmResourceId`, go to the **Properties** tab of the VM on Azure portal.
Copy file name to clipboardExpand all lines: articles/automation/migrate-existing-agent-based-hybrid-worker-to-extension-based-workers.md
+66-1Lines changed: 66 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@ title: Migrate an existing agent-based hybrid workers to extension-based-workers
3
3
description: This article provides information on how to migrate an existing agent-based hybrid worker to extension based workers.
4
4
services: automation
5
5
ms.subservice: process-automation
6
-
ms.date: 04/05/2023
6
+
ms.date: 04/11/2023
7
7
ms.custom: devx-track-azurecli, devx-track-bicep
8
8
ms.topic: how-to
9
9
#Customer intent: As a developer, I want to learn about extension so that I can efficiently migrate agent based hybrid workers to extension based workers.
@@ -116,6 +116,16 @@ For at-scale migration of multiple Agent based Hybrid Workers, you can also use
116
116
117
117
You can use the Bicep template to create a new Hybrid Worker group, create a new Azure Windows VM and add it to an existing Hybrid Worker Group. Learn more about [Bicep](../azure-resource-manager/bicep/overview.md).
118
118
119
+
Follow the steps mentioned below as an example:
120
+
121
+
1. Create a Hybrid Worker Group.
122
+
1. Create either an Azure VM or Arc-enabled server. Alternatively, you can also use an existing Azure VM or Arc-enabled server.
123
+
1. Connect the Azure VM or Arc-enabled server to the above created Hybrid Worker Group.
124
+
1. Generate a new GUID and pass it as the name of the Hybrid Worker.
125
+
1. Enable System-assigned managed identity on the VM.
126
+
1. Install Hybrid Worker Extension on the VM.
127
+
1. To confirm if the extension has been successfully installed on the VM, in **Azure portal**, go to the VM > **Extensions** tab and check the status of the Hybrid Worker extension installed on the VM.
You can use an Azure Resource Manager (ARM) template to create a new Azure Windows VM and connect it to an existing Automation account and Hybrid Worker Group. To learn more about ARM templates, see [What are ARM templates?](../azure-resource-manager/templates/overview.md)
345
355
356
+
Follow the steps mentioned below as an example:
357
+
358
+
1. Create a Hybrid Worker Group.
359
+
1. Create either an Azure VM or Arc-enabled server. Alternatively, you can also use an existing Azure VM or Arc-enabled server.
360
+
1. Connect the Azure VM or Arc-enabled server to the above created Hybrid Worker Group.
361
+
1. Generate a new GUID and pass it as the name of the Hybrid Worker.
362
+
1. Enable System-assigned managed identity on the VM.
363
+
1. Install Hybrid Worker Extension on the VM.
364
+
1. To confirm if the extension has been successfully installed on the VM, in **Azure portal**, go to the VM > **Extensions** tab and check the status of the Hybrid Worker extension installed on the VM.
365
+
346
366
**Review the template**
347
367
348
368
```json
@@ -772,6 +792,28 @@ To install and use Hybrid Worker extension using REST API, follow these steps. T
772
792
773
793
#### [Azure CLI](#tab/cli)
774
794
795
+
You can use Azure CLI to create a new Hybrid Worker group, create a new Azure VM, add it to an existing Hybrid Worker Group and install the Hybrid Worker extension. Learn more about [Azure CLI](https://learn.microsoft.com/cli/azure/what-is-azure-cli).
796
+
797
+
Follow the steps mentioned below as an example:
798
+
799
+
1. Create a Hybrid Worker Group.
800
+
```azurecli-interactive
801
+
az automation hrwg create --automation-account-name accountName --resource-group groupName --name hybridrunbookworkergroupName
802
+
```
803
+
1. Create an Azure VM or Arc-enabled server and add it to the above created Hybrid Worker Group. Use the below command to add an existing Azure VM or Arc-enabled Server to the Hybrid Worker Group. Generate a new GUID and pass it as `hybridRunbookWorkerGroupName`. To fetch `vmResourceId`, go to the **Properties** tab of the VM on Azure portal.
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.
809
+
1. Install Hybrid Worker Extension on the VM
810
+
811
+
```azurecli-interactive
812
+
az vm extension set --name HybridWorkerExtension --publisher Microsoft.Azure.Automation.HybridWorker --version 1.1 --vm-name <vmname> -g <resourceGroupName> \
1. To confirm if the extension has been successfully installed on the VM, in **Azure portal**, go to the VM > **Extensions** tab and check the status of the Hybrid Worker extension installed on the VM.
816
+
775
817
**Manage Hybrid Worker Extension**
776
818
777
819
- To create, delete, and manage extension-based Hybrid Runbook Worker groups, see [az automation hrwg | Microsoft Docs](/cli/azure/automation/hrwg?view=azure-cli-latest)
@@ -782,6 +824,29 @@ After creating new Hybrid Runbook Worker, you must install the extension on the
782
824
783
825
#### [PowerShell](#tab/ps)
784
826
827
+
You can use PowerShell cmdlets to create a new Hybrid Worker group, create a new Azure VM, add it to an existing Hybrid Worker Group and install the Hybrid Worker extension.
1. Create an Azure VM or Arc-enabled server and add it to the above created Hybrid Worker Group. Use the below command to add an existing Azure VM or Arc-enabled Server to the Hybrid Worker Group. Generate a new GUID and pass it as `hybridRunbookWorkerGroupName`. To fetch `vmResourceId`, go to the **Properties** tab of the VM on Azure portal.
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.
842
+
1. Install Hybrid Worker Extension on the VM.
843
+
844
+
:::image type="content" source="./media/extension-based-hybrid-runbook-worker-install/hybrid-worker-extension-settings-powershell-inline.png" alt-text="Screenshot of Hybrid Worker Extension settings in PowerShell." lightbox="./media/extension-based-hybrid-runbook-worker-install/hybrid-worker-extension-settings-powershell-expanded.png":::
845
+
846
+
1. To confirm if the extension has been successfully installed on the VM, In **Azure portal**, go to the VM > **Extensions** tab and check the status of Hybrid Worker extension installed on the VM.
847
+
848
+
**Manage Hybrid Worker Extension**
849
+
785
850
You can use the following PowerShell cmdlets to manage Hybrid Runbook Worker and Hybrid Runbook Worker groups:
0 commit comments