Clean-up the set version stuff

Author: ggailey777

articles/azure-functions/functions-bindings-azure-data-explorer.md

@@ -82,7 +82,7 @@ Azure Data Explorer bindings for Azure Functions aren't available for the v3 ver
 ## Functions runtime
 
 > [!NOTE]
-> Python language support for the Azure Data Explorer bindings extension is available starting with v4.6.0 or later of the [Functions runtime](set-runtime-version.md#view-and-update-the-current-runtime-version). You might need to update your installation of Azure Functions [Core Tools](functions-run-local.md) for local development.
+> Python language support for the Azure Data Explorer bindings extension is available starting with v4.6.0 or later of the [Functions runtime](set-runtime-version.md#pin-to-a-specific-version-on-linux). You might need to update your installation of Azure Functions [Core Tools](functions-run-local.md) for local development.
 
 ## Install the bundle
 

articles/azure-functions/functions-reference-powershell.md

@@ -415,7 +415,7 @@ Support for PowerShell 7.0 in Azure Functions has ended on 3 December 2022. To u
 
 ### Changing the PowerShell version
 
-Support for PowerShell 7.0 in Azure Functions has ended on 3 December 2022. To upgrade your Function App to PowerShell 7.2, ensure the value of FUNCTIONS_EXTENSION_VERSION is set to ~4. To learn how to do this, see [View and update the current runtime version](set-runtime-version.md#view-and-update-the-current-runtime-version).
+Support for PowerShell 7.0 in Azure Functions has ended on 3 December 2022. To upgrade your Function App to PowerShell 7.2, ensure the value of FUNCTIONS_EXTENSION_VERSION is set to ~4. To learn how to do this, see [View and update the current runtime version](set-runtime-version.md#view-the-current-runtime-version).
 
 
 Use the following steps to change the PowerShell version used by your function app. You can do this either in the Azure portal or by using PowerShell.

articles/azure-functions/set-runtime-version.md

@@ -101,16 +101,21 @@ Replace `<FUNCTION_APP>` with the name of your function app and `<RESOURCE_GROUP
 ::: zone pivot="platform-windows" 
 ## Change the runtime version
 
-You can change the major version of the runtime used by your function app to another supported version. Because of the potential of breaking changes, you can only change the runtime version before you've created any functions in your function app. 
+You can change the major version of the runtime used by your function app to another supported version. You can move forward to a later major version, downgrade to an earlier supported version, or temporarily pin your app to a specific minor version. 
 
-> [!IMPORTANT]
-> Although the runtime version is determined by the `FUNCTIONS_EXTENSION_VERSION` setting, when possible you should only make this change in the Azure portal and not by changing the setting directly. This is because the portal validates your changes and makes other related changes as needed. 
-> When you need to temporarily pin your function app to a specific minor version, it's OK to set the specific minor version by directly changing the `FUNCTIONS_EXTENSION_VERSION` setting.  
+When setting the runtime version, keep these considerations in mind:
+
++ Although the runtime version is determined by the `FUNCTIONS_EXTENSION_VERSION` setting, when possible you should only make this change in the Azure portal and not by changing the setting directly. This is because the portal validates your changes and makes other related changes as needed.   
++ When you need to temporarily pin your function app to a specific minor version, it's OK to set the specific minor version by directly changing the `FUNCTIONS_EXTENSION_VERSION` setting.  
++ Because of the potential of breaking changes, you can only downgrade the runtime version before you've created any functions in your function app. 
 
 ### [Portal](#tab/portal)
 
 [!INCLUDE [Set the runtime version in the portal](../../includes/functions-view-update-version-portal.md)]
 
+3. To pin your app to a specific minor version or downgrade a new .NET function app to version 1.x, select **Application settings** > **FUNCTIONS_EXTENSION_VERSION**, change **Value** to your required minor version or `~1` for downgrade, and select **OK**.
+
+4. Select **Save** > **Continue** to apply changes and restart the app.
 
 ### [Azure CLI](#tab/azurecli)
 
@@ -122,7 +127,7 @@ az functionapp config appsettings set --name <FUNCTION_APP> \
 --settings FUNCTIONS_EXTENSION_VERSION=<VERSION>
 ```
 
-Replace `<FUNCTION_APP>` with the name of your function app and `<RESOURCE_GROUP>` with the name of the resource group for your function app. Also, replace `<VERSION>` with either a supported major version (`~4` or `~1`) or a specific minor version you temporarily need to target.
+Replace `<FUNCTION_APP>` with the name of your function app and `<RESOURCE_GROUP>` with the name of the resource group for your function app. Also, replace `<VERSION>` with either a supported major version (`~4` or `~1`—.NET-only) or a specific minor version you temporarily need to target.
 
 Choose **Try it** in the previous code example to run the command in [Azure Cloud Shell](../cloud-shell/overview.md). You can also run the [Azure CLI locally](/cli/azure/install-azure-cli) to execute this command. When running locally, you must first run [`az login`](/cli/azure/reference-index#az-login) to sign in.
 
@@ -142,7 +147,7 @@ Use the following script to change the Functions runtime:
 Update-AzFunctionAppSetting -Name "<FUNCTION_APP>" -ResourceGroupName "<RESOURCE_GROUP>" -AppSetting @{"FUNCTIONS_EXTENSION_VERSION" = "<VERSION>"} -Force
 ```
 
-Replace `<FUNCTION_APP>` with the name of your function app and `<RESOURCE_GROUP>` with the name of the resource group for your function app. Also, replace `<VERSION>` with either a supported major version (`~4` or `~1`) or a specific minor version you temporarily need to target. You can verify the updated value of the `FUNCTIONS_EXTENSION_VERSION` setting in the returned hash table. 
+Replace `<FUNCTION_APP>` with the name of your function app and `<RESOURCE_GROUP>` with the name of the resource group for your function app. Also, replace `<VERSION>` with either a supported major version (`~4` or `~1`—.NET-only) or a specific minor version you temporarily need to target. You can verify the updated value of the `FUNCTIONS_EXTENSION_VERSION` setting in the returned hash table. 
 
 ---
 

includes/functions-dotnet-supported-versions.md

@@ -13,7 +13,7 @@ ms.author: glenga
 Versions of the Functions runtime support specific versions of .NET. To learn more about Functions versions, see [Azure Functions runtime versions overview](../articles/azure-functions/functions-versions.md). Version support also depends on whether your functions run in-process or isolated worker process. 
 
 >[!NOTE]
->To learn how to change the Functions runtime version used by your function app, see [view and update the current runtime version](../articles/azure-functions/set-runtime-version.md#view-and-update-the-current-runtime-version).
+>To learn how to change the Functions runtime version used by your function app, see [view and update the current runtime version](../articles/azure-functions/set-runtime-version.md#view-the-current-runtime-version).
 
 The following table shows the highest level of .NET or .NET Framework that can be used with a specific version of Functions. 
 

includes/functions-view-update-version-portal.md

@@ -1,13 +1,9 @@
 ---
-title: include file
-description: include file
-services: functions
 author: ggailey777
 ms.service: azure-functions
-ms.topic: include
-ms.date: 11/26/2018
+ms.date: 03/26/2024
 ms.author: glenga
-ms.custom: include file
+ms.topic: include
 ---
 
 Use the following procedure to view and update the runtime version currently used by a function app.
@@ -17,9 +13,3 @@ Use the following procedure to view and update the runtime version currently use
 1. Under **Settings**, choose **Configuration**. In the **Function runtime settings** tab, locate the **Runtime version**. Note the specific runtime version. In the example below, the version is set to `~4`.
 
     :::image type="content" source="./media/functions-view-update-version-portal/functions-view-runtime-version-4.png" alt-text="Screenshot showing how to view the runtime version." border="true":::
-
-1. To pin your function app to the version 1.x runtime, choose **~1** under **Runtime version**. This switch is disabled when you have functions in your app.
-
-1. When you change the runtime version, go back to the **Overview** tab and choose **Restart** to restart the app.  The function app restarts running on the version 1.x runtime, and the version 1.x templates are used when you create functions.
-
-    :::image type="content" source="./media/functions-view-update-version-portal/functions-restart-function-app.png" alt-text="Restart your function app." border="true":::