New feedback incorporated, added tabs for Quickstart cli, updated cli version

Author: SnehaSudhirG

articles/automation/manage-runtime-environment.md

@@ -3,7 +3,7 @@ title: Manage Runtime environment and associated runbooks in Azure Automation
 description: This article tells how to manage runbooks in Runtime environment and associated runbooks Azure Automation
 services: automation
 ms.subservice: process-automation
-ms.date: 01/16/2024
+ms.date: 01/17/2024
 ms.topic: conceptual
 ms.custom: references_regions
 ---
@@ -68,7 +68,7 @@ An Azure Automation account in supported public region (except Central India, Ge
    :::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.":::
 
    > [!NOTE]
-   > Azure CLI commands are supported (preview) in runbooks associated with PowerShell 7.2 Runtime environment. Azure CLI commands version 2.52.0 are available as a default package in PowerShell 7.2 Runtime environment.
+   > Azure CLI commands are supported (preview) in runbooks associated with PowerShell 7.2 Runtime environment. Azure CLI commands version 2.56.0 are available as a default package in PowerShell 7.2 Runtime environment.
 
 1. To upload more Packages required during runbook execution. Select **Add a file** to add the file(s) stored locally on your computer or select **Add from gallery** to upload packages from PowerShell gallery.
 
@@ -264,7 +264,7 @@ https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<reso
             "uri": "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-automation-runbook-getvms/Runbooks/Get-AzureVMTutorial.ps1" 
         } 
     }, 
