From 7265bf30587eca664b26327f964625595f04d8c3 Mon Sep 17 00:00:00 2001
From: "Mike F. Robbins" <6719572+mikefrobbins@users.noreply.github.com>
Date: Fri, 29 Aug 2025 16:04:25 -0500
Subject: [PATCH] Added mar troubleshooting section

---
 docs-conceptual/azps-14.3.0/troubleshooting.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/docs-conceptual/azps-14.3.0/troubleshooting.md b/docs-conceptual/azps-14.3.0/troubleshooting.md
index 7431247518..0971d95664 100644
--- a/docs-conceptual/azps-14.3.0/troubleshooting.md
+++ b/docs-conceptual/azps-14.3.0/troubleshooting.md
@@ -26,6 +26,22 @@ To enable debug logging for an entire PowerShell session, you set the value of t
 $DebugPreference = 'Continue'
 ```
 
+## Known issue: Installing Az modules from MAR fails
+
+When installing certain Az PowerShell modules from the Microsoft Artifact Registry (MAR) using
+**PSResourceGet**, you may encounter an error such as:
+
+```Output
+Install-PSResource: Package(s) 'Az.Keyvault' could not be installed from repository 'MAR'.
+```
+
+> [!NOTE]
+> As a temporary workaround, install the module from another repository, such as the PowerShell
+> Gallery, until the issue is resolved.
+
+For more information, see
+[Bugfix for comparing file path name to determine exact match](https://github.com/PowerShell/PSResourceGet/pull/1817).
+
 ## Troubleshooting multifactor authentication (MFA)
 
 ### Interactive login failures