Merge pull request #10443 from MicrosoftDocs/main638645511338846258sync_temp

For protected branch, push strategy should use PR and merge to target branch method to work around git push error

Author: learn-build-service-prod[bot]

docs/debugger/media/vs-2022/dbg-options-symbols.png

@@ -87,8 +87,8 @@ The debugger searches for symbol files in the following locations:
 
      **Third-party symbol servers**: Third-party providers of Windows applications and libraries can provide access to symbol server on the internet.
 
-     > [!WARNING]
-     > If you use a symbol server other than the public Microsoft Symbol Servers, make sure that the symbol server and its path are trustworthy. Because symbol files can contain arbitrary executable code, you can be exposed to security threats.
+  > [!WARNING]
+  > If you use a symbol server other than the public Microsoft Symbol Servers, make sure that the symbol server and its path are trustworthy. Because symbol files can contain arbitrary executable code, you can be exposed to security threats.
 
 ## Configure location of symbol files and loading options
 
@@ -103,6 +103,11 @@ On the **Tools** > **Options** > **Debugging** > **Symbols** page, you can:
 
 **To specify symbol locations and loading options:**
 
+::: moniker range="= vs-2022"
+  > [!NOTE]
+  > These options were updated in Visual Studio 2022 Version 17.12 Preview 1.
+::: moniker-end
+
 1. In Visual Studio, open **Tools** > **Options** > **Debugging** > **Symbols** (or **Debug** > **Options** > **Symbols**).
 
 2. Under **Symbol file (.pdb) locations**,
@@ -112,15 +117,15 @@ On the **Tools** > **Options** > **Debugging** > **Symbols** page, you can:
      1. Select the **+** symbol in the toolbar.
      1. Type the URL (http), network share, or local path of the symbol server or symbol location in the text field. Statement completion helps you find the correct format.
 
-     ::: moniker range=">= vs-2022"
+    ::: moniker range=">= vs-2022"
      ![Tools - Options - Debugging - Symbols page](media/vs-2022/dbg-options-symbols.png "Tools - Options - Debugging - Symbols page")