-   “location”: “East US” 
+   "location": "East US"
 } 
 ```
 > [!NOTE]
@@ -301,7 +301,7 @@ PATCH
 https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runbooks/<runbookName>?api-version=2023-05-15-preview 
 { 
   "properties": { 
-    “type”: “PowerShell” 
+    "type": "PowerShell" 
     "runtimeEnvironment": "<runtimeEnvironmentName>" 
   } 
 } 

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

@@ -3,7 +3,7 @@ title: Add support for Azure CLI in PowerShell 7.2 runbooks in Runtime environme
 titleSuffix: Azure Automation
 description: This article shows how to add support for Azure CLI in PowerShell 7.2 runbooks in Runtime environment.
 services: automation
-ms.date: 01/16/2024
+ms.date: 01/17/2024
 ms.topic: conceptual
 ms.custom: references_regions
 ---
@@ -13,7 +13,7 @@ ms.custom: references_regions
 You can run Azure CLI commands in runbooks linked with PowerShell 7.2 Runtime environment.
 
 > [!NOTE]
-> Azure CLI commands version 2.52.0 are available as a default package in PowerShell 7.2 Runtime environment.
+> Azure CLI commands version 2.56.0 are available as a default package in PowerShell 7.2 Runtime environment.
 
 ## Prerequisites
 
@@ -25,24 +25,50 @@ You can run Azure CLI commands in runbooks linked with PowerShell 7.2 Runtime en
 > [!NOTE]
 > Instead of creating a new PowerShell 7.2 Runtime environment, you can use the System-generated PowerShell 7.2 Runtime environment.
 
+#### [Azure portal](#tab/create-runtime-env-portal)
+
 1. Sign in to the Azure [portal](https://portal.azure.com) and select your Automation account.
 1. Under **Process Automation**, select **Runtime Environments (preview)** and then select **Create**.
 1. On **Basics** tab, provide the following details:
     1. Provide **Name** for the Runtime environment. It must begin with alphabet and can contain only alphabets, numbers, underscores, and dashes.  
     1. From the **Language** dropdown list, select  **PowerShell**.
     1. In **Runtime version** for scripting language, select 7.2
     1. Provide appropriate **Description**.
-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.
+1. On **Packages** tab, in the **Package version** dropdown list, you would see **Az version 8.3** and **Azure CLI version 2.56.0** already present.
 1. Select **+Add from gallery** to add more packages from gallery and select **Next**.
 1. On **Review + create** tab, review the entries and select **Create**.
 
    A notification appears to confirm that a Runtime environment is successfully created.
 
    :::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":::
 
+#### [REST API](#tab/create-runtime-env-rest)
+
+Azure CLI version 2.56.0 is available only for PowerShell 7.2 Runtime environment.
+
+```rest
+PUT
+https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>?api-version=2023-05-15-preview
+{ 
+  "properties": { 
+    "runtime": { 
+        "language": "PowerShell",  
+        "version": "7.2" 
+        }, 
+        "defaultPackages": { 
+            "Az": "8.3.0",
+            "Azure CLI": "2.56.0"
+        } 
+     }, 
+    "name": "<runtimeEnvironmentName>"
+}
+```
+---
 
 ## Create Runbook
 
+#### [Azure portal](#tab/create-runbook-portal)
+
 You can create a new PowerShell runbook that supports Azure CLI commands and is associated with PowerShell 7.2 Runtime environment.
 
 To create a runbook, follow these steps:
@@ -60,6 +86,29 @@ In your Automation account, under **Process Automation**, select **Runbooks**.
 1. Add runbook code on the **Edit Runbook page** and select **Save**.
 
 1. **Test** runbook execution in Test pane. After you confirm the results, select **Publish** to publish the runbook and execute it.
- 
+
+#### [REST API](#tab/create-runbook-rest)
+
+You can create runbooks and link with PowerShell 7.2 Runtime environment.
+
+```rest
+
+PUT 
+https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runbooks/<runbookName>?api-version=2023-05-15-preview
+
+
+{ 
+  "properties": { 
+        "runbookType": "PowerShell", 
+        "runtimeEnvironment": <runtimeEnvironmentName>, 
+        "publishContentLink": { 
+            "uri": "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-automation-runbook-getvms/Runbooks/Get-AzureVMTutorial.ps1" 
+        } 
+    }, 
+   "location": "East US"
+}
+```
+---
+
 ## Next steps
 - See [Manage Runtime environment](manage-runtime-environment.md) to view the various operations through portal and REST API.

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

@@ -33,7 +33,7 @@ Using the Runtime environment, you can upgrade a runbook from one Runtime versio
     1. From the **Language** dropdown list, select  **PowerShell**.
     1. In **Runtime version** for scripting language, select 7.2.
     1. Provide appropriate **Description**.
-1. On **Packages** tab, in the **Package version** dropdown list, you would see **Az version 8.3.0** and **Azure CLI version 2.52.0** packages already present.
+1. On **Packages** tab, in the **Package version** dropdown list, you would see **Az version 8.3.0** and **Azure CLI version 2.56.0** packages already present.
 1. Select **+Add from gallery** to add more packages from gallery and select **Next**.
 1. On **Review + create** tab, review the entries and select **Create**.
 

articles/automation/runtime-environment-overview.md

@@ -3,7 +3,7 @@ title: Runtime environment in Azure Automation
 description: This article provides an overview on Runtime environment in Azure Automation.
 services: automation
 ms.subservice: process-automation
-ms.date: 01/16/2024
+ms.date: 01/17/2024
 ms.topic: conceptual
 ms.custom: references_regions
 ---
@@ -35,11 +35,11 @@ Runtime environment captures the following details about the job execution envir
 
    |**Package Types** | **Description** |
    |---------|---------|
-   |**Default packages**  | The packages enable you to manage Azure resources. For example, Az PowerShell 8.0.0, Azure CLI 2.52.0|
+   |**Default packages**  | The packages enable you to manage Azure resources. For example, Az PowerShell 8.0.0, Azure CLI 2.56.0|
    |**Customer-provided packages** | These are custom packages that are required by runbooks during execution. The packages can be from: </br> - Public gallery: PSGallery, pypi </br> - Self-authored. |
 
 > [!NOTE]
-> 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.
+> Azure CLI commands are supported (public preview) in runbooks associated with PowerShell 7.2 Runtime environment. Azure CLI commands version 2.56.0 is available as a default package in PowerShell 7.2 Runtime environment.
 
 ## Azure CLI package in Runtime environment 
 
@@ -58,14 +58,14 @@ Azure Automation creates system-generated Runtime environments based on the Runt
 - Python-3.8
 - Python-3.10
 
-  :::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":::
-
 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. 
 
+:::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":::
+
 > [!NOTE]
 > Packages present in System-generated Runtime environments are unique to your Azure Automation account and might vary across different accounts. 
 
-## Key Benefits
+## Key benefits
 
 - **Granular control** - enables you to configure the script execution environment by choosing the Runtime language, its version, and dependent modules.
 - **Runbook update** - allows easy portability of runbooks across different runtime versions by updating runtime environment of runbooks to keep pace with the latest PowerShell and Python releases. You can test updates before publishing them to production.