Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into rs-faq

Author: halkazwini

articles/automation/troubleshoot/extension-based-hybrid-runbook-worker.md

@@ -2,7 +2,7 @@
 title: Troubleshoot extension-based Hybrid Runbook Worker issues in Azure Automation 
 description: This article tells how to troubleshoot and resolve issues that arise with Azure Automation extension-based Hybrid Runbook Workers.
 services: automation
-ms.date: 01/03/2024
+ms.date: 08/26/2024
 ms.topic: troubleshooting 
 ms.custom:
 ---
@@ -73,34 +73,6 @@ To help troubleshoot issues with extension-based Hybrid Runbook Workers:
     /home/hweautomation
     ```
 
-
-### Unable to update Az modules while using the Hybrid Worker
-
-#### Issue
-
-The Hybrid Runbook Worker jobs failed as it was unable to import Az modules.
-
-#### Resolution
-
-As a workaround, you can follow these steps:
-
-1. Navigate to the folder:
-   > [!TIP] 
-   > Replace `*` in the below path with the specific version that is installed if you know it.
-   ```
-   C:\Program Files\Microsoft Monitoring Agent\Agent\AzureAutomation\*\HybridAgent
-   ```
-
-1. Edit the file with the name `Orchestrator.Sandbox.exe.config`
-
-1. Add the following lines inside the `<assemblyBinding>` tag:
-```xml
-<dependentAssembly>
-  <assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed" culture="neutral" />
-  <bindingRedirect oldVersion="0.0.0.0-13.0.0.0" newVersion="13.0.0.0" />
-</dependentAssembly>
-```
-
 ### Scenario: Runbooks go into a suspended state on a Hybrid Runbook Worker when using a custom account on a server with User Account Control (UAC) enabled
 
 #### Issue
@@ -411,38 +383,6 @@ This error occurs when you attempt to use a Run As account in a runbook that run
 If your Hybrid Runbook Worker is an Azure VM, you can use [runbook authentication with managed identities](../automation-hrw-run-runbooks.md#runbook-auth-managed-identities) instead. This scenario simplifies authentication by allowing you to authenticate to Azure resources using the managed identity of the Azure VM instead of the Run As account. When the Hybrid Runbook Worker is an on-premises machine, you need to install the Run As account certificate on the machine. To learn how to install the certificate, see the steps to run the PowerShell runbook **Export-RunAsCertificateToHybridWorker** in [Run runbooks on a Hybrid Runbook Worker](../automation-hrw-run-runbooks.md).
 
 
-### Scenario: Set-AzStorageBlobContent fails on a Hybrid Runbook Worker 
-
-#### Issue
-
-Runbook fails when it tries to execute `Set-AzStorageBlobContent`, and you receive the following error message:
-
-`Set-AzStorageBlobContent : Failed to open file xxxxxxxxxxxxxxxx: Illegal characters in path`
-
-#### Cause
-
- This error is caused by the long file name behavior of calls to `[System.IO.Path]::GetFullPath()`, which adds UNC paths.
-
-#### Resolution
-
-As a workaround, you can create a configuration file named `OrchestratorSandbox.exe.config` with the following content:
-
-```azurecli
-<configuration>
-  <runtime>
-    <AppContextSwitchOverrides value="Switch.System.IO.UseLegacyPathHandling=false" />
-  </runtime>
-</configuration>
-```
-
-Place this file in the same folder as the executable file `OrchestratorSandbox.exe`. For example:
-> [!TIP] 
-> Replace `*` in the below path with the specific version that is installed if you know it.
-```
-%ProgramFiles%\Microsoft Monitoring Agent\Agent\AzureAutomation\*\HybridAgent
-```
-
-
 ### Scenario: Microsoft Azure VMs automatically dropped from a hybrid worker group
 
 #### Issue

articles/azure-app-configuration/concept-feature-management.md

@@ -13,7 +13,7 @@ ms.date: 02/20/2024
 
 Traditionally, shipping a new application feature requires a complete redeployment of the application itself. Testing a feature often requires multiple deployments of the application. Each deployment might change the feature or expose the feature to different customers for testing.  
 
-Feature management is a modern software-development practice that decouples feature release from code deployment and enables quick changes to feature availability on demand. It uses a technique called *feature flags* (also known as *feature toggles* and *feature switches*) to dynamically administer a feature's lifecycle.
+Feature management is a software-development practice that decouples feature release from code deployment and enables quick changes to feature availability on demand. It uses a technique called *feature flags* (also known as *feature toggles* and *feature switches*) to dynamically administer a feature's lifecycle.
 
 Feature management helps developers address the following problems:
 

articles/azure-arc/kubernetes/tutorial-use-gitops-flux2.md

@@ -420,11 +420,7 @@ The Azure portal is useful for managing GitOps configurations and the Flux exten
 Follow these steps to apply a sample Flux configuration to a cluster. As part of this process, Azure installs the `microsoft.flux` extension on the cluster, if it wasn't already installed in a previous deployment.
 
 1. Navigate to your cluster in the Azure portal.
-1. In the left pane, under **Settings**, select **GitOps**.
-1. Select **Create**.
-
-   :::image type="content" source="media/tutorial-use-gitops-flux2/portal-gitops-start.png" alt-text="Screenshot showing the GitOps Create option for a cluster in the Azure portal." lightbox="media/tutorial-use-gitops-flux2/portal-gitops-start.png":::
-
+1. From the service menu, under **Settings**, select **GitOps** > **Create**.
 1. In the **Basics** section:
 
    1. Enter a name for the configuration.
@@ -473,15 +469,13 @@ Follow these steps to apply a sample Flux configuration to a cluster. As part of
 
 #### View configurations and objects
 
-To view all of the configurations for a cluster, navigate to the cluster and select **GitOps** in the left pane.
-
-:::image type="content" source="media/tutorial-use-gitops-flux2/portal-view-configurations.png" alt-text="Screenshot showing all configurations for a cluster in the Azure portal." lightbox="media/tutorial-use-gitops-flux2/portal-view-configurations.png":::
+To view all of the configurations for a cluster, navigate to the cluster and select **GitOps** from the service menu.
 
 Select the name of a configuration to view more details such as the configuration's status, properties, and source. You can then select **Configuration objects** to view all of the objects that were created to enable the GitOps configuration. This lets you quickly see the compliance state and other details about each object.
 
 :::image type="content" source="media/tutorial-use-gitops-flux2/portal-configuration-objects.png" alt-text="Screenshots showing configuration objects and their state in the Azure portal." lightbox="media/tutorial-use-gitops-flux2/portal-configuration-objects.png":::
 
-To see other Kubernetes resources deployed on the cluster, return to the cluster overview page and select **Kubernetes resources** in the left pane.
+To see other Kubernetes resources deployed on the cluster, return to the cluster overview page and select **Kubernetes resources** from the service menu.
 
 To view detailed conditions for a configuration object, select its name.
 
@@ -707,7 +701,7 @@ az k8s-extension delete -g flux-demo-rg -c flux-demo-arc -n flux -t connectedClu
 
 #### Delete the Flux configuration
 
-To delete a Flux configuration, navigate to the cluster where the configuration was created and select **GitOps** in the left pane. Select the configuration you want to delete. From the top of the page, select **Delete**, then select **Delete** again when prompted to confirm.
+To delete a Flux configuration, navigate to the cluster where the configuration was created and select **GitOps** from the service menu. Select the configuration you want to delete. From the top of the page, select **Delete**, then select **Delete** again when prompted to confirm.
 
 When you delete a Flux configuration, all of the Flux configuration objects in the cluster are deleted. However, this action doesn't delete the `microsoft.flux` extension itself.
 

articles/azure-maps/how-to-dev-guide-csharp-sdk.md

@@ -4,7 +4,7 @@ titleSuffix: Azure Maps
 description: How to develop applications that incorporate Azure Maps using the C# SDK Developers Guide.
 author: sinnypan
 ms.author: sipa
-ms.date: 11/11/2021
+ms.date: 08/27/2024
 ms.topic: how-to
 ms.service: azure-maps
 ms.subservice: rest-sdk
@@ -139,6 +139,11 @@ var client = new MapsSearchClient(credential);
 Call the `GetGeocoding` method to get the coordinate of an address.
 
 ```csharp
