Skip to content

Commit 61621be

Browse files
authored
Merge pull request #113264 from Ja-Dunn/automation-articles-jd-batch2
edit pass: automation-articles-jd-batch2
2 parents 6c008cc + 7a06675 commit 61621be

File tree

3 files changed

+83
-83
lines changed

3 files changed

+83
-83
lines changed

articles/automation/how-to/move-account.md

Lines changed: 44 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -14,16 +14,16 @@ manager: carmonm
1414

1515
Azure Automation allows you to move some resources to a new resource group or subscription. You can move resources through the Azure portal, PowerShell, the Azure CLI, or the REST API. To learn more about the process, see [Move resources to a new resource group or subscription](../../azure-resource-manager/management/move-resource-group-and-subscription.md).
1616

17-
The Azure Automation account is one of the resources that you can move. In this article, you'll learn to move Automation accounts to another resource or subscription. The high-level steps for moving your Automation account are:
17+
The Automation account is one of the resources that you can move. In this article, you'll learn to move Automation accounts to another resource or subscription. The high-level steps for moving your Automation account are:
1818

1919
1. Remove your solutions.
2020
2. Unlink your workspace.
2121
3. Move the Automation account.
22-
4. Delete and recreate the Run As accounts.
22+
4. Delete and re-create the Run As accounts.
2323
5. Re-enable your solutions.
2424