-     ::: moniker-end
-     ::: moniker range="<= vs-2019"
+    ::: moniker-end
+    ::: moniker range="<= vs-2019"
      ![Tools &#45; Options &#45; Debugging &#45; Symbols page](media/dbg-options-symbols.gif "Tools &#45; Options &#45; Debugging &#45; Symbols page")
-     ::: moniker-end
+    ::: moniker-end
 
-     >[!NOTE]
-     >Only the specified folder is searched. You must add entries for any subfolders that you want to search.
+   > [!NOTE]
+   > Only the specified folder is searched. You must add entries for any subfolders that you want to search.
 
    - To add a new Azure DevOps Symbol Server location:
 
@@ -135,20 +140,79 @@ On the **Tools** > **Options** > **Debugging** > **Symbols** page, you can:
 
 3. (Optional) To improve symbol loading performance, under **Cache symbols in this directory**, type a local folder path that symbol servers can copy symbols to.
 
-   > [!NOTE]
-   > Do not place the local symbol cache in a protected folder, like C:\Windows or a subfolder. Use a read-write folder instead.
+  > [!NOTE]
+  > Do not place the local symbol cache in a protected folder, like C:\Windows or a subfolder. Use a read-write folder instead.
 
-   > [!NOTE]
-   > For C++ projects, if you have the `_NT_SYMBOL_PATH` environment variable set, it will override the value set under **Cache symbols in this directory**.
+  > [!NOTE]
+  > If you have the `_NT_SYMBOL_PATH` environment variable set, it overrides the value set under **Cache symbols in this directory**.
 
 4. Specify the modules that you want the debugger to load from the **Symbol file (.pdb) locations** when it starts.
 
+   ::: moniker range=">= vs-2022"
+
+   - Select **Automatically choose what module symbols to search for** (recommended) to allow
+   Visual studio to decide what symbols to search for and load. By default, Visual Studio
+   automatically loads symbols that were built by your opened solution, and loads any
+   additional symbols that are needed to perform common debugging operations. This reduces
+   the number of files that must be searched for and loaded by Visual Studio, which 
+   improves debugger performance. You can force additional symbols to load by clicking the
+   **Specify module filters** link.
+
+   - Select **Search for all module symbols unless excluded** to force Visual Studio to
+   load all symbols in your debugged process. This is not recommended because it may
+   slow down your debugging experience. If you select this option, you can force
+   Visual Studio to ignore certain symbols by clicking the **Specify module filters**
+   link.
+
+   ::: moniker-end
+   ::: moniker range="<= vs-2019"
+
    - Select **Load all modules, unless excluded** (the default) to load all the symbols for all modules in the symbol file location, except modules you specifically exclude. To exclude certain modules, select **Specify excluded modules**, select the **+** icon, type the names of the modules to exclude, and select **OK**.
 
    - To load only modules you specify from the symbol file locations, select **Load only specified modules**. Select **Specify included modules**, select the **+** icon, type the names of the modules to include, and then select **OK**. The symbol files for other modules are not loaded.
+   ::: moniker-end
 
 5. Select **OK**.
 
+::: moniker range=">= vs-2022"
+
+### Specify module filters
+Both the **Automatically choose what module symbols to search for** and **Search for all
+module symbols unless excluded** options allow you to have more fine control over what symbols
+are searched for while debugging. Choose **Specify module filters** to fine-tune your experience.
+
+By default, you see the following dialog when **Automatically choose what module symbols to search for** is selected:
+
+![Screenshot of specifying module filters.](media/vs-2022/specify-include-list.png)
+
+You can add a module to the filter by using the '+' icon. Module filters support simple wild-card
+matching. A '\*' matches any group of characters. For example '\*myproduct\*' will match files such
+as 'myproduct.utilities.dll' and 'entrypoint.myproduct.exe', among others.
+
+There are several additional options to further customize your experience:
+
+- **Always load symbols located next to modules** instructs visual studio to load pdb files that
+are stored in the file system beside their corresponding .dll or .exe files. This can be helpful,
+for example, when attempting to debug a deployed web app.
+
+- **Automatically load additional symbols when needed** instructs Visual Studio to search for
+symbols to perform common debug actions, such as stepping, even if the module that you will be
+stepping to is not in your project or in the modules filter. The way that searching is determined
+might be affected by your [Just My Code](just-my-code.md) settings.
+
+If you have selected **Search for all module symbols unless excluded**, then the module filter
+dialog looks like this:
+
+![Screenshot of specifying excluded modules.](media/vs-2022/specify-exclude-list.png)
+
+In this dialog, you can choose what modules you *do not* want Visual Studio to load symbols for.
+In this scenario, Visual Studio attempts to load symbols for every module in your debugged
+proces (including modules by third parties), unless you add a matching filter to exclude them.
+The only other way that this behavior will be modified is by your [Just My Code](just-my-code.md)
+settings.
+
+::: moniker-end
+
 ## Other symbol options for debugging
 
 You can select additional symbol options in **Tools** > **Options** > **Debugging** > **General** (or **Debug** > **Options** > **General**):
@@ -169,10 +233,10 @@ You can select additional symbol options in **Tools** > **Options** > **Debuggin
 
   You can limit the commands that *srcsrv.dll* can execute from the app's *.pdb* file by listing the allowed commands in a file named *srcsrv.ini*. Place the *srcsrv.ini* file in the same folder as *srcsrv.dll* and *devenv.exe*.
 
-  >[!IMPORTANT]
-  >Arbitrary commands can be embedded in an app's *.pdb* file, so make sure to put only the commands you want to execute into a *srcsrv.ini* file. Any attempt to execute a command not in the *srcsvr.ini* file will cause a confirmation dialog box to appear. For more information, see [Security Warning: Debugger Must Execute Untrusted Command](../debugger/security-warning-debugger-must-execute-untrusted-command.md).
+  > [!IMPORTANT]
+  > Arbitrary commands can be embedded in an app's *.pdb* file, so make sure to put only the commands you want to execute into a *srcsrv.ini* file. Any attempt to execute a command not in the *srcsvr.ini* file will cause a confirmation dialog box to appear. For more information, see [Security Warning: Debugger Must Execute Untrusted Command](../debugger/security-warning-debugger-must-execute-untrusted-command.md).
   >
-  >No validation is done on command parameters, so be careful with trusted commands. For example, if you listed *cmd.exe* in your *srcsrv.ini*, a malicious user might specify parameters on *cmd.exe* that would make it dangerous.
+  > No validation is performed on command parameters, so be careful with trusted commands. For example, if you listed *cmd.exe* in your *srcsrv.ini*, a malicious user might specify parameters on *cmd.exe* that would make it dangerous.
 
   Select this item and the child items you want. **Allow source server for partial trust assemblies (Managed only)** and **Always run untrusted source server commands without prompting** can increase the security risks.
 

docs/debugger/media/vs-2022/specify-exclude-list.png

@@ -94,6 +94,9 @@
     "externalReference": [],
     "globalMetadata": {
       "feedback_system": "Standard",
+      "feedback_help_link_url": "https://developercommunity.microsoft.com/VisualStudio",
+      "feedback_help_link_type": "ask-the-community",      
+      "feedback_product_url": "https://developercommunity.visualstudio.com/VisualStudio/suggest",
       "breadcrumb_path": "/visualstudio/_breadcrumb/toc.json",
       "manager": "jmartens",
       "audience": "developer",

docs/debugger/media/vs-2022/specify-include-list.png

@@ -3,22 +3,22 @@ title: Personal emails for Visual Studio subscriptions in VLSC
 author: joseb-rdc
 ms.author: amast
 manager: shve
-ms.date: 09/16/2024
+ms.date: 10/11/2024
 ms.topic: conceptual
-description:  Visual Studio Subscriptions – Why Am I Seeing Hotmail or Gmail Addresses for My Subscribers?
+description:  Visual Studio Subscriptions – Why do I see personal accounts for my subscribers?
 ---
 
-# Visual Studio subscriptions – Why do I see personal accounts for my subscribers?
+# Why do I see personal accounts for my subscribers?
 
-After companies migrated from the Volume Licensing Service Center (VLSC) to the new Visual Studio [Subscriptions Admin Portal](https://manage.visualstudio.com), admins were surprised to find that the “Sign-in Email Address” for some subscribers shows a personal email address like Hotmail or Outlook. 
+After companies migrated from the Volume Licensing Service Center (VLSC) to the new Visual Studio [Subscriptions Admin Portal](https://manage.visualstudio.com), admins were surprised to find that the "Sign-in Email Address" for some subscribers shows a personal email address like Hotmail or Outlook. 
 
 ## Cause
 
-This scenario occurs due to sign-in processes that were associated with the legacy MSDN subscriber experience. Users were migrated from the Volume License Service Center (VLSC) to the Visual Studio Subscriptions Admin Portal without modifications. Admins might not know that users are using personal accounts to access their subscription benefits. Before the Visual Studio subscriber migrations, which were completed in 2016, there were two actions required to successfully use a Visual Studio Subscription:
-1. The admin “assigned” the subscription to an individual subscriber, using their work or school email address.
-2. The subscriber “activated” the subscription.
+This scenario occurs due to sign-in processes that were associated with the legacy Microsoft Developer Network (MSDN) subscriber experience. Users were migrated from the Volume License Service Center (VLSC) to the Visual Studio Subscriptions Admin Portal without modifications. Admins might not know that users are using personal accounts to access their subscription benefits. Before the Visual Studio subscriber migrations, which were completed in 2016, there were two actions required to successfully use a Visual Studio Subscription:
+1. The admin "assigned" the subscription to an individual subscriber, using their work or school email address.
+2. The subscriber "activated" the subscription.
 
-During the subscriber activation process, a Microsoft Account (MSA) was required to sign-in. If the subscriber didn’t attempt to make their work or school account (example: `[email protected]`) an MSA, they could create a new MSA or use an existing one. Use of a personal email resulted in their “Sign-in Email Address” being different than their “Assigned to Email Address."
+During the subscriber activation process, a Microsoft Account (MSA) was required to sign-in. If the subscriber didn’t attempt to make their work or school account (example: '[email protected]') an MSA, they could create a new MSA or use an existing one. Use of a personal email resulted in their "Sign-in Email Address" being different than their "Assigned to Email Address."
 
 > [!NOTE]
 > The modern subscriber experience on [https://my.visualstudio.com](https://my.visualstudio.com?wt.mc_id=o~msft~docs) supports both Work/School and Microsoft Account (MSA) identity types.
@@ -41,12 +41,29 @@ You can also use the **Search Directory** to correct the errors or fill in missi
 
 Next select on **Continue** which takes you to a list of the changes to take place. If you agree, select **Save** and the changes are made. Your subscriber will also get a message informing them of the change the next time they sign in to their subscription. Notice that only the two subscribers that were matched in the Microsoft Entra ID appear in this list. In our example, since Frederick didn't have a corresponding address in the Microsoft Entra ID, the Microsoft account (MSA) wasn't matched to a work account. 
 
+**What happens when I update a Visual Studio subscriber's sign-in address?**
+
 > [!NOTE]
-> When you edit the sign in email address this only updates the email used by the subscriber to sign in to their subscription on https://my.visualstudio.com. If the subscriber has already activated benefits such as Azure or Pluralsight using the other email address, they will need to continue to use those email addresses to access them. For any new benefits that they access, they should use the new email address. 
+> When you edit the sign in email address this updates the email used by the subscriber to sign in to their subscription on https://my.visualstudio.com. Subscribers can use the newly updated email address going forward when activating benefits. For previously activated benefits, continue reading below for more information about which email address a subscriber should use.
+
+## Impact on Benefits
+
+If you, the admin, changed the sign-in email address on a subscription, subscribers should use this new email address for any new benefit activations. Refer to the chart below for insights on any currently active benefits that might be impacted.
+
+| Benefit Name | Use updated email address? | If subscriber hasn't activated the benefit yet | If subscriber activated with the previous sign-in email address | If the subscriber is using an alternate email address |
+|--------------|----------------------------|-------------------------------------------------|-----------------------------------------------------------------|------------------------------------------------------|
+| **Power BI Pro**<br>**Microsoft 365 apps for Enterprise**<br>**PARASOFT Virtualize/SOAtest Professional Desktop**<br>**WhiteSource Bolt**<br>**DataCamp - 3-month subscription**<br>**CODE Magazine** | No  | Use new sign-in email address to activate. | Continue using the old email address for access. | N/A |
+| **Pluralsight**<br>**LinkedIn Learning**<br>**Dometrain**<br>**DevForge** | No | Access can be created using any email address. Once it's created, it will not change even if an admin updates the subscriber's sign in email. | Access can be created using any email address. Once it's created, it will not change even if an admin updates the subscriber's sign in email. | Access can be created using any email address. Once it's created, it will not change even if an admin updates the subscriber's sign in email. |
+| **Visual Studio LIVE! Events discount** | No | No email address is needed. | No email address is needed. | No email address is needed. |
+| **GitHub Enterprise** | No\* | This benefit is set up by the GitHub admin in your org. Subscribers should use the email address where their invitation was sent. | This benefit is set up by the GitHub admin in your org. Subscribers should use the email address where their invitation was sent. | This benefit is set up by the GitHub admin in your org. Subscribers should use the email address where their invitation was sent. |
+| **Visual Studio IDE**<br>**Azure DevOps**<br>**Azure dev/test monthly credit**<br>**Azure Dev/Test PAYG subscription (Unlimited)** | Yes | Use new sign-in email address to activate. | Use the new sign-in email address to continue accessing. | Continue using alternate email address. |
+| **TFS License**<br>**TFS CAL**<br>**Visual Studio App Center**<br>**Windows Developer Account**<br>**Microsoft 365 Developer**<br>**Microsoft R Server**<br>**Most Microsoft Server trials**<br>**Microsoft Office Pro Plus 2021, Project, Visio**<br>**Windows, Windows Server, Windows Embedded, SQL Server**<br>**SharePoint, Exchange, Dynamics & other MS**<br>**Technical Support**<br>**Developer Community Forums**<br>**Azure Community Forum**<br>**Online Concierge Chat**<br>**Code Search (included as Basic license)**<br>**Exploratory Testing (included in Basic license)**<br>**Azure Artifacts**<br>**C# Dev Kit for VS Code**<br>**Azure Test Plans** | Yes  | Use new sign-in email address to activate. | Use the new sign-in email address to continue accessing. | N/A |
+
+\* *Note: This benefit is set up by the GitHub Admin. To determine the email address to use, get in touch with the GitHub Admin.* 
 
 ## Support resources
 
-For assistance with administration of Visual Studio Subscriptions, contact [Visual Studio subscriptions support](https://aka.ms/vsadminhelp).
+For assistance with the administration of Visual Studio Subscriptions, contact [Visual Studio subscriptions support](https://aka.ms/vsadminhelp).
 
 ## See also