diff --git a/powershell-gallery/docs-conceptual/overview.md b/powershell-gallery/docs-conceptual/overview.md index 80925a1..d79e884 100644 --- a/powershell-gallery/docs-conceptual/overview.md +++ b/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 diff --git a/powershell-gallery/docs-conceptual/powershellget/overview.md b/powershell-gallery/docs-conceptual/powershellget/overview.md index 77ade4a..466d604 100644 --- a/powershell-gallery/docs-conceptual/powershellget/overview.md +++ b/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** diff --git a/powershell-gallery/docs-conceptual/powershellget/supported-repositories.md b/powershell-gallery/docs-conceptual/powershellget/supported-repositories.md index 1a3a087..8730b25 100644 --- a/powershell-gallery/docs-conceptual/powershellget/supported-repositories.md +++ b/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 '' -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