Added mar troubleshooting section

Author: mikefrobbins

docs-conceptual/azps-14.3.0/install-azps-optimized.md

@@ -115,6 +115,11 @@ Installing the **Az** PowerShell module from the Microsoft Artifact Registry (MA
 more reliable installations. MAR ensures quick download speeds and a smooth setup process,
 minimizing potential issues during installation.
 
+> [!IMPORTANT]
+> There's a known issue when installing from MAR. For details, see the
+> [Known issues when installing from MAR](https://learn.microsoft.com/powershell/azure/troubleshooting#known-issue-installing-az-modules-from-mar-fails)
+> section of our troubleshooting guide.
+
 1. If you're using a version of PowerShell earlier than 7.5.0, you must install
    **Microsoft.PowerShell.PSResourceGet** version 1.1.0 or higher
 

docs-conceptual/azps-14.4.0/install-azps-optimized.md

@@ -115,6 +115,11 @@ Installing the **Az** PowerShell module from the Microsoft Artifact Registry (MA
 more reliable installations. MAR ensures quick download speeds and a smooth setup process,
 minimizing potential issues during installation.
 
+> [!IMPORTANT]
+> There's a known issue when installing from MAR. For details, see the
+> [Known issues when installing from MAR](https://learn.microsoft.com/powershell/azure/troubleshooting#known-issue-installing-az-modules-from-mar-fails)
+> section of our troubleshooting guide.
+
 1. If you're using a version of PowerShell earlier than 7.5.0, you must install
    **Microsoft.PowerShell.PSResourceGet** version 1.1.0 or higher
 

docs-conceptual/azps-14.4.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