Update docs for 1.1.0-rc1 release

Author: sdwheeler

powershell-gallery/docs-conceptual/powershellget/psresourceget-release-notes.md

@@ -1,6 +1,6 @@
 ---
 description: This article contains release notes for the PSResourceGet module.
-ms.date: 01/31/2024
+ms.date: 10/22/2024
 ms.topic: release-notes
 title: What's new in PSResourceGet?
 ---
@@ -9,12 +9,13 @@ title: 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 preview: **Microsoft.PowerShell.PSResourceGet** v1.1.0-rc1
 - 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-rc1 - Current preview release - first shipped in PowerShell 7.5.0-rc1
+- v1.1.0-preview2 - 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
@@ -26,6 +27,14 @@ complete list of changes, see the [CHANGELOG][01] in the GitHub repository.
 
 ## Release notes
 
+### v1.1.0-rc1 - 2024-10-24
+
+- Added Group Policy support for `PSResourceGet`
+- Fix package name matching in local repositories
+- `Compress-PSResource` `-PassThru` now passes `FileInfo` instead of string
+- Add `AcceptLicense` to `Save-PSResource`
+- Other minor bug fixes and improvements
+
 ### v1.1.0-preview2 - 2024-09-13
 
 - New cmdlet `Compress-PSResource` to create a `.nupkg` package without publishing it to a repository

powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/About/about_PSResourceGet.md

@@ -1,17 +1,18 @@
 ---
 description: Describes how to use version 3.x of the PowerShellGet module.
 Locale: en-US
-ms.custom: 1.0.5
-ms.date: 05/17/2024
+ms.custom: 1.1.0-rc1
+ms.date: 10/22/2024
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.psresourceget/about_PSResourceGet?view=powershellget-3.x&WT.mc_id=ps-gethelp
 schema: 2.0.0
 title: about PSResourceGet
 ---
 # about_PSResourceGet
 
 ## Short description
-Describes how to use version 1.1.0-preview2 of the **Microsoft.PowerShell.PSResourceGet**
-module.
+
+Describes how to use version 1.1.0-rc1 of the
+**Microsoft.PowerShell.PSResourceGet** module.
 
 ## Long description
 
@@ -32,8 +33,7 @@ This version of PowerShellGet focuses on a few key areas:
 
 Previous versions of **PowerShellGet** had separate commands to work with
 modules and scripts. In **Microsoft.PowerShell.PSResourceGet**, all packages in
-the PowerShell Gallery are defined as **PSResource** objects. This reduces the
-number of cmdlets from 26 in version 2.x to 18 in version 0.9.
+the PowerShell Gallery are defined as **PSResource** objects.
 
 The following table shows the cmdlets that are available in **PowerShellGet**
 v3 and their v2 equivalents.

powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/About/about_PSResourceGet_Group_Policy.md

