Skip to content

Commit 4605d25

Browse files
Minor fixes
1 parent 92428a2 commit 4605d25

9 files changed

+38
-30
lines changed

articles/automation/automation-runbook-types.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Azure Automation Runbook Types
33
description: This article describes the types of runbooks that you can use in Azure Automation and considerations for determining which type to use.
44
services: automation
55
ms.subservice: process-automation
6-
ms.date: 09/09/2024
6+
ms.date: 06/27/2025
77
ms.topic: overview
88
ms.custom: references_regions, devx-track-python, devx-track-azurepowershell
99
ms.service: azure-automation
@@ -67,29 +67,29 @@ The following are the current limitations and known issues with PowerShell runbo
6767
> [!NOTE]
6868
> Currently, PowerShell 7.4 runtime version is supported for both Cloud and Hybrid jobs in all Public regions except Brazil Southeast and Gov clouds.
6969
70-
- For the PowerShell 7.4 runtime version, the module activities aren't extracted for the imported modules. Use Azure Automation extension for VS Code to simplify runbook authoring experience.
70+
- For the PowerShell 7.4 runtime version, the module activities aren't extracted for the imported modules. Use [Azure Automation extension for VS Code](automation-runbook-authoring.md) to simplify runbook authoring experience.
7171
- PowerShell 7.x doesn't support workflows. For more information, see [PowerShell workflow](/powershell/scripting/whats-new/differences-from-windows-powershell#powershell-workflow) for more details.
7272
- PowerShell 7.x currently doesn't support signed runbooks.
7373
- Source control integration doesn't support PowerShell 7.4. Also, PowerShell 7.4 runbooks in source control get created in Automation account as Runtime 5.1.
7474
- Az module 12.3.0 is installed by default. The complete list of component modules of selected Az module version is shown once Az version is configured again using Azure portal or API.
7575
- The imported PowerShell 7.4 module would be validated during job execution. Ensure that all dependencies for the selected module are also imported for successful job execution.
76-
- Azure runbook doesn't support Start-Job with -credential.
77-
- Azure doesn't support all PowerShell input parameters. Learn more.
76+
- Azure runbook doesn't support `Start-Job` with `-credential`.
77+
- Azure doesn't support all PowerShell input parameters. [Learn more](runbook-input-parameters.md).
7878

7979
**Known issues**
8080

81-
- Runbooks taking dependency on internal file paths such as `C:\modules` might fail due to changes in service backend infrastructure. Change runbook code to ensure there are no dependencies on internal file paths and use `Get-ChildItem` to get the required module information.
82-
- `Get-AzStorageAccount` cmdlet might fail with an error: The `Get-AzStorageAccount` command was found in the module `Az.Storage`, but the module could not be loaded.
83-
- Executing child scripts using `.\child-runbook.ps1` is not supported.
84-
**Workaround**: Use `Start-AutomationRunbook` (internal cmdlet) or `Start-AzAutomationRunbook` (from Az.Automation module) to start another runbook from parent runbook.
81+
- Runbooks taking dependency on internal file paths such as `C:\modules` might fail due to changes in service backend infrastructure. Change runbook code to ensure there are no dependencies on internal file paths and use [Get-ChildItem](/powershell/module/microsoft.powershell.management/get-childitem?view=powershell-7.3&preserve-view=true) to get the required module information.
82+
- `Get-AzStorageAccount` cmdlet might fail with an error: *The `Get-AzStorageAccount` command was found in the module `Az.Storage`, but the module could not be loaded*.
83+
- Executing child scripts using `.\child-runbook.ps1` is not supported.</br>
84+
**Workaround**: Use `Start-AutomationRunbook` (internal cmdlet) or `Start-AzAutomationRunbook` (from *Az.Automation* module) to start another runbook from parent runbook.
8585
- When you use [ExchangeOnlineManagement](/powershell/exchange/exchange-online-powershell?view=exchange-ps&preserve-view=true) module version: 3.0.0 or higher, you can experience errors. To resolve the issue, ensure that you explicitly upload [PowerShellGet](/powershell/module/powershellget/) and [PackageManagement](/powershell/module/packagemanagement/) modules.
8686
- When you utilize the `New-AzAutomationVariable` cmdlet within Az.Automation Module to upload a variable of type **object**, the operation doesn't function as expected.
8787
**Workaround**: Convert the object to a JSON string using the ConvertTo-Json cmdlet and then upload the variable with the JSON string as its value. This workaround ensures proper handling of the variable within the Azure Automation environment as a JSON string.
8888

