Add instructions for MAR

Author: sdwheeler

powershell-gallery/docs-conceptual/overview.md

@@ -11,10 +11,10 @@ PowerShell scripts, modules containing PowerShell cmdlets and Desired State Conf
 resources. Some of these packages are authored by Microsoft, and others are authored by the
 PowerShell community.
 
-The [PowerShellGet][07] module contains cmdlets for discovering, installing, updating, and publishing
-PowerShell packages from the PowerShell Gallery. These packages can contain artifacts such as
-Modules, DSC Resources, Role Capabilities, and Scripts. Make sure you have the latest version of
-**PowerShellGet** and **PackageManagement** installed.
+The [PowerShellGet][07] module contains cmdlets for discovering, installing, updating, and
+publishing PowerShell packages from the PowerShell Gallery. These packages can contain artifacts
+such as Modules, DSC Resources, Role Capabilities, and Scripts. Make sure you have the latest
+version of **PowerShellGet** and **PackageManagement** installed.
 
 The [Microsoft.PowerShell.PSResourceGet][08] module replaces the **PowerShellGet** and
 **PackageManagement** modules. **Microsoft.PowerShell.PSResourceGet** version 1.0.1 ships in

powershell-gallery/docs-conceptual/powershellget/overview.md

@@ -1,6 +1,6 @@
 ---
 description: This article explains the purpose and history of PowerShellGet
-ms.date: 10/31/2024
+ms.date: 05/22/2025
 ms.topic: overview
 title: Package management for PowerShell
 ---
@@ -27,11 +27,11 @@ packages can contain artifacts such as Modules, DSC Resources, and Scripts. The
 
 Supported versions:
 
-- Current release
-  - **Microsoft.PowerShell.PSResourceGet** 1.0.6 - a standalone module that doesn't depend on the
+- Current releases
+  - **Microsoft.PowerShell.PSResourceGet** 1.1.1 - a standalone module that doesn't depend on the
     **PowerShellGet** or **PackageManagement** modules
   - **PowerShellGet** 2.2.5 with **PackageManagement** 1.4.8.1
-- Preview release
+- Preview releases
   - **Microsoft.PowerShell.PSResourceGet** 1.1.0-rc2 - adds `Compress-PSResource` to create `.nupkg`
     files, the ability to publish `.nupkg` files, and support configuration Group Policy.
   - **PowerShellGet** 3.0.23-beta23 - a compatibility module that contains proxy cmdlets that call
@@ -42,6 +42,8 @@ Supported versions:
 
 For best results, use the latest version of the **Microsoft.PowerShell.PSResourceGet** module.
 
+- **Microsoft.PowerShell.PSResourceGet** v1.1.1 - shipped in **PowerShell 7.6-preview.4**
+- **Microsoft.PowerShell.PSResourceGet** v1.1.0 - shipped in **PowerShell 7.5.0**
 - **Microsoft.PowerShell.PSResourceGet** 1.0.6 - released to the PowerShell Gallery on 10-Oct-2024
 - **Microsoft.PowerShell.PSResourceGet** 1.0.5 - shipped in **PowerShell 7.5-preview.3**
 - **Microsoft.PowerShell.PSResourceGet** 1.0.4.1 - shipped in **PowerShell 7.4.2**

powershell-gallery/docs-conceptual/powershellget/supported-repositories.md

@@ -1,6 +1,6 @@
 ---
 description: This article lists the repositories that have been tested with PowerShellGet v3 and how to configure them.
-ms.date: 03/21/2025
+ms.date: 05/22/2025
 ms.topic: reference
 title: Supported repository configurations
 ---
@@ -124,7 +124,7 @@ You must use the **Credential** and **ApiKey** parameters of the `Publish-PSReso
 publish packages to an Azure Artifacts feed. The credential must be a personal access token (PAT)
 that has the **Packaging (read, write, and manage)** scope. For more information, see
 [Use Azure Artifacts feeds as a private PowerShell repository][04]. The value of the **ApiKey**
-parameter is not important. It can be any arbitrary string, but it must be included. For example:
+parameter isn't important. It can be any arbitrary string, but it must be included. For example:
 
 ```powershell
 $patToken = ConvertTo-SecureString -String '<personal-access-token>' -AsPlainText -Force
@@ -189,6 +189,29 @@ ACR repositories:
 - Find by DSC resource name
   - `Find-PSResource -DscResourceName ResourceName -Repository ACRDemoRepo`
 
+## Microsoft Artifact Registry (MAR)
+
+MAR is a public registry for housing Microsoft's official artifacts, such as container images. MAR
+enhances security by ensuring only Microsoft can publish official packages, eliminating risks like
+name squatting. It also improves software supply chain integrity by offering greater transparency
+and control over artifact provenance.
+
+Use the following commands to register MAR repository as a PSResource repository.
+
+```powershell
+$mcrUrl = 'https://mcr.microsoft.com'
+Register-PSResourceRepository -Name MAR -Uri $mcrUrl -ApiVersion ContainerRegistry
+```
+
+After you register the repository, you can use it like any other ACR-based repository.
+
+Support for MAR was added in **Microsoft.PowerShell.PSResourceGet** v1.1.1.
+
+### MAR limitations
+
+The MAR repository has the same limitations as ACR repositories. The MAR is read-only and doesn't
+support publishing packages.
+
 ## GitHub Packages
 
 GitHub Packages is a software package hosting service that allows you to host your software packages