Merge pull request #6176 from TylerMSFT/elevateNote

draft

Author: denrea

docs/build-insights/elevate-note.md

@@ -0,0 +1,22 @@
+---
+title: "Build Insights needs additional permissions"
+description: "To capture trace files, Build Insights needs additional permissions as described in this topic."
+ms.topic: article
+ms.date: 12/9/2025
+ms.update-cycle: 365-days
+f1_keywords: 
+  - bi_permissions
+---
+# Build Insights needs additional permissions
+
+Starting with Visual Studio 2026, Build Insights and `vcperf` need extra permissions to capture traces.
+ 
+To allow `vcperf` to capture build traces, please accept the one time, per user, elevated prompt that appears when you first attempt to capture a trace:
+
+:::image type="content" source="./media/elevation-prompt.png" alt-text="A screenshot of the elevation prompt. It says: To capture trace files, Build Insights needs additional permissions. Allow this one-time elevated request?":::
+ 
+Once you accept this elevation request, you can capture trace files with `vcperf`. You won't be prompted again to elevate permissions again. Accepting this request doesn't elevate permissions for Visual Studio--only for `vcperf` so it can to capture traces.
+
+## See also
+
+[Get started with C++ Build Insights](get-started-with-cpp-build-insights.md)