@@ -0,0 +1,108 @@
+---
+description: Describes the Group Policy settings for PowerShell
+Locale: en-US
+ms.custom: 1.1.0-rc1
+ms.date: 10/22/2024
+online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_psresourceget_group_policy?view=powershellget-3.x&WT.mc_id=ps-gethelp
+schema: 2.0.0
+title: about_PSResourceGet_Group_Policy
+---
+# about_PSResourceGet_Group_Policy
+
+## Short description
+
+Describes the Group Policy settings for the PSResourceGet module.
+
+## Long description
+
+**Microsoft.PowerShell.PSResourceGet** includes a Group Policy to specify a
+list of repositories that can be accessed by the module. All other repositories
+are blocked.
+
+Support for Group Policy was added in **Microsoft.PowerShell.PSResourceGet**
+v1.1.0-rc1.
+
+The PowerShell Group Policy settings are in the following Group Policy path:
+
+```
+User Configuration\
+  Administrative Templates\
+    PSResourceGet Repository Policies
+```
+
+There is no computer configuration path for these settings.
+
+**Microsoft.PowerShell.PSResourceGet** includes Group Policy templates and an
+installation script in module install location.
+
+Group Policy tools use administrative template files (`.admx`, `.adml`) to
+populate policy settings in the user interface. This allows administrators to
+manage registry-based policy settings. To install the administrative template,
+run the `InstallPSResourceGetPolicyDefinitions.ps1` script from an elevated
+PowerShell session. The following example shows the location of the script and
+template files.
+
+```powershell
+$modulePath = Split-Path (Get-Module -Name Microsoft.PowerShell.PSResourceGet).Path
+Get-ChildItem -Path $modulePath\*.adm*, $modulePath\*.ps1
+```
+
+```Output
+    Directory: C:\Program Files\PowerShell\Modules\Microsoft.PowerShell.PSResourceGet\1.1.0
+
+Mode            LastWriteTime     Length Name
+----            -------------     ------ ----
+-a---     10/22/2024  3:48 PM       1364 PSResourceRepository.adml
+-a---     10/22/2024  3:48 PM       1839 PSResourceRepository.admx
+-a---     10/22/2024  3:48 PM       2869 InstallPSResourceGetPolicyDefinitions.ps1
+```
+
+After installing the templates, you can edit these settings in the Group Policy
+Editor (`gpedit.msc`).
+
+## Configure a list of allowed repositories
+
+There is only one setting for the **PSResourceGet Repository Policies** Group
+Policy.
+
+1. Open the Group Policy Editor (`gpedit.msc`)
+1. Locate the policy under **User configuration** -> **Administrative
+   Templates** -> **Windows Components** -> **PSResourceGet Repository
+   Policies**
+1. Open the **PSResourceGet Repository Policy** setting
+1. Select **Enabled**
+1. Select **Show**
+1. Add repository in the format:
+   `Name=PSGallery;Uri=https://www.powershellgallery.com/api/v2`
+
+   > [!NOTE] Don't use quote characters around the values. Separate the
+   > key-value pairs with a semicolon (`;`) only.
+
+You may add as may repositories as you like, each on their own line.
+
+> [!CAUTION]
+> If you enable the policy without defining any repositories then no
+> repositories are allowed, effectively disabling
+> **Microsoft.PowerShell.PSResourceGet** module.
+
+## Determine the affect of Group Policy
+
+Once you have applied the Group Policy setting, the PSResourceGet commands that
+communicate with repositories check the policy before attempting to access the
+repository. If the a specified repository isn't in the allow list, you receive
+and error message similar to:
+
+> Repository 'RepoName' is not allowed by Group Policy.
+
+Adding repositories to the allow list doesn't register them for the user. You
+must use add the repositories using the `Register-PSResourceRepository` cmdlet.
+The `Register-PSResourceRepository` cmdlet doesn't access the repository at
+registration time. You won't receive an error if the repository isn't in the
+allow list until you try to access the repository.
+
+You can use the following command to determine the repositories that are
+allowed by Group Policy:
+
+```powershell
+Get-PSResourceRepository | Where-Object { $_.IsAllowedByPolicy }
+```

powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Compress-PSResource.md

@@ -1,8 +1,8 @@
 ---
 external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml
 Module Name: Microsoft.PowerShell.PSResourceGet
-ms.custom: 1.1.0-preview2
-ms.date: 09/16/2024
+ms.custom: 1.1.0-rc1
+ms.date: 10/22/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] [-SkipModuleManifestValidate]
- [-WhatIf] [-Confirm] [<CommonParameters>]
+Compress-PSResource [-Path] <String> [-DestinationPath] <String> [-PassThru]
+ [-SkipModuleManifestValidate] [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
@@ -150,10 +150,10 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 
 ## OUTPUTS
 
-### System.String
+### System.IO.FileSystemInfo
 
 By default, this command doesn't write any output to the pipeline. When you use the **PassThru**
-parameter, it returns full path of the `.nupkg` that was created.
+parameter, it returns a **FileSystemInfo** object for the new `.nupkg` file.
 
 ## NOTES
 

powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Find-PSResource.md

@@ -1,7 +1,7 @@
 ---
 external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml
 Module Name: Microsoft.PowerShell.PSResourceGet
-ms.custom: 1.1.0-preview2
+ms.custom: 1.1.0-rc1
 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

powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Get-InstalledPSResource.md

@@ -1,7 +1,7 @@
 ---
 external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml
 Module Name: Microsoft.PowerShell.PSResourceGet
-ms.custom: 1.1.0-preview2
+ms.custom: 1.1.0-rc1
 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

powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Get-PSResourceRepository.md

@@ -1,7 +1,7 @@
 ---
 external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml
 Module Name: Microsoft.PowerShell.PSResourceGet
-ms.custom: 1.1.0-preview2
+ms.custom: 1.1.0-rc1
 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

powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Get-PSScriptFileInfo.md

@@ -1,7 +1,7 @@
 ---
 external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml
 Module Name: Microsoft.PowerShell.PSResourceGet
-ms.custom: 1.1.0-preview2
+ms.custom: 1.1.0-rc1
 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

powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Import-PSGetRepository.md

@@ -1,7 +1,7 @@
 ---
 external help file: Microsoft.PowerShell.PSResourceGet.dll-help.xml
 Module Name: Microsoft.PowerShell.PSResourceGet
-ms.custom: 1.1.0-preview2
+ms.custom: 1.1.0-rc1
 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

powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Install-PSResource.md

@@ -1,7 +1,7 @@
 ---
 external help file: Microsoft.PowerShell.PSResourceGet.dll-Help.xml
 Module Name: Microsoft.PowerShell.PSResourceGet
-ms.custom: 1.1.0-preview2
+ms.custom: 1.1.0-rc1
 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