Merge pull request #312945 from v-thpra/tjp-fresh-appsrvc-001

v-ccolin · web-flow · commit 09d43196934b · 2026-04-10T09:20:44.000+01:00
Q&amp;M Freshness - App Service - TJP001
diff --git a/articles/app-service/webjobs-dotnet-deploy-vs.md b/articles/app-service/webjobs-dotnet-deploy-vs.md
@@ -1,12 +1,12 @@
 ---
-title: Develop and deploy WebJobs using Visual Studio
+title: Develop and Deploy WebJobs Using Visual Studio
 description: Learn how to develop Azure WebJobs in Visual Studio and deploy them to Azure App Service, including creating a scheduled task.
 author: ggailey777
 ms.assetid: a3a9d320-1201-4ac8-9398-b4c9535ba755
 ms.topic: how-to
 ms.devlang: csharp
 ms.custom: devx-track-csharp, vs-azure, devx-track-dotnet
-ms.date: 06/24/2021
+ms.date: 02/10/2026
 ms.author: glenga
 ms.reviewer: david.ebbo;suwatch;pbatum;naren.soni
 ms.service: azure-app-service
@@ -18,7 +18,7 @@ This article explains how to use Visual Studio to deploy a console app project t
 
 You can choose to develop a WebJob that runs as either a [.NET Core app](#webjobs-as-net-core-console-apps) or a [.NET Framework app](#webjobs-as-net-framework-console-apps). Version 3.x of the [Azure WebJobs SDK](webjobs-sdk-how-to.md) lets you develop WebJobs that run as either .NET Core apps or .NET Framework apps, while version 2.x supports only the .NET Framework. The way that you deploy a WebJobs project is different for .NET Core projects than for .NET Framework projects.
 
-You can publish multiple WebJobs to a single web app, provided that each WebJob in a web app has a unique name.
+You can publish multiple WebJobs to a single web app, if each WebJob in the web app has a unique name.
 
 ## WebJobs as .NET Core console apps
 
@@ -39,87 +39,94 @@ If you use Visual Studio to deploy a WebJobs-enabled .NET Framework console app
 
 Visual Studio adds the following items to a WebJobs-enabled project:
 
-* The [Microsoft.Web.WebJobs.Publish](https://www.nuget.org/packages/Microsoft.Web.WebJobs.Publish/) NuGet package.
-* A [webjob-publish-settings.json](#publishsettings) file that contains deployment and scheduler settings. 
+- The [Microsoft.Web.WebJobs.Publish](https://www.nuget.org/packages/Microsoft.Web.WebJobs.Publish/) NuGet package.
+- A [webjob-publish-settings.json](#webjob-publish-settingsjson-file) file that contains deployment and scheduler settings. 
 
-![Diagram showing what's added to a console app to enable deployment as a WebJob](./media/webjobs-dotnet-deploy-vs/convert.png)
+:::image type="content" source="./media/webjobs-dotnet-deploy-vs/convert.png" alt-text="Diagram showing the NuGet package and WebJob publish settings file being added to a console app to enable deployment as a WebJob.":::
 
 You can add these items to an existing console app project or use a template to create a new WebJobs-enabled console app project. 
 
-Deploy a project as a WebJob by itself, or link it to a web project so that it automatically deploys whenever you deploy the web project. To link projects, Visual Studio includes the name of the WebJobs-enabled project in a [webjobs-list.json](#webjobslist) file in the web project.
+Deploy a project as a WebJob by itself, or link it to a web project so that it automatically deploys whenever you deploy the web project. To link projects, Visual Studio includes the name of the WebJobs-enabled project in a [webjobs-list.json](#webjobs-listjson-file) file in the web project.
 
-![Diagram showing WebJob project linking to web project](./media/webjobs-dotnet-deploy-vs/link.png)
+:::image type="content" source="./media/webjobs-dotnet-deploy-vs/link.png" alt-text="Diagram showing that a WebJobs project is linked to a web project when its name is included in the the webjobs-list.json file.":::
 
 ### Prerequisites
 
 Install Visual Studio 2022 with the [Azure development workload](/visualstudio/install/install-visual-studio#step-4---choose-workloads).
 
-### <a id="convert"></a> Enable WebJobs deployment for an existing console app project
+### Enable WebJobs deployment for an existing console app project
 
 You have two options:
 
-* [Enable automatic deployment with a web project](#convertlink).
+- [Enable automatic deployment with a web project](#enable-automatic-webjobs-deployment-with-a-web-project).
 
   Configure an existing console app project so that it automatically deploys as a WebJob when you deploy a web project. Use this option when you want to run your WebJob in the same web app in which you run the related web application.
 
-* [Enable deployment without a web project](#convertnolink).
+- [Enable deployment without a web project](#enable-webjobs-deployment-without-a-web-project).
 
   Configure an existing console app project to deploy as a WebJob by itself, without a link to a web project. Use this option when you want to run a WebJob in a web app by itself, with no web application running in the web app. You might want to do so to scale your WebJob resources independently of your web application resources.
 
-#### <a id="convertlink"></a> Enable automatic WebJobs deployment with a web project
+#### Enable automatic WebJobs deployment with a web project
 
 1. Right-click the web project in **Solution Explorer**, and then select **Add** > **Existing Project as Azure WebJob**.
    
-    ![Existing Project as Azure WebJob](./media/webjobs-dotnet-deploy-vs/eawj.png)
+    :::image type="content" source="./media/webjobs-dotnet-deploy-vs/eawj.png" alt-text="Screenshot showing how to add an existing project as an Azure WebJob.":::
    
-    The [Add Azure WebJob](#configure) dialog box appears.
-2. In the **Project name** drop-down list, select the console app project to add as a WebJob.
+    The [Add Azure WebJob](#add-azure-webjob-dialog-box) dialog box appears.
+
+1. In the **Project name** drop-down list, select the console app project to add as a WebJob.
    
-    ![Selecting project in Add Azure WebJob dialog box](./media/webjobs-dotnet-deploy-vs/aaw1.png)
-3. Complete the [Add Azure WebJob](#configure) dialog box, and then select **OK**. 
+    :::image type="content" source="./media/webjobs-dotnet-deploy-vs/aaw1.png" alt-text="Screenshot showing how to select a project in the Add Azure WebJob dialog box.":::
+
+1. Complete the [Add Azure WebJob](#add-azure-webjob-dialog-box) dialog box, and then select **OK**. 
+
+#### Enable WebJobs deployment without a web project
 
-#### <a id="convertnolink"></a> Enable WebJobs deployment without a web project
 1. Right-click the console app project in **Solution Explorer**, and then select **Publish as Azure WebJob**. 
    
-    ![Publish as Azure WebJob](./media/webjobs-dotnet-deploy-vs/paw.png)
+    :::image type="content" source="./media/webjobs-dotnet-deploy-vs/paw.png" alt-text="Screenshot showing how to select Publish as Azure WebJob in the Solution Explorer.":::
    
-    The [Add Azure WebJob](#configure) dialog box appears, with the project selected in the **Project name** box.
-2. Complete the [Add Azure WebJob](#configure) dialog box, and then select **OK**.
+    The **Add Azure WebJob** dialog box appears, with the project selected in the **Project name** box.
+
+1. Complete the [Add Azure WebJob](#add-azure-webjob-dialog-box) dialog box, and then select **OK**.
    
-   The **Publish Web** wizard appears. If you don't want to publish immediately, close the wizard. The settings that you've entered are saved for when you do want to [deploy the project](#deploy).
+   The **Publish Web** wizard appears. If you don't want to publish immediately, close the wizard. The settings that you enter are saved for when you do want to [deploy the project](#deploy-a-webjobs-project).
 
-### <a id="create"></a>Create a new WebJobs-enabled project
-To create a new WebJobs-enabled project, use the console app project template and enable WebJobs deployment as explained in [the previous section](#convert). As an alternative, you can use the WebJobs new-project template:
+### Create a new WebJobs-enabled project
 
-* [Use the WebJobs new-project template for an independent WebJob](#createnolink)
+To create a new WebJobs-enabled project, use the console app project template and enable WebJobs deployment as explained in [the previous section](#enable-webjobs-deployment-for-an-existing-console-app-project). As an alternative, you can use the WebJobs new-project template:
+
+- [Use the WebJobs new-project template for an independent WebJob](#use-the-webjobs-new-project-template-for-an-independent-webjob)
   
     Create a project and configure it to deploy by itself as a WebJob, with no link to a web project. Use this option when you want to run a WebJob in a web app by itself, with no web application running in the web app. You might want to do so to scale your WebJob resources independently of your web application resources.
-* [Use the WebJobs new-project template for a WebJob linked to a web project](#createlink)
+
+- [Use the WebJobs new-project template for a WebJob linked to a web project](#use-the-webjobs-new-project-template-for-a-webjob-linked-to-a-web-project)
   
     Create a project that is configured to deploy automatically as a WebJob when you deploy a web project in the same solution. Use this option when you want to run your WebJob in the same web app in which you run the related web application.
 
 > [!NOTE]
 > The WebJobs new-project template automatically installs NuGet packages and includes code in *Program.cs* for the [WebJobs SDK](./webjobs-sdk-get-started.md). If you don't want to use the WebJobs SDK, remove or change the `host.RunAndBlock` statement in *Program.cs*.
-> 
-> 
 
-#### <a id="createnolink"></a> Use the WebJobs new-project template for an independent WebJob
+#### Use the WebJobs new-project template for an independent WebJob
+
 1. Select **File** > **New** > **Project**. In the **Create a new project** dialog box, search for and select **Azure WebJob (.NET Framework)** for C#.
    
-2. Follow the previous directions to [make the console app project an independent WebJobs project](#convertnolink).
+1. Follow the previous directions to [make the console app project an independent WebJobs project](#enable-webjobs-deployment-without-a-web-project).
+
+#### Use the WebJobs new-project template for a WebJob linked to a web project
 
-#### <a id="createlink"></a> Use the WebJobs new-project template for a WebJob linked to a web project
 1. Right-click the web project in **Solution Explorer**, and then select **Add** > **New Azure WebJob Project**.
    
-    ![New Azure WebJob Project menu entry](./media/webjobs-dotnet-deploy-vs/nawj.png)
+    :::image type="content" source="./media/webjobs-dotnet-deploy-vs/nawj.png" alt-text="Screenshot showing how to add a new Azure WebJob project.":::
    
-    The [Add Azure WebJob](#configure) dialog box appears.
-2. Complete the [Add Azure WebJob](#configure) dialog box, and then select **OK**.
+    The **Add Azure WebJob** dialog box appears.
+
+1. Complete the [Add Azure WebJob](#add-azure-webjob-dialog-box) dialog box, and then select **OK**.
+
 
+### webjob-publish-settings.json file
 
-### <a id="publishsettings"></a>webjob-publish-settings.json file
-When you configure a console app for WebJobs deployment, Visual Studio installs the [Microsoft.Web.WebJobs.Publish](https://www.nuget.org/packages/Microsoft.Web.WebJobs.Publish/) NuGet package 
-and stores scheduling information in a *webjob-publish-settings.json* file in the project *Properties* folder of the WebJobs project. Here is an example of that file:
+When you configure a console app for WebJobs deployment, Visual Studio installs the [Microsoft.Web.WebJobs.Publish](https://www.nuget.org/packages/Microsoft.Web.WebJobs.Publish/) NuGet package and stores scheduling information in a *webjob-publish-settings.json* file in the project *Properties* folder of the WebJobs project. Here's an example of that file:
 
 ```json
 {
@@ -135,7 +142,8 @@ and stores scheduling information in a *webjob-publish-settings.json* file in th
 
 You can edit this file directly, and Visual Studio provides IntelliSense. The file schema is stored at [https://schemastore.org](http://schemastore.org/schemas/json/webjob-publish-settings.json) and can be viewed there.  
 
-### <a id="webjobslist"></a>webjobs-list.json file
+### webjobs-list.json file
+
 When you link a WebJobs-enabled project to a web project, Visual Studio stores the name of the WebJobs project in a *webjobs-list.json* file in the web project's *Properties* folder. The list might contain multiple WebJobs projects, as shown in the following example:
 
 ```json
@@ -154,29 +162,31 @@ When you link a WebJobs-enabled project to a web project, Visual Studio stores t
 
 You can edit this file directly in Visual Studio, with IntelliSense. The file schema is stored at [https://schemastore.org](http://schemastore.org/schemas/json/webjobs-list.json).
 
-### <a id="deploy"></a>Deploy a WebJobs project
-A WebJobs project that you've linked to a web project deploys automatically with the web project. For information about web project deployment, see **How-to guides** > **Deploy the app** in the left navigation.
+### Deploy a WebJobs project
+
+A WebJobs project that you link to a web project deploys automatically with the web project. For information about web project deployment, see **How-to guides** > **Deploy the app** in the left navigation.
 
 To deploy a WebJobs project by itself, right-click the project in **Solution Explorer** and select **Publish as Azure WebJob**. 
 
-![Publish as Azure WebJob](./media/webjobs-dotnet-deploy-vs/paw.png)
+:::image type="content" source="./media/webjobs-dotnet-deploy-vs/paw.png" alt-text="Screenshot showing how to select Publish as Azure WebJob in the Solution Explorer.":::
 
 For an independent WebJob, the same **Publish Web** wizard that is used for web projects appears, but with fewer settings available to change.
 
-### <a id="configure"></a>Add Azure WebJob dialog box
+### Add Azure WebJob dialog box
+
 The **Add Azure WebJob** dialog box lets you enter the WebJob name and the run mode setting for your WebJob. 
 
-![Add Azure WebJob dialog box](./media/webjobs-dotnet-deploy-vs/aaw2.png)
+:::image type="content" source="./media/webjobs-dotnet-deploy-vs/aaw2.png" alt-text="Screenshot of the Add Azure WebJob dialog box.":::
 
 Some of the fields in this dialog box correspond to fields on the **Add WebJob** dialog box of the Azure portal. For more information, see [Run background tasks with WebJobs in Azure App Service](webjobs-create.md).
 
 WebJob deployment information:
 
-* For information about command-line deployment, see [Enabling Command-line or Continuous Delivery of Azure WebJobs](https://azure.microsoft.com/blog/enabling-command-line-or-continuous-delivery-of-azure-webjobs/).
+- For information about command-line deployment, see [Enabling Command-line or Continuous Delivery of Azure WebJobs](https://azure.microsoft.com/blog/enabling-command-line-or-continuous-delivery-of-azure-webjobs/).
 
-* If you deploy a WebJob, and then decide you want to change the type of WebJob and redeploy, delete the *webjobs-publish-settings.json* file. Doing so causes Visual Studio to redisplay the publishing options, so you can change the type of WebJob.
+- If you deploy a WebJob, and then decide you want to change the type of WebJob and redeploy, delete the *webjobs-publish-settings.json* file. Doing so causes Visual Studio to redisplay the publishing options, so you can change the type of WebJob.
 
-* If you deploy a WebJob and later change the run mode from continuous to non-continuous or vice versa, Visual Studio creates a new WebJob in Azure when you redeploy. If you change other scheduling settings, but leave run mode the same or switch between Scheduled and On Demand, Visual Studio updates the existing job instead of creating a new one.
+- If you deploy a WebJob, and later change the run mode between *continuous* and *triggered*, Visual Studio creates a new WebJob in Azure when you redeploy. If you change other scheduling settings, but leave run mode the same or switch between Scheduled and On Demand, Visual Studio updates the existing job instead of creating a new one.
 
 ## WebJob types
 
@@ -212,7 +222,7 @@ WebJobs uses the same CRON expressions for scheduling as the timer trigger in Az
 
 #### settings.job reference
 
-The following settings are supported by WebJobs:
+WebJobs supports the following settings in the **settings.job** file:
 
 | **Setting** | **Type**  | **Description** |
 | ----------- | --------- | --------------- |
@@ -225,15 +235,15 @@ The following settings are supported by WebJobs:
 
 If you enable **Always on** in Azure, you can use Visual Studio to change the WebJob to run continuously:
 
-1. If you haven't already done so, [publish the project to Azure](#deploy-to-azure-app-service).
+1. If the project isn't published already, then [publish the project to Azure](#deploy-to-azure-app-service).
 
 1. In **Solution Explorer**, right-click the project and select **Publish**.
 
 1. In the **Settings** section, choose **Show all settings**. 
 
 1. In the **Profile settings** dialog box, choose **Continuous** for **WebJob Type**, and then choose **Save**.
 
-    ![Publish Settings dialog box for a WebJob](./media/webjobs-dotnet-deploy-vs/publish-settings.png)
+   :::image type="content" source="./media/webjobs-dotnet-deploy-vs/publish-settings.png" alt-text="Screenshot showing the Publish Settings dialog box for a WebJob.":::
 
 1. Select **Publish** in the **Publish** tab to republish the WebJob with the updated settings.
 
