diff --git a/powershell-gallery/docs-conceptual/powershellget/psresourceget-release-notes.md b/powershell-gallery/docs-conceptual/powershellget/psresourceget-release-notes.md new file mode 100644 index 0000000..4325cde --- /dev/null +++ b/powershell-gallery/docs-conceptual/powershellget/psresourceget-release-notes.md @@ -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 - first 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` + + +[01]: https://github.com/PowerShell/PSResourceGet/tree/master/CHANGELOG diff --git a/powershell-gallery/docs-conceptual/powershellget/toc.yml b/powershell-gallery/docs-conceptual/powershellget/toc.yml index 0cbd228..77ac9d2 100644 --- a/powershell-gallery/docs-conceptual/powershellget/toc.yml +++ b/powershell-gallery/docs-conceptual/powershellget/toc.yml @@ -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 diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/About/about_PSResourceGet.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/About/about_PSResourceGet.md index e84dc50..25c81bb 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/About/about_PSResourceGet.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/About/about_PSResourceGet.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` | diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Compress-PSResource.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Compress-PSResource.md new file mode 100644 index 0000000..061c8a4 --- /dev/null +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Compress-PSResource.md @@ -0,0 +1,166 @@ +--- +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 +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 +--- + +# Compress-PSResource + +## SYNOPSIS + +Compresses a specified folder containing module or script resources into a `.nupkg` file. + +## SYNTAX + +``` +Compress-PSResource [-Path] [-DestinationPath] [-PassThru] [-SkipModuleManifestValidate] + [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION + +This cmdlet compresses a specified folder containing module or script resources into a `.nupkg` +file. isolates the pack feature in the `Publish-PSResource` cmdlet. This allows you to sign the +`.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-preview2 of **Microsoft.PowerShell.PSResourceGet**. + +## EXAMPLES + +### Example 1 + +This example compresses the module **TestModule** and saves te nupkg to the DestinationPath. + +```powershell +Compress-PSResource -Path C:\TestModule -DestinationPath C:\NupkgDestination +``` + +## PARAMETERS + +### -DestinationPath + +Path to save the compressed resource. + +```yaml +Type: System.String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 1 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -PassThru + +Pass the full path of the nupkg through the pipeline. + +```yaml +Type: System.Management.Automation.SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Path + +Path to the resource to be compressed. + +```yaml +Type: System.String +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -SkipModuleManifestValidate + +Skips validating the module manifest before creating the `.nupkg` file. + +```yaml +Type: System.Management.Automation.SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm + +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: System.Management.Automation.SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf + +Shows what would happen if the cmdlet runs. The cmdlet isn't run. + +```yaml +Type: System.Management.Automation.SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters + +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, +-InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, +-WarningAction, and -WarningVariable. For more information, see +[about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### None + +## OUTPUTS + +### System.String + +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. + +## NOTES + +The module defines `cmres` as an alias for `Compress-PSResource`. + +This cmdlet allows for publishing nuspec dependencies into ACR. + +## RELATED LINKS + +[Publish-PSResource](Publish-PSResource.md) diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Find-PSResource.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Find-PSResource.md index ba5d7f0..1ef1bae 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Find-PSResource.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Find-PSResource.md @@ -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 diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Get-InstalledPSResource.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Get-InstalledPSResource.md index 9ab7d4b..570e5b6 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Get-InstalledPSResource.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Get-InstalledPSResource.md @@ -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 --- diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Get-PSResourceRepository.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Get-PSResourceRepository.md index a0247c7..ad42c54 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Get-PSResourceRepository.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Get-PSResourceRepository.md @@ -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 --- diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Get-PSScriptFileInfo.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Get-PSScriptFileInfo.md index fd59635..260f8ed 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Get-PSScriptFileInfo.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Get-PSScriptFileInfo.md @@ -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 --- diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Import-PSGetRepository.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Import-PSGetRepository.md index 2a7a64f..e455262 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Import-PSGetRepository.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Import-PSGetRepository.md @@ -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 --- diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Install-PSResource.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Install-PSResource.md index b4bac2c..cff60d6 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Install-PSResource.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Install-PSResource.md @@ -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 --- diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Microsoft.PowerShell.PSResourceGet.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Microsoft.PowerShell.PSResourceGet.md index ef3b4d3..83f94a3 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Microsoft.PowerShell.PSResourceGet.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Microsoft.PowerShell.PSResourceGet.md @@ -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. diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/New-PSScriptFileInfo.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/New-PSScriptFileInfo.md index 21b4908..c788167 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/New-PSScriptFileInfo.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/New-PSScriptFileInfo.md @@ -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 --- diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Publish-PSResource.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Publish-PSResource.md index 48a8735..18dc11f 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Publish-PSResource.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Publish-PSResource.md @@ -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/publish-psresource?view=powershellget-3.x&WT.mc_id=ps-gethelp schema: 2.0.0 --- @@ -15,19 +15,29 @@ Publishes a specified module from the local computer to PSResource repository. ## SYNTAX +### PathParameterSet + ``` Publish-PSResource [-ApiKey ] [-Repository ] [-Path] [-DestinationPath ] [-Credential ] [-SkipDependenciesCheck] - [-SkipModuleManifestValidate] [-Proxy ] [-ProxyCredential ] [-WhatIf] [-Confirm] - [] + [-SkipModuleManifestValidate] [-Proxy ] [-ProxyCredential ] [-WhatIf] + [-Confirm] [] +``` + +### NupkgPathParameterSet + +``` +Publish-PSResource [-ApiKey ] [-Repository ] [-DestinationPath ] + [-Credential ] [-SkipDependenciesCheck] [-SkipModuleManifestValidate] [-Proxy ] + [-ProxyCredential ] -NupkgPath [-WhatIf] [-Confirm] [] ``` ## DESCRIPTION This cmdlet combines the functions of the `Publish-Module` and `Publish-Script` cmdlets from **PowerShellGet** v2. `Publish-PSResource` publishes a resource from the local computer to an online -Nuget-based repository. You can specify the resource by the resource's name or by the path -containing the module or script resource. +NuGet-based repository. You can specify the resource by a path containing the module or script +resource files or by pointing a prepackaged `.nupkg` file. ## EXAMPLES @@ -48,6 +58,14 @@ that's generated by the PowerShell Gallery for a user account. Publish-PSResource -Path c:\TestModule -Repository PSGallery -APIKey '1234567' ``` +### Example 3 + +This example publishes the module Nupkg **TestModule.nupkg** to a repositroy named TestRepository. + +```powershell +Publish-PSResource -NupkgPath c:\TestModule.nupkg -Repository TestRepository +``` + ## PARAMETERS ### -ApiKey @@ -100,10 +118,55 @@ 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-preview2 of **Microsoft.PowerShell.PSResourceGet**. + +```yaml +Type: System.String +Parameter Sets: NupkgPathParameterSet +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -Path The path to the module or script file or the path to a folder containing the module or script file -to be published. +to be published. The cmdlet packages all files in the folder into a `.nupkg` file before publishing +to the repository. ```yaml Type: System.String @@ -252,3 +315,5 @@ Fileshare-based repository have no metadata about the resources. Therefore, ther for dependencies. ## RELATED LINKS + +[Compress-PSResource](Compress-PSResource.md) diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Register-PSResourceRepository.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Register-PSResourceRepository.md index 5ea36ec..4c93545 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Register-PSResourceRepository.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Register-PSResourceRepository.md @@ -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 diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Save-PSResource.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Save-PSResource.md index 304b745..2a829c6 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Save-PSResource.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Save-PSResource.md @@ -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 --- diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Set-PSResourceRepository.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Set-PSResourceRepository.md index 293d608..6819750 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Set-PSResourceRepository.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Set-PSResourceRepository.md @@ -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 diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Test-PSScriptFileInfo.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Test-PSScriptFileInfo.md index a9c94bc..ad74535 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Test-PSScriptFileInfo.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Test-PSScriptFileInfo.md @@ -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 --- diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Uninstall-PSResource.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Uninstall-PSResource.md index 6d41bde..833027f 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Uninstall-PSResource.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Uninstall-PSResource.md @@ -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/uninstall-psresource?view=powershellget-3.x&WT.mc_id=ps-gethelp schema: 2.0.0 --- diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Unregister-PSResourceRepository.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Unregister-PSResourceRepository.md index 229cc0f..e6c9720 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Unregister-PSResourceRepository.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Unregister-PSResourceRepository.md @@ -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/unregister-psresourcerepository?view=powershellget-3.x&WT.mc_id=ps-gethelp schema: 2.0.0 --- diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Update-PSModuleManifest.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Update-PSModuleManifest.md index 2c64ac3..1c7a7b6 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Update-PSModuleManifest.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Update-PSModuleManifest.md @@ -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/update-psmodulemanifest?view=powershellget-3.x&WT.mc_id=ps-gethelp schema: 2.0.0 --- diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Update-PSResource.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Update-PSResource.md index cfcd944..c148ca3 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Update-PSResource.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Update-PSResource.md @@ -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/update-psresource?view=powershellget-3.x&WT.mc_id=ps-gethelp schema: 2.0.0 --- diff --git a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Update-PSScriptFileInfo.md b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Update-PSScriptFileInfo.md index 951a798..b2e1209 100644 --- a/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Update-PSScriptFileInfo.md +++ b/powershell-gallery/powershellget-3.x/Microsoft.PowerShell.PSResourceGet/Update-PSScriptFileInfo.md @@ -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/update-psscriptfileinfo?view=powershellget-3.x&WT.mc_id=ps-gethelp schema: 2.0.0 ---