Merge pull request #34585 from MikeRayMSFT/250701-css-upgrade-extensions

CSS Add update extension

Author: JamesJBarnett

docs/sql-server/azure-arc/configure-private-path.md

@@ -3,10 +3,9 @@ title: Connect with Private Path
 description: This article describes how to connect SQL Server enabled by Azure Arc to Azure with a private path.
 author: MikeRayMSFT
 ms.author: mikeray
+ms.date: 07/03/2025
 ms.topic: how-to #Don't change
-ms.date: 02/01/2025
-
-#customer intent: As a data engineer, I want to use a private path to connect to Azure Arc so I can avoid internet traffic.
+# customer intent: As a data engineer, I want to use a private path to connect to Azure Arc so I can avoid internet traffic.
 ---
 
 # Connect to Azure with a private path for SQL Server enabled by Azure Arc
@@ -15,20 +14,20 @@ This article describes how to configure communication for a SQL Server enabled b
 
 This design deploys forward proxy servers in Azure to allow SQL Server to communicate over a site-to-site VPN or ExpressRouteConnection with private IP addresses. The proxies communicate with Arc URLs over the Azure backbone network.
 
-> [!IMPORTANT]
+> [!IMPORTANT]  
 > This implementation uses [Azure Firewall Explicit proxy](/azure/firewall/explicit-proxy) - which is currently available in preview.
 
 The following diagram represents this pattern.
 
-:::image type="content" source="media/configure-private-path/architecture.png" alt-text="Diagram representing private path deployment.":::
+:::image type="content" source="media/configure-private-path/architecture.png" alt-text="Diagram representing private path deployment." lightbox="media/configure-private-path/architecture.png":::
 
 For the forward proxy, choose either:
 
 - Azure Firewall Explicit proxy (preview) feature, which is a Platform as a Service (PaaS) network security Service.
 
   Or
 
-- A third-party proxy Network Virtual Appliance (NVA).  
+- A third-party proxy Network Virtual Appliance (NVA).
 
   The diagram shows Azure Firewall Explicit proxy.
 
@@ -63,7 +62,7 @@ Create a site-to-site VPN from your SQL Server location to Azure.
 
 1. Follow the steps at [Tutorial: Create and manage a VPN gateway using the Azure portal](/azure/vpn-gateway/tutorial-create-gateway-portal) to create VPN Gateway.
 
-2. Create a Local Network Gateway before creating a Site 2 Site VPN. Follow the steps at [Tutorial: Create a site-to-site VPN connection in the Azure portal](/azure/vpn-gateway/tutorial-site-to-site-portal).
+1. Create a Local Network Gateway before creating a Site 2 Site VPN. Follow the steps at [Tutorial: Create a site-to-site VPN connection in the Azure portal](/azure/vpn-gateway/tutorial-site-to-site-portal).
 
 ## Create firewall and configure the proxy
 
@@ -126,8 +125,10 @@ If you're not going to continue to use this application, delete these resources.
 To delete the resources from Azure portal:
 
 1. Enter the name of your resource group in the search box select it from the search results.
-2. Select **Delete resource group**.
-3. Confirm the resource group name at **Type the resource group name**, and select Delete.
+1. Select **Delete resource group**.
+1. Confirm the resource group name at **Type the resource group name**, and select Delete.
+
+[!INCLUDE [manage-extension](includes/manage-extension.md)]
 
 ## Related content
 