+using System;
+using Azure; 
+using Azure.Maps.Search; 
+using Azure.Maps.Search.Models;
+
 // Use Azure Maps subscription key authentication 
 var subscriptionKey = Environment.GetEnvironmentVariable("SUBSCRIPTION_KEY") ?? string.Empty;
 var credential = new AzureKeyCredential(subscriptionKey);
@@ -147,19 +152,90 @@ var client = new MapsSearchClient(credential);
 Response<GeocodingResponse> searchResult = client.GetGeocoding(
     "1 Microsoft Way, Redmond, WA 98052");
 
-Console.WriteLine($"The Coordinate: ({searchResult.Value.Features[0].Geometry.Coordinates})"); 
+for (int i = 0; i < searchResult.Value.Features.Count; i++)
+{
+    Console.WriteLine("Coordinate:" + string.Join(",", searchResult.Value.Features[i].Geometry.Coordinates));
+}
+```
+
+## Batch geocode addresses
+
+This sample demonstrates how to perform batch search address.
+
+```csharp
+using System;
+using Azure; 
+using Azure.Maps.Search; 
+using System.Collections.Generic;
+using Azure.Maps.Search.Models;
+using Azure.Maps.Search.Models.Queries;
+
+// Use Azure Maps subscription key authentication 
+var subscriptionKey = Environment.GetEnvironmentVariable("SUBSCRIPTION_KEY") ?? string.Empty;
+var credential = new AzureKeyCredential(subscriptionKey);
+var client = new MapsSearchClient(credential); 
+
+List<GeocodingQuery> queries = new List<GeocodingQuery>
+{
+    new GeocodingQuery()
+    {
+        Query ="15171 NE 24th St, Redmond, WA 98052, United States"
+    },
+    new GeocodingQuery()
+    {
+        AddressLine = "400 Broad St"
+    },
+};
+Response<GeocodingBatchResponse> results = client.GetGeocodingBatch(queries);
+
+//Print coordinates
+for (var i = 0; i < results.Value.BatchItems.Count; i++)
+{
+    for (var j = 0; j < results.Value.BatchItems[i].Features.Count; j++)
+    {
+        Console.WriteLine("Coordinates: " + string.Join(",", results.Value.BatchItems[i].Features[j].Geometry.Coordinates));
+    }
+}
+```
+
+## Reverse geocode a coordinates
+
+You can translate coordinates into human-readable street addresses. This process is also called reverse geocoding. 
+
+```csharp
+using System;
+using Azure; 
+using Azure.Maps.Search; 
+using Azure.Core.GeoJson;
+using Azure.Maps.Search.Models;
+
+// Use Azure Maps subscription key authentication 
+var subscriptionKey = Environment.GetEnvironmentVariable("SUBSCRIPTION_KEY") ?? string.Empty;
+var credential = new AzureKeyCredential(subscriptionKey);
+var client = new MapsSearchClient(credential); 
+
+GeoPosition coordinates = new GeoPosition(-122.138685, 47.6305637);
+Response<GeocodingResponse> result = client.GetReverseGeocoding(coordinates);
+
+//Print addresses
+for (int i = 0; i < result.Value.Features.Count; i++)
+{
+    Console.WriteLine(result.Value.Features[i].Properties.Address.FormattedAddress);
+}
 ```
 
 ## Batch reverse geocode a set of coordinates
 
 Azure Maps Search also provides some batch query APIs. The Reverse Geocoding Batch API sends batches of queries to [Reverse Geocoding API](/rest/api/maps/search/get-reverse-geocoding) using just a single API call. The API allows caller to batch up to **100** queries.
 
 ```csharp
