MicrosoftDocs · sdwheeler · Sep 16, 2024 · Sep 16, 2024
@@ -0,0 +1,101 @@
+---
+description: This article contains release notes for the PSResourceGet module.
+ms.date: 01/31/2024
+ms.topic: release-notes
+title: What's new in PSResourceGet?
+---
+# What's new in PSResourceGet?
+
+This is a summary of changes to the **Microsoft.PowerShell.PSResourceGet** module. For a more
+complete list of changes, see the [CHANGELOG][01] in the GitHub repository.
+
+- Current preview: **Microsoft.PowerShell.PSResourceGet** v1.1.0-preview2
+- Current stable release: **Microsoft.PowerShell.PSResourceGet** v1.0.5
+
+## Release history
+
+- v1.1.0-preview2 - Current preview release - released to the PowerShell Gallery only
+- v1.1.0-preview.1 - Preview release - first shipped in PowerShell 7.5.0-preview.4
+- v1.0.5 - first shipped in PowerShell 7.5.0-preview.3
+- v1.0.4.1 - first shipped in PowerShell 7.4.2
+- v1.0.4 - released to the PowerShell Gallery only
+- v1.0.3 - released to the PowerShell Gallery only
+- v1.0.2 - irst shipped in PowerShell 7.5.0-preview.2
+- v1.0.1 - first shipped in PowerShell 7.4.0 GA release and PowerShell 7.5.0-preview.1
+- v1.0.0 - first shipped in PowerShell 7.4.0-preview.5
+
+## Release notes
+
+### v1.1.0-preview2 - 2024-09-13
+
+- New cmdlet `Compress-PSResource` to create a `.nupkg` package without publishing it to a repository
+  system.
+- Added `-Nupkg` parameter to `Publish-PSResource` to publish a `.nupkg` file to a repository.
+- Added `-ModulePrefix` parameter for `Publish-PSResource`, which adds a prefix to a module name for
+  container registry repositories. This is only used for publishing and is not part of metadata.
+- Improved error messages for Authenticode failures.
+- Construct Prerelease string for repositories that don't return the prerelease information.
+- Added retry logic when deleting files.
+
+### v1.1.0-preview1 - 2024-04-01
+
+- Added support for Azure Container Registries as a repository type
+- Allowed PSResourceGet to run Constrained Languange Mode
+- Fixed incorrect request URL when installing resources from ADO
+
+### v1.0.5 - 2024-05-13
+
+- Added 10 minute timeout to HTTPClient
+- Refactor V2ServerAPICalls and NuGetServerAPICalls to use object-oriented query/filter builder
+- Removed unnecessary `and` for version globbing in V2ServerAPICalls
+- Fixed requiring `tags` in server response
+- Fixed save script without `-IncludeXml`
+- Fixed incorrect request URL when installing from ADO
+- Improved exception handling
+- Allowed PSResourceGet to run Constrained Languange Mode
+
+### v1.0.4.1 - 2024-04-05
+
+- PSResourceGet packaging update
+
+### v1.0.4 - 2024-04-05
+
+- Dependency package updates
+
+### v1.0.3 - 2024-03-13
+
+- Fixed null package version in `Install-PSResource`
+
+### v1.0.2 - 2024-02-06
+
+- Fixed `Update-PSResource` not updating from correct repository
+- Fixed `InstalledScriptInfos` directory is now if it doesn't exist
+- Fixed `Update-ModuleManifest` throwing null pointer exception
+- Fixed `name` property in `PSResourceInfo` when using `Find-PSResource` with JFrog Artifactory
+- Fixed incorrect configuration of requests to JFrog Artifactory v2 endpoints
+- Fixed determining JFrog Artifactory repositories (#1532 Thanks @sean-r-williams!)
+- Fixed for v2 server repositories incorrectly adding script endpoint (1526)
+- Fixed typos in message prompts in `Install-PSResource`
+- Only add `NormalizedVersion` property to `AdditionalMetadata` only when it exists
+- Fix to verify whether `Uri` is a UNC path and set respective `ApiVersion`
+
+### v1.0.1 - 2023-11-07
+
+- Unix local user installation paths now compatible with .NET 7 and .NET 8
+- Fixed `Import-PSGetRepository` in Windows PowerShell
+- Fixed `Test-PSScriptFileInfo` to be less sensitive to whitespace
+- Overwrite rels/rels directory on net472 when extracting nupkg to directory
+- Added pipeline by property name support for **Name** and **Repository** parameters for
+  `Find-PSResource`
+
+### v1.0.0 - 2023-10-09
+
+- Add `ApiVersion` parameter for `Register-PSResourceRepository`
+- Automatically set the ApiVersion to v2 for repositories imported from PowerShellGet
+- Fixed ADO v2 feed installation failures
+- Fixed Artifactory v2 and v3 endpoint failures
+- Fixed `-RequiredResource` silent failures
+- Fixed v2 repository returning extra packages for `-Tag` based search with `-Prerelease`
+
+<!-- link references -->
+[01]: https://github.com/PowerShell/PSResourceGet/tree/master/CHANGELOG
@@ -15,3 +15,5 @@ items:
         href: how-to/use-acr-repository.md
   - name: PSResourceGet supported repositories
     href: supported-repositories.md
+  - name: PSResourceGet release notes
+    href: psresourceget-release-notes.md
@@ -10,7 +10,7 @@ title: about PSResourceGet
 # about_PSResourceGet
 
 ## Short description
-Describes how to use version 1.0.5 of the **Microsoft.PowerShell.PSResourceGet**
+Describes how to use version 1.1.0-preview2 of the **Microsoft.PowerShell.PSResourceGet**
 module.
 
 ## Long description
@@ -40,6 +40,7 @@ v3 and their v2 equivalents.
 
 | Microsoft.PowerShell.PSResourceGet |     PowerShellGet v2      |
 | ---------------------------------- | ------------------------- |
+| `Compress-PSResource`              | n/a                       |
 | `Find-PSResource`                  | `Find-Command`            |
 | `Find-PSResource`                  | `Find-DscResource`        |
 | `Find-PSResource`                  | `Find-Module`             |

@@ -1,8 +1,8 @@
 ---
 external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml
 Module Name: Microsoft.PowerShell.PSResourceGet
-ms.custom: 1.1.0-preview.2
-ms.date: 09/13/2024
+ms.custom: 1.1.0-preview2
+ms.date: 09/16/2024
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/compress-psresource?view=powershellget-3.x&WT.mc_id=ps-gethelp
 schema: 2.0.0
 ---
@@ -16,8 +16,8 @@ Compresses a specified folder containing module or script resources into a `.nup
 ## SYNTAX
 
 ```
-Compress-PSResource [-Path] <String> [-DestinationPath] <String> [-PassThru] [-WhatIf] [-Confirm]
- [<CommonsParameters>]
+Compress-PSResource [-Path] <String> [-DestinationPath] <String> [-PassThru] [-SkipModuleManifestValidate]
+ [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
@@ -27,7 +27,7 @@ file. isolates the pack feature in the `Publish-PSResource` cmdlet. This allows
 `.nupkg` file before publishing it to a repository. You can publish the final `.nupkg` file using
 the **NupkgPath** parameter of `Publish-PSResource`.
 
-This command was added in v1.1.0-preview.2 of **Microsoft.PowerShell.PSResourceGet**.
+This command was added in v1.1.0-preview2 of **Microsoft.PowerShell.PSResourceGet**.
 
 ## EXAMPLES
 
@@ -91,7 +91,7 @@ Accept wildcard characters: False
 
 ### -SkipModuleManifestValidate
 
-Skips validating the module manifest before publishing.
+Skips validating the module manifest before creating the `.nupkg` file.
 
 ```yaml
 Type: System.Management.Automation.SwitchParameter

@@ -1,8 +1,8 @@
 ---
 external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml
 Module Name: Microsoft.PowerShell.PSResourceGet
-ms.custom: 1.0.5
-ms.date: 05/17/2024
+ms.custom: 1.1.0-preview2
+ms.date: 09/16/2024
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/find-psresource?view=powershellget-3.x&WT.mc_id=ps-gethelp
 schema: 2.0.0
 ---
@@ -352,7 +352,7 @@ Specifies one or more resource types to find. Resource types supported are:
 Type: Microsoft.PowerShell.PSResourceGet.UtilClasses.ResourceType
 Parameter Sets: NameParameterSet
 Aliases:
-Accepted values: None, Module, Script
+Accepted values: None, Module, Script, Nupkg
 
 Required: False
 Position: Named

@@ -1,8 +1,8 @@
 ---
 external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml
 Module Name: Microsoft.PowerShell.PSResourceGet
-ms.custom: 1.0.5
-ms.date: 05/17/2024
+ms.custom: 1.1.0-preview2
+ms.date: 09/16/2024
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/get-installedpsresource?view=powershellget-3.x&WT.mc_id=ps-gethelp
 schema: 2.0.0
 ---

@@ -1,8 +1,8 @@
 ---
 external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml
 Module Name: Microsoft.PowerShell.PSResourceGet
-ms.custom: 1.0.5
-ms.date: 05/17/2024
+ms.custom: 1.1.0-preview2
+ms.date: 09/16/2024
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/get-psresourcerepository?view=powershellget-3.x&WT.mc_id=ps-gethelp
 schema: 2.0.0
 ---

@@ -1,8 +1,8 @@
 ---
 external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml
 Module Name: Microsoft.PowerShell.PSResourceGet
-ms.custom: 1.0.5
-ms.date: 05/17/2024
+ms.custom: 1.1.0-preview2
+ms.date: 09/16/2024
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/get-psscriptfileinfo?view=powershellget-3.x&WT.mc_id=ps-gethelp
 schema: 2.0.0
 ---

@@ -1,8 +1,8 @@
 ---
 external help file: Microsoft.PowerShell.PSResourceGet.dll-help.xml
 Module Name: Microsoft.PowerShell.PSResourceGet
-ms.custom: 1.0.5
-ms.date: 05/17/2024
+ms.custom: 1.1.0-preview2
+ms.date: 09/16/2024
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/import-psgetrepository?view=powershellget-3.x&WT.mc_id=ps-gethelp
 schema: 2.0.0
 ---

@@ -1,8 +1,8 @@
 ---
 external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml
 Module Name: Microsoft.PowerShell.PSResourceGet
-ms.custom: 1.0.5
-ms.date: 06/07/2024
+ms.custom: 1.1.0-preview2
+ms.date: 09/16/2024
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/install-psresource?view=powershellget-3.x&WT.mc_id=ps-gethelp
 schema: 2.0.0
 ---

@@ -1,11 +1,11 @@
 ---
 Download Help Link: https://go.microsoft.com/fwlink/?linkid=2238183
-Help Version: 3.0.16
+Help Version: 3.0.24260
 Locale: en-US
 Module Guid: e4e0bda1-0703-44a5-b70d-8fe704cd0643
 Module Name: Microsoft.PowerShell.PSResourceGet
-ms.custom: 1.0.5
-ms.date: 05/17/2024
+ms.custom: 1.1.0-preview2
+ms.date: 09/16/2024
 schema: 2.0.0
 title: Microsoft.PowerShell.PSResourceGet
 ---
@@ -16,7 +16,9 @@ title: Microsoft.PowerShell.PSResourceGet
 PSResourceGet is a module with commands for discovering, installing, updating and publishing
 PowerShell artifacts like Modules, DSC Resources, Role Capabilities, and Scripts.
 
-This documentation covers the latest version **Microsoft.PowerShell.PSResourceGet** v1.0.3.
+This documentation covers the latest version **Microsoft.PowerShell.PSResourceGet** v1.1.0-preview2.
+For a list of differences between versions, see the
+[What's new in PSResourceGet?](/powershell/gallery/powershellget/psresourceget-release-notes).
 
 > [!IMPORTANT]
 > Windows PowerShell 5.1 comes with version 1.0.0.1 of **PowerShellGet** preinstalled. This version
@@ -27,6 +29,9 @@ This documentation covers the latest version **Microsoft.PowerShell.PSResourceGe
 
 ## Microsoft.PowerShell.PSResourceGet Cmdlets
 
+### [Compress-PSResource](Compress-PSResource.md)
+Compresses a specified folder containing module or script resources into a `.nupkg` file.
+
 ### [Find-PSResource](Find-PSResource.md)
 Searches for packages from a repository (local or remote), based on a name or other package
 properties.

@@ -1,8 +1,8 @@
 ---
 external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml
 Module Name: Microsoft.PowerShell.PSResourceGet
-ms.custom: 1.0.5
-ms.date: 05/17/2024
+ms.custom: 1.1.0-preview2
+ms.date: 09/16/2024
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/new-psscriptfileinfo?view=powershellget-3.x&WT.mc_id=ps-gethelp
 schema: 2.0.0
 ---

@@ -1,8 +1,8 @@
 ---
 external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml
 Module Name: Microsoft.PowerShell.PSResourceGet
-ms.custom: 1.1.0-preview.2
-ms.date: 09/13/2024
+ms.custom: 1.1.0-preview2
+ms.date: 09/16/2024
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/publish-psresource?view=powershellget-3.x&WT.mc_id=ps-gethelp
 schema: 2.0.0
 ---
@@ -118,13 +118,37 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -ModulePrefix
+
+This is a dynamic parameter that is only available on the command line when you have supplied the
+**Path** or **Nupkg** parameters and the **Repository** parameter for a `ContainerRegistry`
+repository.
+
+The value of the parameter is pre-pended to the package name. This information is only used for
+publishing and isn't included in the package metadata. The module prefix controls the visibility of
+the module, for example: `internal`, `public`, `staging`.
+
+This parameter is only used when publishing to the Microsoft Artifact Registry (MAR).
+
+```yaml
+Type: System.String
+Parameter Sets: All
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -NupkgPath
 
 Path to the `.nupkg` file to be published. The `.nupkg` file could have been created by a previous
 run of `Publish-PSResource` with the **DestinationPath** parameter. Or, you can create the `.nupkg`
 file using the `Compress-PSResource` command.
 
-This parameter was added in v1.1.0-preview.2 of **Microsoft.PowerShell.PSResourceGet**.
+This parameter was added in v1.1.0-preview2 of **Microsoft.PowerShell.PSResourceGet**.
 
 ```yaml
 Type: System.String

@@ -1,8 +1,8 @@
 ---
 external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml
 Module Name: Microsoft.PowerShell.PSResourceGet
-ms.custom: 1.0.5
-ms.date: 05/17/2024
+ms.custom: 1.1.0-preview2
+ms.date: 09/16/2024
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/register-psresourcerepository?view=powershellget-3.x&WT.mc_id=ps-gethelp
 schema: 2.0.0
 ---
@@ -161,7 +161,7 @@ parameter allows you to change the API version after you have registered a repos
 Type: Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo+APIVersion
 Parameter Sets: NameParameterSet
 Aliases:
-Accepted values: unknown, v2, v3, local, nugetServer
+Accepted values: Unknown, V2, V3, Local, NugetServer, ContainerRegistry
 
 Required: False
 Position: Named

@@ -1,8 +1,8 @@
 ---
 external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml
 Module Name: Microsoft.PowerShell.PSResourceGet
-ms.custom: 1.0.5
-ms.date: 05/17/2024
+ms.custom: 1.1.0-preview2
+ms.date: 09/16/2024
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/save-psresource?view=powershellget-3.x&WT.mc_id=ps-gethelp
 schema: 2.0.0
 ---

@@ -1,8 +1,8 @@
 ---
 external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml
 Module Name: Microsoft.PowerShell.PSResourceGet
-ms.custom: 1.0.5
-ms.date: 05/17/2024
+ms.custom: 1.1.0-preview2
+ms.date: 09/16/2024
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/set-psresourcerepository?view=powershellget-3.x&WT.mc_id=ps-gethelp
 schema: 2.0.0
 ---
@@ -166,7 +166,7 @@ parameter allows you to change the API version after you have registered a repos
 Type: Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo+APIVersion
 Parameter Sets: NameParameterSet
 Aliases:
-Accepted values: unknown, v2, v3, local, nugetServer
+Accepted values: Unknown, V2, V3, Local, NugetServer, ContainerRegistry
 
 Required: False
 Position: Named

@@ -1,8 +1,8 @@
 ---
 external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml
 Module Name: Microsoft.PowerShell.PSResourceGet
-ms.custom: 1.0.5
-ms.date: 05/17/2024
+ms.custom: 1.1.0-preview2
+ms.date: 09/16/2024
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/test-psscriptfileinfo?view=powershellget-3.x&WT.mc_id=ps-gethelp
 schema: 2.0.0
 ---