8989
**Example** - Create a PowerShell object that has stored information around Azure VMs
9090

9191
```
92-
Azure PowerShellCopy
92+
azurepowershell
9393
9494
# Retrieve Azure virtual machines with status information for the 'northeurope' region
9595
$AzVM = Get-AzVM -Status | Where-Object {$_.Location -eq "northeurope"}
@@ -114,7 +114,7 @@ The following are the current limitations and known issues with PowerShell runbo
114114
> [!NOTE]
115115
> PowerShell 7.2 version is no longer supported by parent product PowerShell.
116116
117-
- For the PowerShell 7.2 runtime version, the module activities aren't extracted for the imported modules. Use [Azure Automation extension for VS Code](automation-runbook-authoring.md) to simplify runbook authoring experience.
117+
- For the PowerShell 7.2 runtime version, the module activities aren't extracted for the imported modules.
118118
- PowerShell 7.x doesn't support workflows. For more information, see [PowerShell workflow](/powershell/scripting/whats-new/differences-from-windows-powershell#powershell-workflow) for more details.
119119
- PowerShell 7.x currently doesn't support signed runbooks.
120120
- Source control integration doesn't support PowerShell 7.2. Also, PowerShell 7.2 runbooks in source control get created in Automation account as Runtime 5.1.
@@ -261,7 +261,7 @@ The following are the current limitations and known issues with PowerShell runbo
261261
- Executing child scripts using `.\child-runbook.ps1` isn't supported in this preview.
262262
**Workaround**: Use `Start-AutomationRunbook` (internal cmdlet) or `Start-AzAutomationRunbook` (from `Az.Automation` module) to start another runbook from parent runbook.
263263
- Runbook properties defining logging preference isn't supported in PowerShell 7 runtime.
264-
**Workaround**: Explicitly set the preference at the start of the runbook as following -
264+
**Workaround**: Explicitly set the preference at the start of the runbook as following:
265265
```
266266
$VerbosePreference = "Continue"
267267

