Merge pull request #7022 from ghogen/connected-services

Connected services for VS 2019 16.7

Author: megvanhuygen

docs/azure/azure-app-insights-add-connected-service.md

@@ -0,0 +1,84 @@
+---
+title: Add Azure Application Insights by using Connected Services | Microsoft Docs
+description: Add Azure Application Insights to your app by using the Visual Studio to add a connected service
+author: AngelosP
+manager: jillfra
+ms.custom: vs-azure
+ms.workload: azure-vs
+ms.topic: conceptual
+ms.date: 08/17/2020
+ms.author: angelpe
+monikerRange: ">= vs-2019"
+---
+# Add Azure Application Insights by using Visual Studio Connected Services
+
+With Visual Studio, you can connect any of the following to Azure Application Insights by using the **Connected Services** feature:
+
+- .NET Framework console app
+- ASP.NET MVC (.NET Framework) 
+- ASP.NET Core
+- .NET Core (including console app, WPF, Windows Forms, class library)
+- .NET Core Worker Role
+- Azure Functions
+- Universal Windows Platform App
+- Xamarin
+- Cordova
+
+The connected service functionality adds all the needed references and connection code to your project, and modifies your configuration files appropriately.
+
+> [!NOTE]
+> This topic applies to Visual Studio on Windows. For Visual Studio for Mac, see [Connected services in Visual Studio for Mac](/visualstudio/mac/connected-services).
+## Prerequisites
+
+- Visual Studio with the Azure workload installed.
+- A project of one of the supported types
+
+## Connect to Azure Application Insights using Connected Services
+
+1. Open your project in Visual Studio.
+
+1. In **Solution Explorer**, right-click the **Connected Services** node, and, from the context menu, select **Add Connected Service**.
+
+1. In the **Connected Services** tab, select the + icon for **Service Dependencies**.
+
+    ![Add Service Dependency](./media/vs-azure-tools-connected-services-storage/vs-2019/connected-services-tab.png)
+
+1. In the **Add Dependency** page, select **Azure Application Insights**.
+
+    ![Add Azure Application Insights](./media/azure-app-insights-add-connected-service/azure-app-insights.png)
+
+    If you aren't signed in already, sign into your Azure account. If you don't have an Azure account, you can sign up for a [free trial](https://azure.microsoft.com/account/free).
+
+1. In the **Configure Azure Application Insights** screen, select an existing Azure Application Insights component, and select **Next**.
+
+    If you need to create a new component, go to the next step. Otherwise, skip to step 7.
+
+    ![Connect to existing Application Insights component](./media/azure-app-insights-add-connected-service/created-app-insights.png)
+
+1. To create an Application Insights component:
+
+   1. Select **Create a new Application Insights component** at the bottom of the screen.
+
+   1. Fill out the **Application Insights: Create new** screen, and select **Create**.
+
+       ![New Azure App Insights component](./media/azure-app-insights-add-connected-service/create-new-app-insights.png)
+
+   1. When the **Configure Azure Application Insights** screen is displayed, the new component appears in the list. Select the new component in the list, and select **Next**.
+
+1. Enter an instrumentation key name, or choose the default, and choose whether you want the connection string stored in a local secrets file, or in [Azure Key Vault](/azure/key-vault).
+
+   ![Specify connection string](./media/azure-app-insights-add-connected-service/connection-string.png)
+
+1. The **Summary of changes** screen shows all the modifications that will be made to your project if you complete the process. If the changes look OK, choose **Finish**.
+
+   ![Summary of changes](./media/azure-app-insights-add-connected-service/summary-of-changes.png)
+
+1. The connection appears under the **Service Dependencies** section of the **Connected Services** tab.
+
+   ![Service dependencies](./media/azure-app-insights-add-connected-service/service-dependencies-after.png)
+
+## See also
+
+- [Azure Monitor product page](https://azure.microsoft.com/services/monitor/)
+- [Azure App Insights documentation](/azure/azure-monitor/app/app-insights-overview/)
+- [Connected services (Visual Studio for Mac)](/visualstudio/mac/connected-services)

docs/azure/azure-cache-for-redis-add-connected-service.md

@@ -0,0 +1,84 @@
+---
+title: Add Azure Cache for Redis by using Connected Services | Microsoft Docs
+description: Add Azure Cache for Redis support to your app by using the Visual Studio to add a connected service
+author: AngelosP
+manager: jillfra
+ms.custom: vs-azure
+ms.workload: azure-vs
+ms.topic: conceptual
+ms.date: 08/17/2020
+ms.author: angelpe
+monikerRange: ">= vs-2019"
+---
+# Add Azure Cache for Redis by using Visual Studio Connected Services
+
+With Visual Studio, you can connect any of the following to Azure Cache for Redis by using the **Connected Services** feature:
+
+- .NET Framework console app
+- ASP.NET MVC (.NET Framework) 
+- ASP.NET Core
+- .NET Core (including console app, WPF, Windows Forms, class library)
+- .NET Core Worker Role
+- Azure Functions
+- Universal Windows Platform App
+- Xamarin
+- Cordova
+
+The connected service functionality adds all the needed references and connection code to your project, and modifies your configuration files appropriately.
+
+> [!NOTE]
+> This topic applies to Visual Studio on Windows. For Visual Studio for Mac, see [Connected services in Visual Studio for Mac](/visualstudio/mac/connected-services).
+## Prerequisites
+
+- Visual Studio with the Azure workload installed.
+- A project of one of the supported types
+
+## Connect to Azure Cache for Redis using Connected Services
+
+1. Open your project in Visual Studio.
+
+1. In **Solution Explorer**, right-click the **Connected Services** node, and, from the context menu, select **Add Connected Service**.
+
+1. In the **Connected Services** tab, select the + icon for **Service Dependencies**.
+
+    ![Add Service Dependency](./media/vs-azure-tools-connected-services-storage/vs-2019/connected-services-tab.png)
+
+1. In the **Add Dependency** page, select **Azure Cache for Redis**.
+
+    ![Add Azure Cache for Redis](./media/azure-redis-cache-add-connected-service/azure-redis-cache.png)
+
+    If you aren't signed in already, sign into your Azure account. If you don't have an Azure account, you can sign up for a [free trial](https://azure.microsoft.com/account/free).
+
+1. In the **Configure Azure Cache for Redis** screen, select an existing Azure Cache for Redis, and select **Next**.
+
+    If you need to create a new component, go to the next step. Otherwise, skip to step 7.
+
+    ![Connect to existing Azure Cache for Redis](./media/azure-redis-cache-add-connected-service/created-azure-redis-cache.png)
+
+1. To create an Azure Redis Cache:
+
+   1. Select **Create a new Azure Redis Cache** at the bottom of the screen.
+
+   1. Fill out the **Azure Cache for Redis: Create new** screen, and select **Create**.
+
+       ![New Azure Cache for Redis](./media/azure-redis-cache-add-connected-service/create-new-azure-redis-cache.png)
+
+   1. When the **Configure Azure Cache for Redis** screen is displayed, the new cache appears in the list. Select the new database in the list, and select **Next**.
+
+1. Enter a connection string name, or choose the default, and choose whether you want the connection string stored in a local secrets file, or in [Azure Key Vault](/azure/key-vault).
+
+   ![Specify connection string](./media/azure-redis-cache-add-connected-service/connection-string.png)
+
+1. The **Summary of changes** screen shows all the modifications that will be made to your project if you complete the process. If the changes look OK, choose **Finish**.
+
+   ![Summary of changes](./media/azure-redis-cache-add-connected-service/summary-of-changes.png)
+
+1. The connection appears under the **Service Dependencies** section of the **Connected Services** tab.
+
+   ![Service dependencies](./media/azure-redis-cache-add-connected-service/service-dependencies-after.png)
+
+## See also
+
+- [Azure Cache for Redis product page](https://azure.microsoft.com/services/cache)
+- [Azure Cache for Redis documentation](/azure/azure-cache-for-redis/)
+- [Connected services (Visual Studio for Mac)](/visualstudio/mac/connected-services)

docs/azure/azure-cosmosdb-add-connected-service.md

@@ -0,0 +1,84 @@
+---
+title: Add Azure CosmosDB by using Connected Services | Microsoft Docs
+description: Add Azure CosmosDB support to your app by using the Visual Studio to add a connected service
+author: AngelosP
+manager: jillfra
+ms.custom: vs-azure
+ms.workload: azure-vs
+ms.topic: conceptual
+ms.date: 08/17/2020
+ms.author: angelpe
+monikerRange: ">= vs-2019"
+---
+# Add Azure Cosmos DB to your app by using Visual Studio Connected Services
+
+With Visual Studio, you can connect any of the following to Azure Cosmos DB by using the **Connected Services** feature:
+
+- .NET Framework console app
+- ASP.NET MVC (.NET Framework) 
+- ASP.NET Core
+- .NET Core (including console app, WPF, Windows Forms, class library)
+- .NET Core Worker Role
+- Azure Functions
+- Universal Windows Platform App
+- Xamarin
+- Cordova
+
+The connected service functionality adds all the needed references and connection code to your project, and modifies your configuration files appropriately.
+
+> [!NOTE]
+> This topic applies to Visual Studio on Windows. For Visual Studio for Mac, see [Connected services in Visual Studio for Mac](/visualstudio/mac/connected-services).
+## Prerequisites
+
+- Visual Studio with the Azure workload installed.
+- A project of one of the supported types
+
+## Connect to Azure Cosmos DB using Connected Services
+
+1. Open your project in Visual Studio.
+
+1. In **Solution Explorer**, right-click the **Connected Services** node, and, from the context menu, select **Add Connected Service**.
+
+1. In the **Connected Services** tab, select the + icon for **Service Dependencies**.
+
+    ![Add Service Dependency](./media/vs-azure-tools-connected-services-storage/vs-2019/connected-services-tab.png)
+
+1. In the **Add Dependency** page, select **Azure Cosmos DB**.
+
+    ![Add Azure Cosmos DB](./media/azure-cosmosdb-add-connected-service/azure-cosmosdb.png)
+
+    If you aren't signed in already, sign into your Azure account. If you don't have an Azure account, you can sign up for a [free trial](https://azure.microsoft.com/account/free).
+
+1. In the **Azure Cosmos DB** screen, select an existing Azure Cosmos DB, and select **Next**.
+
+    If you need to create a database, go to the next step. Otherwise, skip to step 7.
+
+    ![Add existing Cosmos DB to project](./media/azure-cosmosdb-add-connected-service/created-cosmosdb.png)
+
+1. To create an Azure Cosmos DB:
+
+   1. Select **Create a new Azure Cosmos DB** at the bottom of the screen.
+
+   1. Fill out the **Azure Cosmos DB: Create new** screen, and select **Create**.
+
+       ![New Azure Cosmos DB](./media/azure-cosmosdb-add-connected-service/create-new-cosmosdb.png)
+
+   1. When the **Configure Azure Cosmos DB** dialog is displayed, the new database appears in the list. Select the new database in the list, and select **Next**.
+
+1. Enter a connection string name, and choose whether you want the connection string stored in a local secrets file, or in [Azure Key Vault](/azure/key-vault).
+
+   ![Specify connection string](./media/azure-cosmosdb-add-connected-service/connection-string.png)
+
+1. The **Summary of changes** screen shows all the modifications that will be made to your project if you complete the process. If the changes look OK, choose **Finish**.
+
+   ![Summary of changes](./media/azure-cosmosdb-add-connected-service/summary-of-changes.png)
+
+1. The connection appears under the **Service Dependencies** section of the **Connected Services** tab.
+
+   ![Service dependencies](./media/azure-cosmosdb-add-connected-service/service-dependencies-after.png)
+
+## See also
+
+- [Azure Cosmos DB product page](https://azure.microsoft.com/services/cosmos-db/)
+- [Azure Cosmos DB documentation](/azure/cosmos-db/)
+- [Connected services (Visual Studio for Mac)](/visualstudio/mac/connected-services)

docs/azure/azure-signalr-add-connected-service.md

@@ -0,0 +1,84 @@
+---
+title: Add Azure SignalR by using Connected Services | Microsoft Docs
+description: Add Azure SignalR to your app by using the Visual Studio to add a connected service
+author: AngelosP
+manager: jillfra
+ms.custom: vs-azure
+ms.workload: azure-vs
+ms.topic: conceptual
+ms.date: 08/17/2020
+ms.author: angelpe
+monikerRange: ">= vs-2019"
+---
+# Add Azure SignalR by using Visual Studio Connected Services
+
+With Visual Studio, you can connect any of the following to Azure SignalR service by using the **Connected Services** feature:
+
+- .NET Framework console app
+- ASP.NET MVC (.NET Framework) 
+- ASP.NET Core
+- .NET Core (including console app, WPF, Windows Forms, class library)
+- .NET Core Worker Role
+- Azure Functions
+- Universal Windows Platform App
+- Xamarin
+- Cordova
+
+The connected service functionality adds all the needed references and connection code to your project, and modifies your configuration files appropriately.
+
+> [!NOTE]
+> This topic applies to Visual Studio on Windows. For Visual Studio for Mac, see [Connected services in Visual Studio for Mac](/visualstudio/mac/connected-services).
+## Prerequisites
+
+- Visual Studio with the Azure workload installed.
+- A project of one of the supported types
+
+## Connect to Azure SignalR using Connected Services
+
+1. Open your project in Visual Studio.
+
+1. In **Solution Explorer**, right-click the **Connected Services** node, and, from the context menu, select **Add Connected Service**.
+
+1. In the **Connected Services** tab, select the + icon for **Service Dependencies**.
+
+    ![Add Service Dependency](./media/vs-azure-tools-connected-services-storage/vs-2019/connected-services-tab.png)
+
+1. In the **Add Dependency** page, select **Azure SignalR Service**.
+
+    ![Add Azure SignalR Service](./media/azure-signalr-add-connected-service/add-signalr-service.png)
+
+    If you aren't signed in already, sign into your Azure account. If you don't have an Azure account, you can sign up for a [free trial](https://azure.microsoft.com/account/free).
+
+1. In the **Configure Azure SignalR** screen, select an existing Azure SignalR component, and select **Next**.
+
+    If you need to create a new component, go to the next step. Otherwise, skip to step 7.
+
+    ![Connect to existing Azure SignalR component](./media/azure-signalr-add-connected-service/created-signalr.png)
+
+1. To create an Azure SignalR service instance:
+
+   1. Select **Create a new Azure SignalR Service instance** at the bottom of the screen.
+
+   1. Fill out the **Azure SignalR Service: Create new** screen, and select **Create**.
+
+       ![New Azure SignalR Service instance](./media/azure-signalr-add-connected-service/create-new-signalr.png)
+
+   1. When the **Configure Azure SignalR Service** screen is displayed, the new instance appears in the list. Select the new instance in the list, and select **Next**.
+
+1. Enter a connection string name, or choose the default, and choose whether you want the connection string stored in a local secrets file, or in [Azure Key Vault](/azure/key-vault).
+
+   ![Specify connection string](./media/azure-signalr-add-connected-service/connection-string.png)
+
+1. The **Summary of changes** screen shows all the modifications that will be made to your project if you complete the process. If the changes look OK, choose **Finish**.
+
+   ![Summary of changes](./media/azure-signalr-add-connected-service/summary-of-changes.png)
+
+1. The connection appears under the **Service Dependencies** section of the **Connected Services** tab.
+
+   ![Service dependencies](./media/azure-signalr-add-connected-service/service-dependencies-after.png)
+
+## See also
+
+- [Azure SignalR product page](https://azure.microsoft.com/services/signalr-service/)
+- [Azure SignalR Service documentation](/azure/azure-signalr)
+- [Connected services (Visual Studio for Mac)](/visualstudio/mac/connected-services)