@@ -136,4 +137,3 @@ To delete the resources from Azure portal:
 - [Monitor Azure Firewall](/azure/firewall/monitor-firewall#azure-monitor-resource-logs)
 - [Tutorial: Create and manage a VPN gateway using the Azure portal](/azure/vpn-gateway/tutorial-create-gateway-portal)
 - [Tutorial: Create a site-to-site VPN connection in the Azure portal](/azure/vpn-gateway/tutorial-site-to-site-portal)
-

docs/sql-server/azure-arc/connect-already-enabled.md

@@ -4,7 +4,7 @@ description: Connect an instance of SQL Server to Azure Arc on a server that is
 author: anosov1960
 ms.author: sashan
 ms.reviewer: mikeray, maghan
-ms.date: 06/30/2025
+ms.date: 07/03/2025
 ms.topic: how-to
 ---
 
@@ -89,6 +89,8 @@ Go to **Azure Arc > SQL Server** and open the newly registered Arc-enabled SQL S
 
 :::image type="content" source="media/join/validate-sql-server-azure-arc.png" alt-text="Screenshot of validating a connected SQL Server." lightbox="media/join/validate-sql-server-azure-arc.png":::
 
+[!INCLUDE [manage-extension](includes/manage-extension.md)]
+
 ## Related content
 
 - [Protect SQL Server with Microsoft Defender for Cloud](configure-advanced-data-security.md)

docs/sql-server/azure-arc/connect.md

@@ -1,12 +1,13 @@
 ---
-title: Connect your SQL Server to Azure Arc
+title: Connect Your SQL Server to Azure Arc
 description: Connect an instance of SQL Server to Azure Arc. Allows you to manage SQL Server centrally, as an Arc-enabled resource.
 author: anosov1960
 ms.author: sashan
 ms.reviewer: mikeray, maghan
-ms.date: 03/08/2024
+ms.date: 07/03/2025
 ms.topic: how-to
-ms.custom: references_regions
+ms.custom:
+  - references_regions
 ---
 
 # Connect your SQL Server to Azure Arc
@@ -15,20 +16,20 @@ ms.custom: references_regions
 
 [!INCLUDE [automatic](includes/if-manual.md)]
 
-This article explains how to connect your SQL Server instance to Azure Arc. Before you proceed, complete the [Prerequisites](prerequisites.md).
+This article explains how to connect your SQL Server instance to Azure Arc. Before you proceed, complete the [Prerequisites - SQL Server enabled by Azure Arc](prerequisites.md).
 
 ## Onboard the server to Azure Arc
 
 If the server that runs your SQL Server instance isn't yet connected to Azure, you can initiate the connection from the target machine using the onboarding script. This script connects the server to Azure and installs the Azure extension for SQL Server.
 
 > [!NOTE]  
-> If your server is already connected to Azure, proceed to [When the machine is already connected to an Arc-enabled Server](connect-already-enabled.md).
+> If your server is already connected to Azure, proceed to [Connect your SQL Server to Azure Arc on a server already enabled by Azure Arc](connect-already-enabled.md).
 
 ### Generate an onboarding script for SQL Server
 
 1. Go to **Azure Arc > SQL Server** and select **+ Add**
 
-   :::image type="content" source="media/join/start-creation-of-sql-server-azure-arc-resource.png" alt-text="Screenshot of the start creation.":::
+   :::image type="content" source="media/join/start-creation-of-sql-server-azure-arc-resource.png" alt-text="Screenshot of the start creation." lightbox="media/join/start-creation-of-sql-server-azure-arc-resource.png":::
 
 1. Under **Connect SQL Server to Azure Arc**, select **Connect Servers**
 
@@ -45,23 +46,23 @@ If the server that runs your SQL Server instance isn't yet connected to Azure, y
 
     To use a specific name for Azure Arc enabled Server instead of default host name, users can add the name for Azure Arc enabled Server in **Server Name**.
 
-   :::image type="content" source="media/join/server-details-sql-server-azure-arc.png" alt-text="Screenshot of server details for Azure Arc.":::
+   :::image type="content" source="media/join/server-details-sql-server-azure-arc.png" alt-text="Screenshot of server details for Azure Arc." lightbox="media/join/server-details-sql-server-azure-arc.png":::
 
-1. Select the SQL Server edition and license type you are using on this machine. Some Arc-enabled SQL Server features are only available for SQL Server instances with Software Assurance (Paid) or with Azure pay-as-you-go. For more information, review [Manage SQL Server license type](manage-configuration.md).
+1. Select the SQL Server edition and license type you're using on this machine. Some Arc-enabled SQL Server features are only available for SQL Server instances with Software Assurance (Paid) or with Azure pay-as-you-go. For more information, review [Configure SQL Server enabled by Azure Arc](manage-configuration.md).
 
-1. Specify the SQL Server instance(s) you want to exclude from registering (if you have multiple instances installed on the server).  Separate each excluded instance by a space.
+1. Specify the SQL Server instance(s) you want to exclude from registering (if you have multiple instances installed on the server). Separate each excluded instance by a space.
 
    > [!IMPORTANT]  
    > If the machine hosting the SQL Server instance is already [connected to Azure Arc](/azure/azure-arc/servers/onboard-portal), make sure to select the same resource group that contains the corresponding **Server - Azure Arc** resource.
 
-   :::image type="content" source="media/join/server-details-sql-server-management-azure-arc.png" alt-text="Screenshot of server management details.":::
+   :::image type="content" source="media/join/server-details-sql-server-management-azure-arc.png" alt-text="Screenshot of server management details." lightbox="media/join/server-details-sql-server-management-azure-arc.png":::
 
 1. Select **Next: Tags** to optionally add tags to the resource for your SQL Server instance.
 
 1. Select **Run script** to generate the onboarding script.
 Screenshot of
 
-   :::image type="content" source="media/join/download-script-sql-server-azure-arc.png" alt-text="Screenshot of a download script.":::
+   :::image type="content" source="media/join/download-script-sql-server-azure-arc.png" alt-text="Screenshot of a download script." lightbox="media/join/download-script-sql-server-azure-arc.png":::
 
 1. Select **Download** to download the script to your machine.
 
@@ -97,14 +98,17 @@ In this step, execute the script you downloaded from the Azure portal, on the ta
    ```
 
 ---
+
 ## Validate your Arc-enabled SQL Server resources
 
 Go to **Azure Arc > SQL Server** and open the newly registered Arc-enabled SQL Server resource to validate.
 
-   :::image type="content" source="media/join/validate-sql-server-azure-arc.png" alt-text="Screenshot of validating a connected SQL Server.":::
+   :::image type="content" source="media/join/validate-sql-server-azure-arc.png" alt-text="Screenshot of validating a connected SQL Server." lightbox="media/join/validate-sql-server-azure-arc.png":::
+
+[!INCLUDE [manage-extension](includes/manage-extension.md)]
 
-## Next steps
+## Related content
 
-- [Configure advanced data security for your SQL Server instance](configure-advanced-data-security.md)
-- [Configure best practices assessment on a [!INCLUDE [ssazurearc](../../includes/ssazurearc.md)] instance](assess.md)
+- [Protect SQL Server with Microsoft Defender for Cloud](configure-advanced-data-security.md)
+- [Configure best practices assessment for SQL Server enabled by Azure Arc](assess.md)
 - [Known issues: SQL Server enabled by Azure Arc](known-issues.md)

docs/sql-server/azure-arc/deployment-options.md

@@ -1,10 +1,10 @@
 ---
-title: Deployment options
+title: Deployment Options
 description: Explains different ways to deploy SQL Server enabled by Azure Arc.
 author: anosov1960
 ms.author: sashan
 ms.reviewer: mikeray, randolphwest
-ms.date: 07/18/2023
+ms.date: 07/03/2025
 ms.topic: conceptual
 ---
 
@@ -16,24 +16,28 @@ Azure Arc automatically installs the Azure extension for SQL Server when a serve
 
 To automatically connect your server, see [Azure Connected Machine agent deployment options](/azure/azure-arc/servers/deployment-options).
 
-If your server is already connected to Azure, but Azure extension for SQL Server did not deploy automatically.
+If your server is already connected to Azure, but Azure extension for SQL Server didn't deploy automatically.
 
-> [!TIP]
+> [!TIP]  
 > Beginning with SQL Server 2022, you can connect a new SQL Server instance to Azure Arc when you're installing it on Windows Operating System. [Install SQL Server 2022](../../database-engine/install-windows/install-sql-server-from-the-installation-wizard-setup.md#install-sql-server-2022).
 
-## Onboarding methods
+<a id="onboarding-methods"></a>
+
+## Onboard methods
 
 The following table highlights each method so that you can determine which works best for your deployment. For detailed information, follow the links to view the steps for each topic.
 
 | Method | Description |
-| ------ | ----- |
-| Interactively | Manually connect the SQL Server on a single physical or virtual machine that is already connected to Azure Arc. [Connect your SQL Server to Azure Arc on a server already connected to Azure Arc](connect-already-enabled.md)|
-|At scale| [Automatically enable SQL Server for Azure Arc](manage-autodeploy.md)|
-| At scale | [Connect machines at scale by running PowerShell scripts with Configuration Manager](/azure/azure-arc/servers/onboard-configuration-manager-powershell)|
-| At scale | [Connect machines at scale with a Configuration Manager custom task sequence](/azure/azure-arc/servers/onboard-configuration-manager-custom-task)|
+| --- | --- |
+| Interactively | Manually connect the SQL Server on a single physical or virtual machine that is already connected to Azure Arc. [Connect your SQL Server to Azure Arc on a server already enabled by Azure Arc](connect-already-enabled.md) |
+| At scale | [Manage automatic connection for SQL Server enabled by Azure Arc](manage-autodeploy.md) |
+| At scale | [Connect machines at scale by running PowerShell scripts with Configuration Manager](/azure/azure-arc/servers/onboard-configuration-manager-powershell) |
+| At scale | [Connect machines at scale with a Configuration Manager custom task sequence](/azure/azure-arc/servers/onboard-configuration-manager-custom-task) |
 
 Be sure to review the basic [prerequisites](prerequisites.md) before you deploy the agent, as well as any specific requirements listed in the steps for the onboarding method you choose.
 
-## Next steps
+[!INCLUDE [manage-extension](includes/manage-extension.md)]
+
+## Related content
 
-* Learn about the Azure Connected Machine agent and network requirements in [prerequisites](prerequisites.md)
+- [Prerequisites](prerequisites.md)

docs/sql-server/azure-arc/includes/manage-extension.md

@@ -0,0 +1,15 @@
+---
+author: MikeRayMSFT
+ms.author: mikeray
+ms.reviewer: randolphwest
+ms.date: 07/03/2025
+ms.topic: include
+ms.custom:
+  - ignite-2023
+---
+
+## Upgrade extension version
+
+For more information about upgrading the Azure extension for SQL Server, see [Upgrade extension](/azure/azure-arc/servers/manage-vm-extensions-cli#upgrade-extensions).
+
+To get the current extension version, review [Release notes - SQL Server enabled by Azure Arc](../release-notes.md).