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/manage-runtime-environment.md
+14-4Lines changed: 14 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@ title: Manage Runtime environment and associated runbooks in Azure Automation
3
3
description: This article tells how to manage runbooks in Runtime environment and associated runbooks Azure Automation
4
4
services: automation
5
5
ms.subservice: process-automation
6
-
ms.date: 12/29/2023
6
+
ms.date: 01/16/2024
7
7
ms.topic: conceptual
8
8
ms.custom: references_regions
9
9
---
@@ -63,7 +63,7 @@ An Azure Automation account in supported public region (except Central India, Ge
63
63
64
64
:::image type="content" source="./media/manage-runtime-environment/create-runtime-environment.png" alt-text="Screenshot shows the entries in basics tab of create runtime environment.":::
65
65
66
-
1. Select **Next** and in the **Packages** tab, upload the packages required during the runbook execution. The *Az PowerShell package* is uploaded by default for all PowerShell Runtime environments, which includes all cmdlets for managing Azure resources. You can choose the version of Az package from the dropdown.
66
+
1. Select **Next** and in the **Packages** tab, upload the packages required during the runbook execution. The *Az PowerShell package* is uploaded by default for all PowerShell Runtime environments, which includes all cmdlets for managing Azure resources. You can choose the version of Az package from the dropdown. Select **None** if you don't want the Package to be uploaded during runbook execution.
67
67
68
68
:::image type="content" source="./media/manage-runtime-environment/packages-runtime-environment.png" alt-text="Screenshot shows the selections in packages tab of create runtime environment.":::
You can update runbook by changing the Runtime environment linked to the runbook. You can choose single or multiple runbooks for update.
277
+
You can update runbook by changing the Runtime environment linked to the runbook. You can choose single or multiple runbooks for update. Runbook in running status would not be impacted by changing the Runtime environment linked to that runbook.
269
278
270
279
#### [Azure portal](#tab/update-runbook-portal)
271
280
1. In your Automation account, under **Process Automation**, select **Runbooks**.
@@ -317,9 +326,10 @@ To test runbook execution before publishing Runtime environment changes, follow
317
326
:::image type="content" source="./media/manage-runtime-environment/access-runbook.png" alt-text="Screenshot shows how to go to Runbooks page to select runbook." lightbox="./media/manage-runtime-environment/access-runbook.png":::
318
327
319
328
1. In the **Edit runbook** page, select **Edit in Portal** to open the text editor.
320
-
1. The Runtime environment field shows the existing configuration. Select the new Runtime environment from the dropdown list.
329
+
1. The Runtime environment field shows the existing configuration. Select the new Runtime environment from the dropdown list.
321
330
322
331
:::image type="content" source="./media/manage-runtime-environment/edit-runbook.png" alt-text="Screenshot shows how to select new Runtime environment." lightbox="./media/manage-runtime-environment/edit-runbook.png":::
332
+
323
333
1. Select **Test pane** to test runbook execution with the updated Runtime environment. Select **Start** to begin the test run.
324
334
1. Close the test pane and make the required changes in Runbook code or Runtime environment if necessary.
325
335
1. Select **Publish** to update the Runtime environment linked to the runbook.
Copy file name to clipboardExpand all lines: articles/automation/quickstart-cli-support-powershell-runbook-runtime-environment.md
+5-2Lines changed: 5 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@ title: Add support for Azure CLI in PowerShell 7.2 runbooks in Runtime environme
3
3
titleSuffix: Azure Automation
4
4
description: This article shows how to add support for Azure CLI in PowerShell 7.2 runbooks in Runtime environment.
5
5
services: automation
6
-
ms.date: 01/03/2024
6
+
ms.date: 01/16/2024
7
7
ms.topic: conceptual
8
8
ms.custom: references_regions
9
9
---
@@ -35,8 +35,11 @@ You can run Azure CLI commands in runbooks linked with PowerShell 7.2 Runtime en
35
35
1. On **Packages** tab, in the **Package version** dropdown list, you would see **Az version 8.3** and **Azure CLI version 2.52.0** already present.
36
36
1. Select **+Add from gallery** to add more packages from gallery and select **Next**.
37
37
1. On **Review + create** tab, review the entries and select **Create**.
38
-
38
+
39
39
A notification appears to confirm that a Runtime environment is successfully created.
40
+
41
+
:::image type="content" source="./media/quickstart-cli-support-powershell-runbook-runtime-environment/create-runtime-environment.png" alt-text="Screenshot shows how to create a runtime environment." lightbox="./media/quickstart-cli-support-powershell-runbook-runtime-environment/create-runtime-environment.png":::
description: This article shows how to update a runbook from PowerShell 5.1 to PowerShell 7.2 in Runtime environment.
5
5
services: automation
6
-
ms.date: 01/02/2024
6
+
ms.date: 01/16/2024
7
7
ms.topic: conceptual
8
8
ms.custom: references_regions
9
9
---
10
10
11
11
# Update runbook from PowerShell 5.1 to PowerShell 7.2
12
12
13
-
Using the Runtime environment, you can upgrade a runbook from one Runtime version to the other by creating a different Runtime environment and then linking the runbook to it.
13
+
Using the Runtime environment, you can upgrade a runbook from one Runtime version to the other by creating a different Runtime environment and then linking the runbook to it. You can follow similar steps for updating Python runbooks.
14
14
15
15
> [!NOTE]
16
-
> A runbook can be mapped to a single Runtime environment, while a specific Runtime environment can be mapped to multiple runbooks.
16
+
> [PowerShell 7.1](https://learn.microsoft.com/powershell/scripting/install/powershell-support-lifecycle?view=powershell-7.3#powershell-end-of-support-dates) and [Python 2.7](https://devguide.python.org/versions/) are no longer supported by their respective parent products PowerShell and Python. We recommend that you update outdated runbooks to latest supported versions using Runtime environment.
Copy file name to clipboardExpand all lines: articles/automation/runtime-environment-overview.md
+10-3Lines changed: 10 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@ title: Runtime environment in Azure Automation
3
3
description: This article provides an overview on Runtime environment in Azure Automation.
4
4
services: automation
5
5
ms.subservice: process-automation
6
-
ms.date: 01/03/2024
6
+
ms.date: 01/16/2024
7
7
ms.topic: conceptual
8
8
ms.custom: references_regions
9
9
---
@@ -41,6 +41,12 @@ Runtime environment captures the following details about the job execution envir
41
41
> [!NOTE]
42
42
> Azure CLI commands are supported (public preview) in runbooks associated with PowerShell 7.2 Runtime environment. Azure CLI commands version 2.52.0 is available as a default package in PowerShell 7.2 Runtime environment.
43
43
44
+
## Azure CLI package in Runtime environment
45
+
46
+
Azure CLI commands are supported (public preview) in runbooks associated with PowerShell 7.2 Runtime environment. **Azure CLI version 2.56.0** is available as a default package in PowerShell 7.2 Runtime environment. Azure Automation closely follows the release cadence of newer versions of Azure CLI and supports them in runbooks.
47
+
48
+
Runbooks linked to PowerShell 7.2 Runtime environment would always execute with the latest Azure CLI version supported by Azure Automation. Likewise, versions declared end-of-support by parent product Azure CLI would no longer be supported by Azure Automation as these could potentially suffer from bugs or security vulnerabilities. Ensure your runbooks are designed to execute seamlessly in newer versions of Azure CLI.
49
+
44
50
## System-generated Runtime environments
45
51
46
52
Azure Automation creates system-generated Runtime environments based on the Runtime language, version, and packages/modules present in your Azure Automation account. There are six system-generated Runtime environments:
@@ -52,12 +58,13 @@ Azure Automation creates system-generated Runtime environments based on the Runt
52
58
- Python-3.8
53
59
- Python-3.10
54
60
61
+
:::image type="content" source="./media/runtime-environment-overview/system-generated.png" alt-text="Screenshot shows the system generated Runtime environment." lightbox="./media/runtime-environment-overview/system-generated.png":::
62
+
55
63
You can't edit these Runtime environments. However, any changes that are made in Modules/Packages for the Automation account are automatically reflected in these system-generated Runtime environments.
56
64
57
65
> [!NOTE]
58
66
> Packages present in System-generated Runtime environments are unique to your Azure Automation account and might vary across different accounts.
59
67
60
-
61
68
## Key Benefits
62
69
63
70
-**Granular control** - enables you to configure the script execution environment by choosing the Runtime language, its version, and dependent modules.
@@ -74,7 +81,7 @@ You can't edit these Runtime environments. However, any changes that are made in
74
81
- RBAC permissions cannot be assigned to Runtime environment.
75
82
- Runtime environment can't be configured through Azure Automation extension for Visual Studio Code.
76
83
- Deleted Runtime environments cannot be recovered.
77
-
- The feature is only supported through Azure portal and REST API.
84
+
- The feature is only supported through Azure portal and [REST API](https://review.learn.microsoft.com/rest/api/automation/operation-groups?view=rest-automation-2023-05-15-preview&branch=automation202305).
0 commit comments