2525
>[!NOTE]
26-
>This article has been updated to use the new Azure PowerShell Az module. You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. To learn more about the new Az module and AzureRM compatibility, see [Introducing the new Azure PowerShell Az module](https://docs.microsoft.com/powershell/azure/new-azureps-module-az?view=azps-3.5.0). For Az module installation instructions on your Hybrid Runbook Worker, see [Install the Azure PowerShell Module](https://docs.microsoft.com/powershell/azure/install-az-ps?view=azps-3.5.0). For your Automation account, you can update your modules to the latest version using [How to update Azure PowerShell modules in Azure Automation](../automation-update-azure-modules.md).
26+
>In this article, you work with the Azure PowerShell Az module. You can still use the AzureRM module. To learn more about Az module and AzureRM compatibility, see [Introducing the new Azure PowerShell Az module](https://docs.microsoft.com/powershell/azure/new-azureps-module-az?view=azps-3.5.0). For Az module installation instructions on your Hybrid Runbook Worker, see [Install the Azure PowerShell module](https://docs.microsoft.com/powershell/azure/install-az-ps?view=azps-3.5.0). For your Automation account, you can update your modules to the latest version by using [How to update Azure PowerShell modules in Azure Automation](../automation-update-azure-modules.md).
2727
2828
## Remove solutions
2929

@@ -34,54 +34,54 @@ To unlink your workspace from your Automation account, you must remove these sol
3434
- Start/Stop VMs during off hours
3535

3636
1. In the Azure portal, locate your resource group.
37-
2. Find each solution and click **Delete** on the Delete Resources page.
37+
2. Find each solution, and select **Delete** on the **Delete Resources** page.
3838

39-
![Delete solutions from the Azure portal](../media/move-account/delete-solutions.png)
39+
![Screenshot of deleting solutions from the Azure portal](../media/move-account/delete-solutions.png)
4040

41-
If you prefer, you can delete the solutions using the [Remove-AzResource](https://docs.microsoft.com/powershell/module/Az.Resources/Remove-AzResource?view=azps-3.7.0) cmdlet:
41+
If you prefer, you can delete the solutions by using the [Remove-AzResource](https://docs.microsoft.com/powershell/module/Az.Resources/Remove-AzResource?view=azps-3.7.0) cmdlet:
4242

43-
```azurepowershell-interactive
44-
$workspaceName = <myWorkspaceName>
45-
$resourceGroupName = <myResourceGroup>
46-
Remove-AzResource -ResourceType 'Microsoft.OperationsManagement/solutions' -ResourceName "ChangeTracking($workspaceName)" -ResourceGroupName $resourceGroupName
47-
Remove-AzResource -ResourceType 'Microsoft.OperationsManagement/solutions' -ResourceName "Updates($workspaceName)" -ResourceGroupName $resourceGroupName
48-
Remove-AzResource -ResourceType 'Microsoft.OperationsManagement/solutions' -ResourceName "Start-Stop-VM($workspaceName)" -ResourceGroupName $resourceGroupName
49-
```
43+
```azurepowershell-interactive
44+
$workspaceName = <myWorkspaceName>
45+
$resourceGroupName = <myResourceGroup>
46+
Remove-AzResource -ResourceType 'Microsoft.OperationsManagement/solutions' -ResourceName "ChangeTracking($workspaceName)" -ResourceGroupName $resourceGroupName
47+
Remove-AzResource -ResourceType 'Microsoft.OperationsManagement/solutions' -ResourceName "Updates($workspaceName)" -ResourceGroupName $resourceGroupName
48+
Remove-AzResource -ResourceType 'Microsoft.OperationsManagement/solutions' -ResourceName "Start-Stop-VM($workspaceName)" -ResourceGroupName $resourceGroupName
49+
```
5050

51-
### Remove alert rules for the Start/Stop VMs during off hours solution
51+
### Remove alert rules for the "Start/Stop VMs during off hours" solution
5252

53-
For the Start/Stop VMs during off hours solution, you also need to remove the alert rules created by the solution.
53+
For this solution, you also need to remove the alert rules created by the solution.
5454

5555
1. In the Azure portal, go to your resource group and select **Monitoring** > **Alerts** > **Manage alert rules**.
5656

57-
![Alerts page showing selection of Manage Alert rules](../media/move-account/alert-rules.png)
57+
![Screenshot of Alerts page, showing selection of Manage alert rules](../media/move-account/alert-rules.png)
5858

59-
2. On the Rules page, you should see a list of the alerts configured in that resource group. The solution creates these rules:
59+
2. On the **Rules** page, you should see a list of the alerts configured in that resource group. The solution creates these rules:
6060

6161
* AutoStop_VM_Child
6262
* ScheduledStartStop_Parent
6363
* SequencedStartStop_Parent
6464

65-
3. Select the rules one at a time and click **Delete** to remove them.
65+
3. Select the rules one at a time, and select **Delete** to remove them.
6666

67-
![Rules page requesting confirmation of deletion for selected rules](../media/move-account/delete-rules.png)
67+
![Screenshot of the Rules page, requesting confirmation of deletion for selected rules](../media/move-account/delete-rules.png)
6868

6969
> [!NOTE]
70-
> If you don't see any alert rules on the Rules page, change the **Status** field to Disabled to show disabled alerts, because you might have disabled them.
70+
> If you don't see any alert rules on the **Rules** page, change the **Status** field to **Disabled** to show disabled alerts. You might have disabled them.
7171
72-
4. When the alert rules are removed, you must remove the action group created for Start/Stop VMs during off hours solution notifications. In the Azure portal, select **Monitor** > **Alerts** > **Manage action groups**.
72+
4. When you remove the alert rules, you must remove the action group created for the "Start/Stop VMs during off hours" solution notifications. In the Azure portal, select **Monitor** > **Alerts** > **Manage action groups**.
7373

7474
5. Select **StartStop_VM_Notification**.
7575

7676
6. On the action group page, select **Delete**.
7777

78-
![Action group page](../media/move-account/delete-action-group.png)
78+
![Screenshot of the Action group page](../media/move-account/delete-action-group.png)
7979

80-
If you prefer, you can delete your action group using the [Remove-AzActionGroup](https://docs.microsoft.com/powershell/module/az.monitor/remove-azactiongroup?view=azps-3.7.0) cmdlet:
80+
If you prefer, you can delete your action group by using the [Remove-AzActionGroup](https://docs.microsoft.com/powershell/module/az.monitor/remove-azactiongroup?view=azps-3.7.0) cmdlet:
8181

82-
```azurepowershell-interactive
83-
Remove-AzActionGroup -ResourceGroupName <myResourceGroup> -Name StartStop_VM_Notification
84-
```
82+
```azurepowershell-interactive
83+
Remove-AzActionGroup -ResourceGroupName <myResourceGroup> -Name StartStop_VM_Notification
84+
```
8585

8686
## Unlink your workspace
8787

@@ -91,52 +91,52 @@ Now you can unlink your workspace:
9191

9292
2. Select **Unlink workspace** to unlink the workspace from your Automation account.
9393

94-
![Unlink a workspace from an Automation account](../media/move-account/unlink-workspace.png)
94+
![Screenshot of unlinking a workspace from an Automation account](../media/move-account/unlink-workspace.png)
9595

9696
## Move your Automation account
9797

9898
You can now move your Automation account and its runbooks.
9999

100100
1. In the Azure portal, browse to the resource group of your Automation account. Select **Move** > **Move to another subscription**.
101101

102-
![Resource group page, move to another subscription](../media/move-account/move-resources.png)
102+
![Screenshot of Resource group page, move to another subscription](../media/move-account/move-resources.png)
103103

104104
2. Select the resources in your resource group that you want to move. Ensure that you include your Automation account, runbooks, and Log Analytics workspace resources.
105105

106-
## Recreate Run As accounts
106+
## Re-create Run As accounts
107107

108-
[Run As accounts](../manage-runas-account.md) create a service principal in Azure Active Directory to authenticate with Azure resources. When you change subscriptions, the Automation account no longer uses the existing Run As account. To recreate the Run As accounts:
108+
[Run As accounts](../manage-runas-account.md) create a service principal in Azure Active Directory to authenticate with Azure resources. When you change subscriptions, the Automation account no longer uses the existing Run As account. To re-create the Run As accounts:
109109

110-
1. Go to your Automation account in the new subscription and select **Run as accounts** under **Account Settings**. You'll see that the Run As accounts show as incomplete now.
110+
1. Go to your Automation account in the new subscription, and select **Run as accounts** under **Account Settings**. You'll see that the Run As accounts show as incomplete now.
111111

112-
![Run As accounts are incomplete](../media/move-account/run-as-accounts.png)
112+
![Screenshot of Run As accounts, showing incomplete](../media/move-account/run-as-accounts.png)
113113

114-
2. Delete the Run As accounts one at a time using the **Delete** button on the Properties page.
114+
2. Delete the Run As accounts, one at a time, by selecting **Delete** on the **Properties** page.
115115

116116
> [!NOTE]
117-
> If you don't have permissions to create or view the Run As accounts, you see the following message: `You do not have permissions to create an Azure Run As account (service principal) and grant the Contributor role to the service principal.` To learn about the permissions required to configure a Run As account, see [Permissions required to configure Run As accounts](../manage-runas-account.md#permissions).
117+
> If you don't have permissions to create or view the Run As accounts, you see the following message: `You do not have permissions to create an Azure Run As account (service principal) and grant the Contributor role to the service principal.` For more information, see [Permissions required to configure Run As accounts](../manage-runas-account.md#permissions).
118118
119119
3. After you've deleted the Run As accounts, select **Create** under **Azure Run As account**.
120120

121-
4. On the Add Azure Run As account page, select **Create** to create the Run As account and service principal.
121+
4. On the **Add Azure Run As account** page, select **Create** to create the Run As account and service principal.
122122

123123
5. Repeat the steps above with the Azure Classic Run As account.
124124

125125
## Enable solutions
126126

127-
After you recreate the Run As accounts, you must re-enable the solutions that you removed before the move:
127+
After you re-create the Run As accounts, you must re-enable the solutions that you removed before the move:
128128

129-
1. To turn on the Change Tracking and Inventory solution, select Change Tracking and Inventory in your Automation account. Choose the Log Analytics workspace that you moved over and select **Enable**.
129+
1. To turn on the "Change Tracking and Inventory" solution, select **Change Tracking and Inventory** in your Automation account. Choose the Log Analytics workspace that you moved over, and select **Enable**.
130130

131-
2. Repeat step 1 for the Update Management solution.
131+
2. Repeat step 1 for the "Update Management" solution.
132132

133-
![Re-enable solutions in your moved Automation account](../media/move-account/reenable-solutions.png)
133+
![Screenshot of re-enabling solutions in your moved Automation account](../media/move-account/reenable-solutions.png)
134134

135-
3. Machines that are onboarded with your solutions are visible when you've connected the existing Log Analytics workspace. To turn on the Start/Stop VMs during off hours solution, you must redeploy the solution. Under **Related Resources**, select **Start/Stop VMs** > **Learn more about and enable the solution** > **Create** to start the deployment.
135+
3. Machines that are onboarded with your solutions are visible when you've connected the existing Log Analytics workspace. To turn on the "Start/Stop VMs during off hours" solution, you must redeploy the solution. Under **Related Resources**, select **Start/Stop VMs** > **Learn more about and enable the solution** > **Create** to start the deployment.
136136

137-
4. On the Add Solution page, choose your Log Analytics workspace and Automation account.
137+
4. On the **Add Solution** page, choose your Log Analytics workspace and Automation account.
138138

139-
![Add Solution menu](../media/move-account/add-solution-vm.png)
139+
![Screenshot of Add Solution menu](../media/move-account/add-solution-vm.png)
140140

141141
5. Configure the solution as described in [Start/Stop VMs during off hours solution in Azure Automation](../automation-solution-vm-management.md).
142142

@@ -150,8 +150,8 @@ When the move is complete, verify that the capabilities listed below are enabled
150150
|Source control|You can run a manual sync on your source control repository.|[Source control integration](../source-control-integration.md)|
151151
|Change tracking and inventory|Verify that you see current inventory data from your machines.|[Troubleshoot change tracking](../troubleshoot/change-tracking.md)|
152152
|Update management|Verify that you see your machines and that they're healthy.</br>Run a test software update deployment.|[Troubleshoot update management](../troubleshoot/update-management.md)|
153-
|Shared resources|Verify that you see all your shared resources, such as [credentials](../shared-resources/credentials.md), [variables](../shared-resources/variables.md), and the like.|
153+
|Shared resources|Verify that you see all your shared resources, such as [credentials](../shared-resources/credentials.md) and [variables](../shared-resources/variables.md).|
154154

155155
## Next steps
156156

157-
To learn more about moving resources in Azure, see [Move resources in Azure](../../azure-resource-manager/management/move-support-resources.md).
157+
To learn about moving resources in Azure generally, see [Move resources in Azure](../../azure-resource-manager/management/move-support-resources.md).

0 commit comments

Comments
 (0)