Merge branch 'MicrosoftDocs:main' into main-subservice

Author: genlin

support/azure/azure-kubernetes/create-upgrade-delete/error-code-outboundconnfailvmextensionerror.md

@@ -1,7 +1,7 @@
 ---
 title: Troubleshoot the OutboundConnFailVMExtensionError error code (50)
 description: Learn how to troubleshoot the OutboundConnFailVMExtensionError error (50) when you try to start or create and deploy an Azure Kubernetes Service (AKS) cluster.
-ms.date: 12/23/2024
+ms.date: 12/30/2024
 ms.reviewer: rissing, chiragpa, jaewonpark, v-leedennis, jovieir, v-weizhu
 ms.service: azure-kubernetes-service
 ms.custom: sap:Create, Upgrade, Scale and Delete operations (cluster or nodepool)
@@ -111,12 +111,13 @@ There are many reasons why the traffic might be blocked. In any of these situati
    > ```
 ## Solution
 
-The following table lists specific reasons why traffic might be blocked, and the corresponding solution for each reason.
+The following table lists specific reasons why traffic might be blocked, and the corresponding solution for each reason:
+
 | Issue | Solution |
 | ----- | -------- |
-| Traffic is blocked by firewall rules, a proxy server or Network Security Group (NSG) | This issue occurs when the AKS required ports or Fully Qualified Domain Names (FQDNs) are blocked by a firewall, proxy server, or NSG. Ensure these ports and FQDNs are allowed. To determine what's blocked, check the connectivity provided in the preceeding [Cause](#cause) section. For more information about AKS required ports and FQDNs, see [Outbound network and FQDN rules for Azure Kubernetes Service (AKS) clusters](/azure/aks/outbound-rules-control-egress).|
+| Traffic is blocked by firewall rules, a proxy server or Network Security Group (NSG) | This issue occurs when the AKS required ports or Fully Qualified Domain Names (FQDNs) are blocked by a firewall, proxy server, or NSG. Ensure these ports and FQDNs are allowed. To determine what's blocked, check the connectivity provided in the preceding [Cause](#cause) section. For more information about AKS required ports and FQDNs, see [Outbound network and FQDN rules for Azure Kubernetes Service (AKS) clusters](/azure/aks/outbound-rules-control-egress).|
 | The AAAA (IPv6) record is blocked on the firewall | On your firewall, verify that nothing exists that would block the endpoint from resolving in Azure DNS. |
-| Private cluster can't resolve internal Azure resources | In private clusters, the Azure DNS IP address (`168.63.129.16`) must be added as an upstream DNS server if custom DNS is used. Verify that the address is set on your DNS servers. For more information, see [Create a private AKS cluster](/azure/aks/private-clusters) and [What is IP address 168.63.129.16?](/azure/virtual-network/what-is-ip-address-168-63-129-16) |
+| Private cluster can't resolve internal Azure resources | In private clusters, the Azure DNS IP address (`168.63.129.16`) must be added as an upstream DNS server if custom DNS is used. Verify that the address is set on your DNS servers. For more information, see [Create a private AKS cluster](/azure/aks/private-clusters) and [What is IP address 168.63.129.16?](/azure/virtual-network/what-is-ip-address-168-63-129-16). |
 
 ## More information
 

support/azure/azure-kubernetes/error-codes/vmextensionerror-outboundconnfail.md

@@ -1,7 +1,7 @@
 ---
 title: Troubleshoot the VMExtensionError_OutboundConnFail error code
 description: Learn how to troubleshoot the VMExtensionError_OutboundConnFail error (50) when you try to start or create and deploy an Azure Kubernetes Service (AKS) cluster.
-ms.date: 01/24/2024
+ms.date: 12/30/2024
 ms.reviewer: rissing, chiragpa, v-leedennis, jovieir
 ms.service: azure-kubernetes-service
 ms.custom: sap:Create, Upgrade, Scale and Delete operations (cluster or nodepool)
@@ -115,12 +115,11 @@ There are many reasons why the traffic might be blocked. In any of these situati
 
 ## Solution
 
-The following table lists specific reasons why traffic might be blocked, and the corresponding solution for each reason.
+The following table lists specific reasons why traffic might be blocked, and the corresponding solution for each reason:
 
 | Issue | Solution |
 | ----- | -------- |
-| Traffic is blocked by firewall rules or a proxy server | In this scenario, a firewall or a proxy server does egress filtering. To verify that all required domains and ports are allowed, see [Control egress traffic for cluster nodes in Azure Kubernetes Service (AKS)](/azure/aks/limit-egress-traffic). |
-| Traffic is blocked by a cluster network security group (NSG) | On any NSGs that are attached to your cluster, verify that there's no blocking on port 443, port 53, or any other port that might have to be used to connect to the endpoint. For more information, see [Control egress traffic for cluster nodes in Azure Kubernetes Service (AKS)](/azure/aks/limit-egress-traffic). |
+| Traffic is blocked by firewall rules, a proxy server or Network Security Group (NSG) | This issue occurs when the AKS required ports or Fully Qualified Domain Names (FQDNs) are blocked by a firewall, proxy server, or NSG. Ensure these ports and FQDNs are allowed. To determine what's blocked, check the connectivity provided in the preceding [Cause](#cause) section. For more information about AKS required ports and FQDNs, see [Outbound network and FQDN rules for Azure Kubernetes Service (AKS) clusters](/azure/aks/outbound-rules-control-egress).|
 | The AAAA (IPv6) record is blocked on the firewall | On your firewall, verify that nothing exists that would block the endpoint from resolving in Azure DNS. |
 | Private cluster can't resolve internal Azure resources | In private clusters, the Azure DNS IP address (`168.63.129.16`) must be added as an upstream DNS server if custom DNS is used. Verify that the address is set on your DNS servers. For more information, see [Create a private AKS cluster](/azure/aks/private-clusters) and [What is IP address 168.63.129.16?](/azure/virtual-network/what-is-ip-address-168-63-129-16) |
 

support/developer/visualstudio/installation/installation-stops-package-10-windows-10-21h2.md

@@ -0,0 +1,36 @@
+---
+title: Visual Studio Installation Stops on Windows 10 21H2
+description: Helps resolve an error that occurs when you install Visual Studio using the online installer on a Windows 10, version 21H2 machine.
+ms.date: 12/27/2024
+ms.reviewer: khgupta
+ms.custom: sap:Installation\Setup, maintenance, or uninstall
+---
+
+# Visual Studio installation stops during package 10 on Windows 10, version 21H2
+
+## Symptoms
+
+When you install Visual Studio on a Windows 10, version 21H2 machine, it stops during the installation of package 10, and you see the following message in the event viewer for **setup.exe**:
+
+```output
+Log Name: Application
+Source: Application Hang
+Event ID: 1002
+Task Category: Hanging Events
+Level: Error
+Keywords: Classic
+User: N/A
+Description: The program setup.exe version 3.4.2246.31370 stopped interacting with Windows and was closed. To see if more information about the problem is available, check the problem history in the Security and Maintenance control panel.
+Event Xml: <Event xmlns="http://schemas.microsoft.com/win/2004/08/events/event"> <System> <Provider Name="Application Hang"/> <EventID Qualifiers="0">1002</EventID>
+```
+
+This issue can also occur if the Visual Studio Installer is corrupt or fails to launch.
+
+## Resolution
+
+To resolve the issue, follow these steps:
+
+1. Uninstall the Visual Studio Installer application.
+1. Delete the folder and its contents located at **C:\Program Files (x86)\Microsoft Visual Studio\Installer**.
+1. Go to the [Visual Studio page](https://visualstudio.microsoft.com/vs/) and download the edition that you're using.
+1. Run the Visual Studio setup as an administrator.

support/developer/visualstudio/installation/installation-vs-2022-license-key-shows-invalid.md

@@ -0,0 +1,27 @@
+---
+title: License Key Is Invalid When Installing Visual Studio
+description: Helps resolve an issue where the license key shows as invalid even though the license key is mentioned in the package when installing Visual Studio.
+ms.date: 12/27/2024
+ms.reviewer: khgupta
+ms.custom: sap:Installation\Setup, maintenance, or uninstall
+---
+
+# The license key is invalid when installing Visual Studio
+
+## Symptoms
+
+When you install Visual Studio with the parameter `--productKey` like `XXXXX-XXXXX-XXXXX-XXXXX-XXXXX`, the license key shows as invalid, and the installer repeatedly asks for the license key, even though you use the license key mentioned in the package.
+
+## Resolution
+
+According to [Use command-line parameters to install, update, and manage Visual Studio](/visualstudio/install/use-command-line-parameters-to-install-visual-studio), the `--productkey` parameter only supports 25 alphanumeric characters in the format of `XXXXXXXXXXXXXXXXXXXXXXXXX`.
+
+| Parameter      | Description                                                 |
+|-----------------|-------------------------------------------------------------|
+| `--productKey`  | **Optional**: During an install command, this parameter defines the product key to use for an installed product. It's composed of 25 alphanumeric characters in the format of `XXXXXXXXXXXXXXXXXXXXXXXXX`.|
+
+To solve the issue, remove the dashes in `XXXXX-XXXXX-XXXXX-XXXXX-XXXXX` from the parameter `--productKey`. Here's an example:
+
+```powershell
+$RetVal = Execute-Process -Path "$dirFiles\vs_Professional.exe" -Parameters "--add Microsoft.VisualStudio.Workload.Data --add Microsoft.VisualStudio.Workload.DataScience --add Microsoft.VisualStudio.Workload.ManagedDesktop --locale en-US --quiet --wait --norestart --productKey XXXXXXXXXXXXXXXXXXXXXXXXX" -PassThru
+```

support/developer/visualstudio/installation/maui-template-missing-vs-2022-professional.md

@@ -0,0 +1,29 @@
+---
+title: .NET Multi-Platform App UI Template Is Missing
+description: Helps resolve an error that occurs after you install the .NET Multi-platform App UI workload.
+ms.date: 12/27/2024
+ms.reviewer: khgupta
+ms.custom: sap:Installation\Setup, maintenance, or uninstall
+---
+
+# The .NET Multi-platform App UI template is missing in Visual Studio
+
+## Symptoms
+
+The .NET Multi-platform App UI (MAUI) template is missing in Visual Studio even after installing the .NET MAUI workload.
+
+## Cause
+
+The .NET MAUI template isn't installed.
+
+## Resolution
+
+To install the MAUI template, follow these steps:
+
+1. Open the Command Prompt.
+1. Run the command `dotnet workload install maui` to install the MAUI workload if it's not installed. This command installs the necessary components and dependencies for MAUI development.
+1. After the MAUI workload is installed, run the command `dotnet new --install Microsoft.Maui.Templates` to install the MAUI templates. This command fetches and installs the latest templates for creating MAUI projects.
+
+Once the templates are installed, you can see the .NET MAUI template available in Visual Studio when creating a new project.
+
+For more information on installing .NET MAUI workload in Visual Studio and building .NET MAUI apps, see [Installation](/dotnet/maui/get-started/installation) and [Build your first app](/dotnet/maui/get-started/first-app).

support/developer/visualstudio/installation/media/offline-installation-windows-app-sdk-extension/windows-app-sdk-extension-vs-2022-fail.png

@@ -0,0 +1,36 @@
+---
+title: Offline Installation of Windows App SDK C# Extension Fails
+description: Helps resolve an error that occurs when you install the Windows App SDK C# extension for Visual Studio offline.
+ms.date: 12/27/2024
+ms.reviewer: khgupta
+ms.custom: sap:Installation\Offline Install
+---
+# Offline installation of the Windows App SDK C# extension for Visual Studio fails
+
+_Applies to:_  Visual Studio 2022
+
+## Symptoms
+
+When you install the Windows App SDK C# extension for Visual Studio offline, it fails with the following error message:
+
+```output
+Install Failed
+The install of 'Windows App SDK C# VS2022 Templates' was not successful for all the selected products.
+For more information, click on the install log link at the bottom of the dialog.
+Windows App SDK C# VS2022 Templates
+One or more errors occurred.
+```
+
+:::image type="content" source="media/offline-installation-windows-app-sdk-extension/windows-app-sdk-extension-vs-2022-fail.png" alt-text="Screenshot of the error message when you install the Windows App SDK C# extension for Visual Studio 2022 offline.":::
+
+## Resolution
+
+To perform an offline installation of the Windows App SDK extension for Visual Studio, run the following command line:
+
+```cmd
+"C:\Program Files (x86)\Microsoft Visual Studio\Installer\resources\app\ServiceHub\Services\Microsoft.VisualStudio.Setup.Service\VSIXInstaller.exe" /noextensionpack <path to the WindowsAppSDK VSIX>
+```
+
+Replace `<path to the WindowsAppSDK VSIX>` with the actual file path of the Windows App SDK VSIX extension file. For more information, see [WinApp SDK Dev 17 Offline Install Failure](https://github.com/microsoft/WindowsAppSDK/issues/1846 ).
+
+Additionally, you can use [Create your first WinUI 3 (Windows App SDK) project](/windows/apps/winui/winui3/create-your-first-winui3-app) to test a sample WinUI 3 project using the Windows App SDK.

support/developer/visualstudio/installation/offline-installation-windows-app-sdk-extension.md

@@ -0,0 +1,40 @@
+---
+title: Python Development Workload Fails to Install in Visual Studio
+description: Helps resolve an issue where the Python development workload fails to install in Visual Studio.
+ms.date: 12/27/2024
+ms.reviewer: khgupta
+ms.custom: sap:Installation\Setup, maintenance, or uninstall
+---
+
+# The Python development workload fails to install in Visual Studio
+
+_Applies to:_  Visual Studio 2022
+
+## Symptoms
+
+The Python development workload fails to install in Visual Studio. In addition, you see the following error message:
+
+```output
+Package 'CPython39.Exe.x64,version=3.9.13, chip=x64' failed to download from 'https://go.microsoft.com/fwlink/?linkid=2222466'.
+Search URL
+https://aka.ms/VSSetupErrorReports?q=PackageId=CPython39.Exe.x64; PackageAction=DownloadPackage; ReturnCode=0x80096004
+Details
+WebClient download failed: Authenticode verification returned 0x800b0003 for path: python-3.9.13-amd64.exe.
+Bits download failed: Timeout reached for job VsBitsDownloadJob - -2114796084 whilst in state BG_JOB_STATE_CONNECTING WinInet download failed: Authenticode verification returned 0x800b0003 for path: python-3.9.13-amd64.exe.
+Impacted workloads
+Python development (Microsoft.VisualStudio.Workload.Python,version=17.5.33306.270)
+Impacted components
+Python 3 64-bit (3.9.13) (Component.CPython39.x64,version=3.9.13)
+```
+
+## Cause
+
+The Visual Studio Installer can't download the **python-3.9.13-amd64.exe** file from the URL `https://go.microsoft.com/fwlink/?linkid=2222466`.
+
+## Resolution
+
+To resolve the issue, ensure that the necessary domains and servers from which files are downloaded are added to the allowlist.
+
+By adding the necessary domain URLs to the allowlist, you enable the Visual Studio Installer to download the required files and successfully install the Python development workload. For more information on the URLs to add to the allowlist and guidance on installing Visual Studio behind a firewall or proxy server, see [Install and use Visual Studio and Azure Services behind a firewall or proxy server](/visualstudio/install/install-and-use-visual-studio-behind-a-firewall-or-proxy-server).
+
+Once you complete the allowlisting process, you can [install the Python development workload](/visualstudio/python/installing-python-support-in-visual-studio#download-and-install-the-python-workload) in Visual Studio without encountering any download failures.

support/developer/visualstudio/installation/python-development-workload-fails-install-vs-2022.md

@@ -0,0 +1,41 @@
+---
+title: Set Up Visual Studio on an Offline Machine
+description: Describes how to set up Visual Studio on an offline machine.
+ms.date: 12/27/2024
+ms.reviewer: khgupta
+ms.custom: sap:Installation\Offline Install
+ms.topic: how-to
+---
+# Set up Visual Studio on an offline machine
+
+To set up Visual Studio on an offline machine, follow these steps:
+
+1. Download the Visual Studio installer from the [Visual Studio page](https://visualstudio.microsoft.com/vs/).
+1. Create an offline installer using the following command line. In this example, **vs_professional.exe** is the Professional edition of Visual Studio, and **VS2022Offline** is the folder where you want to create the layout. 
+
+   ```cmd
+   "vs_professional.exe" --LayOut "C:\Temp\VS2022Offline" --Lang en-US"
+   ```
+   
+1. After successfully creating the offline installer for Visual Studio, copy **C:\Temp\VS2022Offline** to the target offline machine.
+1. Once the **C:\Temp\VS2022Offline** folder is copied to the target offline machine, execute the following command line from an administrator command prompt:
+
+   ```cmd
+   "C:\Temp\VS2022Offline\vs_professional.exe" --noWeb --channelURI "C:\Temp\VS2022Offline\channelManifest.json"
+   ```
+   For more information on the command-line parameters, see [Use command-line parameters to install, update, and manage Visual Studio](/visualstudio/install/use-command-line-parameters-to-install-visual-studio).
+
+1. Follow the remaining instructions in the setup wizard to complete the installation.
+1. Once the installation is completed successfully, open any browser and browse to the [Microsoft 365 admin center](https://admin.microsoft.com/adminportal/home#/subscriptions/vlnew).
+1. Sign in with your Visual Studio subscription account.
+1. Navigate to the **Downloads and Keys** tab.
+1. Search for **Visual Studio Professional 2022** and select **Key**.
+1. Select the 25-digit volume license key and copy it.
+1. Launch the Visual Studio shortcut as an administrator.
+1. On the menu bar, select **Help** > **Register Product**.
+1. Select the **Unlock with a Product Key** link.
+1. Enter the 25-digit product key, and then select **Apply**.
+
+## More information
+
+[Create an offline installation package of Visual Studio for local installation](/visualstudio/install/create-an-offline-installation-of-visual-studio)

support/developer/visualstudio/installation/set-up-vs-professional-2022-offline-machine.md

@@ -1,7 +1,11 @@
 - name: Setup, maintenance or uninstall
   items:
+  - name: .NET Multi-platform App UI template is missing
+    href: ./maui-template-missing-vs-2022-professional.md
   - name: Can't find Windows 10 developer tools
     href: ./cant-find-win-10-developer-tools-vs-2015.md
+  - name: Can't install Visual Studio using online installer
+    href: ./unable-install-vs-2022-online-installer-windows-10-21h2.md
   - name: Can't update Visual Studio using the Help menu
     href: ./unable-update-using-help-menu.md
   - name: Error - Please restart the computer and run setup again
@@ -24,8 +28,12 @@
     href: ./install-windows-sdk-silent-mode.md
   - name: Known issues when you install Release Management
     href: ./release-management-installation-issues.md
+  - name: License key is invalid when installing Visual Studio
+    href: ./installation-vs-2022-license-key-shows-invalid.md
   - name: Network or proxy errors
     href: ./troubleshoot-network-related-errors.md
+  - name: Python development workload fails to install in Visual Studio
+    href: ./python-development-workload-fails-install-vs-2022.md
   - name: Release Management component doesn't work
     href: ./other-release-management-component-no-work.md
   - name: Running Parallels on Mac may cause error 1606
@@ -42,8 +50,12 @@
     href: ./troubleshoot-installation-issues.md
   - name: Uninstall third-party applications in Visual Studio 2015
     href: ./secondary-installer-third-party-app.md
+  - name: Visual Studio installation stops on Windows 10 21H2
+    href: ./installation-stops-package-10-windows-10-21h2.md
   - name: Visual Studio 2015 and 2013 features doesn't work
     href: ./visual-studio-2015-2013-feature-not-work.md
+  - name: Visual Studio online installation fails with error 1625
+    href: ./visual-studio-2022-online-installation-fails-code-1625.md
   - name: Visual Studio requires the April 2014 update
     href: ./version-visual-studio-requires-april-2014-update.md
   - name: Visual Studio requires a newer version of Windows
@@ -62,6 +74,10 @@
     href: ./error-no-internet-connection.md 
   - name: Error when testing or deploying a minimal layout
     href: ./error-test-deploy-minimal-layout.md
+  - name: Offline installation of Windows App SDK C# extension fails
+    href: ./offline-installation-windows-app-sdk-extension.md
+  - name: Set up Visual Studio on an offline machine
+    href: ./set-up-vs-professional-2022-offline-machine.md
   - name: Warnings about an untrusted certificate
     href: ./warnings-untrusted-certificate.md
   - name: We recommend you close Visual Studio now before setup continues