articles/automation/learn/powershell-runbook-managed-identity.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: In this tutorial, you learn how to use managed identities with a Po
44
services: automation
55
ms.subservice: process-automation
66
ms.custom: devx-track-azurepowershell
7-
ms.date: 11/24/2021
7+
ms.date: 06/27/2025
88
ms.topic: tutorial
99
#Customer intent: As a developer, I want PowerShell runbooks to execute code using a manged identity.
1010
ms.service: azure-automation
@@ -75,7 +75,7 @@ To assign permissions to managed identities, follow these steps:
7575
-RoleDefinitionName $role1
7676
```
7777
78-
1. The same role assignment is needed for the user-assigned managed identity
78+
1. The same role assignment is needed for the user-assigned managed identity.
7979
8080
```powershell
8181
$UAMI = (Get-AzUserAssignedIdentity -ResourceGroupName $resourceGroup -Name $userAssignedManagedIdentity).PrincipalId
@@ -103,7 +103,7 @@ To create a PowerShell runbook, follow these steps:
103103
104104
1. Sign in to the [Azure portal](https://portal.azure.com/), and navigate to your Automation account.
105105
106-
1. In the **Overview** page, select **Try Runtime Environment experience**, if not already in the new experience .
106+
1. In the **Overview** page, select **Try Runtime Environment experience**, if not already in the new experience.
107107
108108
1. Under **Process Automation**, select **Runbooks**.
109109
@@ -239,7 +239,7 @@ To create a PowerShell runbook, follow these steps:
239239
240240
## Clean up Resources
241241
242-
To remove any resources no longer needed, run the following runbook.
242+
To remove any resources no longer needed, run the following runbook:
243243
244244
```powershell
245245
#Remove runbook

articles/automation/manage-runtime-environment.md

Lines changed: 14 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Manage Runtime Environment and Associated Runbooks in Azure Automation
33
description: This article tells how to manage runbooks in Runtime environment and associated runbooks Azure Automation
44
services: automation
55
ms.subservice: process-automation
6-
ms.date: 07/24/2024
6+
ms.date: 06/27/2025
77
ms.topic: how-to
88
ms.custom: references_regions
99
ms.service: azure-automation
@@ -21,7 +21,7 @@ This article provides information on how to create Runtime Environment and perfo
2121

2222
Before you assign permissions to managed identities, ensure you meet these prerequisites:
2323

24-
- An Azure Automation account is supported in all public regions except Brazil Southeast and Gov clouds.
24+
- An Azure Automation account in all public regions except Brazil Southeast and Gov clouds.
2525

2626

2727
## Switch between Runtime environment and old experience
@@ -136,11 +136,19 @@ GET
136136
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>?api-version=2023-05-15-preview
137137
```
138138

139+
### View Runtime environment
140+
141+
Get the Runtime environment properties from the Automation account.
142+
```rest
143+
GET
144+
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>?api-version=2023-05-15-preview
145+
```
146+
139147
### List Runtime environments
140148

141149
#### [Azure portal](#tab/list-runtime-portal)
142150

143-
To list all the Runtime environments from the Automation account, follow these steps:
151+
To list all the Runtime environments from the Automation account, follow this step:
144152

145153
1. In your Automation account, under **Process Automation**, select **Runtime Environments**.
146154

@@ -205,7 +213,7 @@ To update a Runtime environment, follow these steps:
205213
206214
#### [REST API](#tab/update-runtime-rest)
207215

208-
Update the Az module version of an existing Runtime environment:
216+
Update the Az module version of an existing Runtime environment.
209217

210218
```rest
211219
PATCH
@@ -240,7 +248,7 @@ To create a new runbook linked to the Runtime environment, follow these steps:
240248

241249
1. In your Automation account, under **Process Automation**, select **Runbooks**.
242250
1. Select **Create**.
243-
1. In the **Basics** tab, you can either create a new runbook or upload a file from your local computer or from PowerShell gallery.
251+
1. On the **Basics** tab, you can either create a new runbook or upload a file from your local computer or from PowerShell gallery.
244252
1. Enter a **Name** for the runbook. It must begin with a letter and can contain only letters, numbers, underscores, and dashes.
245253
1. From the **Runbook type** dropdown, select the type of runbook that you want to create.
246254
1. Select **Runtime environment** to be configured for the runbook. You can either **Select from existing** Runtime environments or **Create new** Runtime environment and link it to the Runbook. The list of runtime environments is populated based on the *Runbook type* selected in step b.
@@ -368,7 +376,7 @@ https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<reso
368376
You can execute runbooks linked to Runtime Environment both on Azure and Hybrid Worker.
369377

370378
#### [REST API](#tab/create-cloud-job-rest)
371-
Jobs inherit the Runtime environment from the runbook. Run a cloud job for a published runbook:
379+
Jobs inherit the Runtime environment from the runbook. Run a cloud job for a published runbook.
372380

373381
```rest
374382
PUT
15.8 KB
Loading
41.6 KB
Loading

articles/automation/quickstart-cli-support-powershell-runbook-runtime-environment.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Add Support for Azure CLI in PowerShell 7.2 Runbooks in Runtime Environme
33
titleSuffix: Azure Automation
44
description: This article shows how to add support for Azure CLI in PowerShell 7.2 runbooks in Runtime environment.
55
services: automation
6-
ms.date: 09/15/2024
6+
ms.date: 06/27/2025
77
ms.topic: quickstart
88
ms.custom: references_regions, devx-track-azurecli
99
ms.author: v-jasmineme
@@ -38,14 +38,14 @@ To create Runtime environment in Azure portal, follow these steps:
3838
1. Enter appropriate **Description**.
3939
1. On the **Packages** tab, in the **Package version** dropdown list, you would see **Az version 12.3.0** and **Azure CLI version 2.64.0** already present.
4040
1. Select **+Add from gallery** to add more packages from gallery and select **Next**.
41-
1. On **Review + create** tab, review the entries and select **Create**.
41+
1. On the **Review + create** tab, review the entries and select **Create**.
4242

4343
A notification appears to confirm that a Runtime environment is successfully created.
4444

4545

4646
#### [REST API](#tab/create-runtime-env-rest)
4747

48-
Azure CLI version 2.56.0 is available only for PowerShell 7.2 Runtime environment.
48+
4949

5050
```rest
5151
PUT
@@ -83,13 +83,13 @@ To create a runbook, follow these steps:
8383
1. Enter appropriate **Description**.
8484

8585

86-
1. Add runbook code on the **Edit Runbook page** and select **Save**.
86+
1. Add runbook code on the **Edit Runbook** page and select **Save**.
8787

8888
1. **Test** runbook execution in Test pane. After you confirm the results, select **Publish** to publish the runbook and execute it.
8989

9090
#### [REST API](#tab/create-runbook-rest)
9191

92-
You can create runbooks and link with PowerShell 7.2 Runtime environment.
92+
9393

9494
```rest
9595

articles/automation/quickstart-update-runbook-in-runtime-environment.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Update PowerShell Runbook in Azure Runtime Environment
33
titleSuffix: Azure Automation
44
description: This article shows how to update a runbook from PowerShell 5.1 to PowerShell 7.2 in Runtime environment.
55
services: automation
6-
ms.date: 09/15/2024
6+
ms.date: 06/27/2025
77
ms.topic: quickstart
88
ms.custom: references_regions
99
ms.author: v-jasmineme

articles/automation/runtime-environment-overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Runtime Environment in Azure Automation
33
description: This article provides an overview on Runtime environment in Azure Automation.
44
services: automation
55
ms.subservice: process-automation
6-
ms.date: 11/19/2024
6+
ms.date: 06/27/2025
77
ms.topic: overview
88
ms.custom: references_regions, devx-track-azurecli
99
ms.service: azure-automation

articles/automation/whats-new.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Significant updates to Azure Automation updated each month.
44
services: automation
55
ms.subservice:
66
ms.topic: overview
7-
ms.date: 02/01/2025
7+
ms.date: 06/27/2025
88
ms.custom: references_regions
99
ms.author: v-jasmineme
1010
author: jasminemehndir
@@ -29,7 +29,7 @@ This page is updated monthly, so revisit it regularly. If you're looking for ite
2929

3030
Azure Automation announces General Availability of PowerShell 7.4 and Python 3.10 runbooks in all Public regions except Brazil southeast and Gov clouds. PowerShell 7.1 and 7.2 versions and Python 2.7 and 3.8 versions are announced retired by parent products PowerShell and Python respectively, and hence not recommended. [Learn more](automation-runbook-types.md).
3131

32-
### General Availability: Azure Automation Runtime environment and support for Azure CLI commands in runbooks.
32+
### General Availability: Azure Automation Runtime environment
3333

3434
Azure Automation announces General Availability of [Runtime Environment](runtime-environment-overview.md) in all Public regions except Brazil southeast and Gov clouds. You can seamlessly [update](quickstart-update-runbook-in-runtime-environment.md) your outdated PowerShell 7.1, PowerShell 7.2, Python 2.7 and Python 3.8 runbooks to latest runtime versions, thereby enhancing security. This feature provides complete control to configure the script execution environment, without worrying about conflicting module versions in a single Automation account. All existing runbooks are automatically available in the new Runtime environment experience with zero manual effort. [Learn more](manage-runtime-environment.md).
3535

0 commit comments

Comments
 (0)