-using system;
-using Azure;
+using System;
+using Azure; 
+using Azure.Maps.Search; 
+using System.Collections.Generic;
 using Azure.Core.GeoJson;
-using Azure.Maps.Search;
 using Azure.Maps.Search.Models;
+using Azure.Maps.Search.Models.Queries;
 
 // Use Azure Maps subscription key authentication 
 var subscriptionKey = Environment.GetEnvironmentVariable("SUBSCRIPTION_KEY") ?? string.Empty;
@@ -170,16 +246,62 @@ List<ReverseGeocodingQuery> items = new List<ReverseGeocodingQuery>
 {
     new ReverseGeocodingQuery()
     {
-        Coordinates = new GeoPosition(-122.34255, 47.0)
+        Coordinates = new GeoPosition(-122.349309, 47.620498)
     },
     new ReverseGeocodingQuery()
     {
-        Coordinates = new GeoPosition(-122.34255, 47.0)
+        Coordinates = new GeoPosition(-122.138679, 47.630356),
+        ResultTypes = new List<ReverseGeocodingResultTypeEnum>(){ ReverseGeocodingResultTypeEnum.Address, ReverseGeocodingResultTypeEnum.Neighborhood }
     },
 };
-Response<GeocodingBatchResponse> = client.GetReverseGeocodingBatch(items);
+Response<GeocodingBatchResponse> result = client.GetReverseGeocodingBatch(items);
+//Print addresses
+for (var i = 0; i < result.Value.BatchItems.Count; i++)
+{
+    Console.WriteLine(result.Value.BatchItems[i].Features[0].Properties.Address.AddressLine);
+    Console.WriteLine(result.Value.BatchItems[i].Features[0].Properties.Address.Neighborhood);
+}
 ```
 
+## Get polygons for a given location
+
+This sample demonstrates how to search polygons.
+
+```csharp
+using System;
+using Azure; 
+using Azure.Maps.Search; 
+using Azure.Core.GeoJson;
+using Azure.Maps.Search.Models;
+using Azure.Maps.Search.Models.Options;
+
+// Use Azure Maps subscription key authentication 
+var subscriptionKey = Environment.GetEnvironmentVariable("SUBSCRIPTION_KEY") ?? string.Empty;
+var credential = new AzureKeyCredential(subscriptionKey);
+var client = new MapsSearchClient(credential);
+
+GetPolygonOptions options = new GetPolygonOptions()
+{
+    Coordinates = new GeoPosition(-122.204141, 47.61256),
+    ResultType = BoundaryResultTypeEnum.Locality,
+    Resolution = ResolutionEnum.Small,
+};
+Response<Boundary> result = client.GetPolygon(options);
+
+var count = ((GeoJsonPolygon)((GeoJsonGeometryCollection)result.Value.Geometry).Geometries[0]).Coordinates.Count;
+for (var i = 0; i < count; i++)
+{
+    var coorCount = ((GeoJsonPolygon)((GeoJsonGeometryCollection)result.Value.Geometry).Geometries[0]).Coordinates[i].Count;
+    for (var j = 0; j < coorCount; j++)
+    {
+        Console.WriteLine(string.Join(",",((GeoJsonPolygon)((GeoJsonGeometryCollection)result.Value.Geometry).Geometries[0]).Coordinates[i][j]));
+    }
+}
+```
+
+## Using V1 SDKs for Search and Render
+
+For more information on using Search v1, see [Azure Maps Search client library for .NET](https://www.nuget.org/packages/Azure.Maps.Search/1.0.0-beta.5). For more information on using Render v1, see [Azure Maps Render client library for .NET](https://www.nuget.org/packages/Azure.Maps.Rendering/1.0.0-beta.3).
 
 ## Additional information