Skip to content

Commit e4ae9e4

Browse files
committed
updated the details for Migrate article
1 parent 2d66d6f commit e4ae9e4

File tree

2 files changed

+76
-11
lines changed

2 files changed

+76
-11
lines changed

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

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -301,11 +301,11 @@ Follow the steps mentioned below as an example:
301301

302302
1. Create a Hybrid Worker Group.
303303
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.
305305
1. Generate a new GUID and pass it as the name of the Hybrid Worker.
306306
1. Enable System-assigned managed identity on the VM.
307307
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.
309309

310310
```Bicep
311311
param automationAccount string
@@ -538,11 +538,11 @@ Follow the steps mentioned below as an example:
538538

539539
1. Create a Hybrid Worker Group.
540540
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.
542542
1. Generate a new GUID and pass it as the name of the Hybrid Worker.
543543
1. Enable System-assigned managed identity on the VM.
544544
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.
546546

547547

548548
**Review the template**
@@ -974,15 +974,15 @@ To install and use Hybrid Worker extension using REST API, follow these steps. T
974974
975975
#### [Azure CLI](#tab/cli)
976976
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).
978978
979979
Follow the steps mentioned below as an example:
980980
981-
1. Create a Hybrid Worker Group
981+
1. Create a Hybrid Worker Group.
982982
```azurecli-interactive
983983
az automation hrwg create --automation-account-name accountName --resource-group groupName --name hybridrunbookworkergroupName
984984
```
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.
986986

987987
```azurecli-interactive
988988
az automation hrwg hrw create --automation-account-name accountName --resource-group groupName --hybrid-runbook-worker-group-name hybridRunbookWorkerGroupName --hybrid-runbook-worker-id
@@ -994,7 +994,7 @@ Follow the steps mentioned below as an example:
994994
az vm extension set --name HybridWorkerExtension --publisher Microsoft.Azure.Automation.HybridWorker --version 1.1 --vm-name <vmname> -g <resourceGroupName> \
995995
--settings '{"AutomationAccountURL" = "<registration-url>";}' --enable-auto-upgrade true
996996
```
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 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.
998998

999999
**Manage Hybrid Worker Extension**
10001000

@@ -1010,12 +1010,12 @@ You can use PowerShell cmdlets to create a new Hybrid Worker group, create a new
10101010

10111011
Follow the steps mentioned below as an example:
10121012

1013-
1. Create a Hybrid Worker Group
1013+
1. Create a Hybrid Worker Group.
10141014

10151015
```powershell-interactive
10161016
New-AzAutomationHybridRunbookWorkerGroup -AutomationAccountName "Contoso17" -Name "RunbookWorkerGroupName" -ResourceGroupName "ResourceGroup01"
10171017
```
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 `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.
10191019

10201020
```azurepowershell
10211021
New-AzAutomationHybridRunbookWorker -AutomationAccountName "Contoso17" -Name "RunbookWorkerName" -HybridRunbookWorkerGroupName "RunbookWorkerGroupName" -VmResourceId "VmResourceId" -ResourceGroupName "ResourceGroup01"

articles/automation/migrate-existing-agent-based-hybrid-worker-to-extension-based-workers.md

Lines changed: 66 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Migrate an existing agent-based hybrid workers to extension-based-workers
33
description: This article provides information on how to migrate an existing agent-based hybrid worker to extension based workers.
44
services: automation
55
ms.subservice: process-automation
6-
ms.date: 04/05/2023
6+
ms.date: 04/11/2023
77
ms.custom: devx-track-azurecli, devx-track-bicep
88
ms.topic: how-to
99
#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
116116

117117
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).
118118

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.
128+
119129
```Bicep
120130
param automationAccount string
121131
param automationAccountLocation string
@@ -343,6 +353,16 @@ output output1 string = automationAccount_resource.properties.automationHybridSe
343353

344354
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)
345355

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+
346366
**Review the template**
347367

348368
```json
@@ -772,6 +792,28 @@ To install and use Hybrid Worker extension using REST API, follow these steps. T
772792
773793
#### [Azure CLI](#tab/cli)
774794
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.
804+
805+
```azurecli-interactive
806+
az automation hrwg hrw create --automation-account-name accountName --resource-group groupName --hybrid-runbook-worker-group-name hybridRunbookWorkerGroupName --hybrid-runbook-worker-id
807+
```
808+
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> \
813+
--settings '{"AutomationAccountURL" = "<registration-url>";}' --enable-auto-upgrade true
814+
```
815+
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+
775817
**Manage Hybrid Worker Extension**
776818

777819
- 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
782824

783825
#### [PowerShell](#tab/ps)
784826

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.
828+
829+
Follow the steps mentioned below as an example:
830+
831+
1. Create a Hybrid Worker Group.
832+
833+
```powershell-interactive
834+
New-AzAutomationHybridRunbookWorkerGroup -AutomationAccountName "Contoso17" -Name "RunbookWorkerGroupName" -ResourceGroupName "ResourceGroup01"
835+
```
836+
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.
837+
838+
```azurepowershell
839+
New-AzAutomationHybridRunbookWorker -AutomationAccountName "Contoso17" -Name "RunbookWorkerName" -HybridRunbookWorkerGroupName "RunbookWorkerGroupName" -VmResourceId "VmResourceId" -ResourceGroupName "ResourceGroup01"
840+
```
841+
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+
785850
You can use the following PowerShell cmdlets to manage Hybrid Runbook Worker and Hybrid Runbook Worker groups:
786851
787852
| PowerShell cmdlet | Description |

0 commit comments

Comments
 (0)