如何将 .nupkg 发布到 Powershell Gallery？
How to publish .nupkg to Powershell Gallery?
解决方案
归功于 mklement0
这是我最终将我的 bin\MyModule.0.1.0.nupkg 模块发布到 PSGallery 所做的事情：
- 将
bin\MyModule.0.1.0.nupkg 重命名为 bin\MyModule.0.1.0.zip
- 将
bin\MyModule.0.1.0.zip解压到bin\MyModule\（解压文件夹的名称必须与里面的.psd1文件的名称相匹配，所以在我的例子中现在有一个bin\MyModule\MyModule.psd1 文件).
- 从提取的文件夹中删除
[Content_Types].xml 文件（不删除这会在您尝试从 PSGallery 下载和安装模块时导致错误，这似乎是由于结果中存在该文件的 2 个副本造成的.nupkg).
然后我能够运行这个命令：
PS> Publish-Module -NuGetApiKey xxx -Path .\bin\MyModule
它奏效了！我的模块现已发布到 PSGallery。
原版Post
我有一个由 Autorest.Powershell. I now want to publish my module to the Powershell Gallery 生成并打包为 .nupkg 文件的 Powershell 模块，但不知道如何让它工作。
我试过：
PS> Publish-Module -NuGetApiKey xxx -Path .\bin\MyModule.0.1.0.nupkg
Publish-Module: The specified path '.\bin\MyModule.0.1.0.nupkg' is not a valid directory.
PS> Publish-Module -NuGetApiKey xxx -Path .\bin\
Publish-Module: The specified module with path '.\bin' was not published because no valid module was found with that path.
PS> Publish-Module -NuGetApiKey xxx -Name .\bin\MyModule.0.1.0.nupkg
Get-Module: C:\Users\bport\Documents\PowerShell\Modules\PowerShellGet.2.5\PSModule.psm1:10630
Line |
10630 | … $module = Microsoft.PowerShell.Core\Get-Module -ListAvailable -Name …
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
| The specified module 'D:\workarea\bin\MyModule.0.1.0.nupkg'
| was not found. Update the Name parameter to point to a valid path, and then try again.
Publish-Module: The specified module '.\bin\MyModule.0.1.0.nupkg' was not published because no module with that name was found in any module directory.
PS> dotnet nuget push .\bin\MyModule.0.1.0.nupkg --api-key xxx --source https://www.powershellgallery.com/api/v2
Pushing MyModule.0.1.0.nupkg to 'https://www.powershellgallery.com/api/v2'...
PUT https://www.powershellgallery.com/api/v2/
MethodNotAllowed https://www.powershellgallery.com/api/v2/ 580ms
error: Response status code does not indicate success: 405 (Method Not Allowed).
将 .nupkg 文件发布到 Powershell Gallery 应该是可能的，因为您可以从 Powershell Gallery 下载包作为 .nupkg 文件。此外，Autorest 文档说 this 关于其生成的 nupkg 文件：
The structure of the .nupkg is created so it can be loaded part of a PSRepository. Additionally, this package is in a format for distribution to the PSGallery.
我猜这是可能的，但我不知道该怎么做。任何帮助将不胜感激
从 PowerShellGet 模块的版本 2.2.5 开始 - PowerShell 7.2 预览版附带的那个 - Publish-Module cmdlet for publishing PowerShell modules to the PowerShell Gallery 不 支持正在上传 .nupkg 个文件。
相反，它需要一个（未压缩的）目录，其中包含要发布的 PowerShell 模块[1]，即 然后 在后台压缩成一个（临时）NuGet 包（.nupkg 存档）并上传到图库。
我不熟悉 AutoRest.PowerShell，但如果它声称它创建的 .nupkg 存档与 PowerShell Gallery 兼容，您可以尝试 extract（解压）这样一个存档（NuGet 文件是 ZIP 存档，所以你可以将它们传递给 Expand-Archive）到一个目录中，并尝试将该目录的路径传递给 Publish-Module 的 -Path参数（选择包含模块清单文件（.psd1）的目录，它可能是一个子文件夹）。
[1] 如果要发布的模块位于 $env:PSModulePath 中列出的目录之一，其目录位置可以从模块的 name，传递给-Name参数。
解决方案
归功于 mklement0
这是我最终将我的 bin\MyModule.0.1.0.nupkg 模块发布到 PSGallery 所做的事情：
- 将
bin\MyModule.0.1.0.nupkg重命名为bin\MyModule.0.1.0.zip - 将
bin\MyModule.0.1.0.zip解压到bin\MyModule\（解压文件夹的名称必须与里面的.psd1文件的名称相匹配，所以在我的例子中现在有一个bin\MyModule\MyModule.psd1文件). - 从提取的文件夹中删除
[Content_Types].xml文件（不删除这会在您尝试从 PSGallery 下载和安装模块时导致错误，这似乎是由于结果中存在该文件的 2 个副本造成的.nupkg).
然后我能够运行这个命令：
PS> Publish-Module -NuGetApiKey xxx -Path .\bin\MyModule
它奏效了！我的模块现已发布到 PSGallery。
原版Post
我有一个由 Autorest.Powershell. I now want to publish my module to the Powershell Gallery 生成并打包为 .nupkg 文件的 Powershell 模块，但不知道如何让它工作。 我试过：
PS> Publish-Module -NuGetApiKey xxx -Path .\bin\MyModule.0.1.0.nupkg
Publish-Module: The specified path '.\bin\MyModule.0.1.0.nupkg' is not a valid directory.
PS> Publish-Module -NuGetApiKey xxx -Path .\bin\
Publish-Module: The specified module with path '.\bin' was not published because no valid module was found with that path.
PS> Publish-Module -NuGetApiKey xxx -Name .\bin\MyModule.0.1.0.nupkg
Get-Module: C:\Users\bport\Documents\PowerShell\Modules\PowerShellGet.2.5\PSModule.psm1:10630
Line |
10630 | … $module = Microsoft.PowerShell.Core\Get-Module -ListAvailable -Name …
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
| The specified module 'D:\workarea\bin\MyModule.0.1.0.nupkg'
| was not found. Update the Name parameter to point to a valid path, and then try again.
Publish-Module: The specified module '.\bin\MyModule.0.1.0.nupkg' was not published because no module with that name was found in any module directory.
PS> dotnet nuget push .\bin\MyModule.0.1.0.nupkg --api-key xxx --source https://www.powershellgallery.com/api/v2
Pushing MyModule.0.1.0.nupkg to 'https://www.powershellgallery.com/api/v2'...
PUT https://www.powershellgallery.com/api/v2/
MethodNotAllowed https://www.powershellgallery.com/api/v2/ 580ms
error: Response status code does not indicate success: 405 (Method Not Allowed).
将 .nupkg 文件发布到 Powershell Gallery 应该是可能的，因为您可以从 Powershell Gallery 下载包作为 .nupkg 文件。此外，Autorest 文档说 this 关于其生成的 nupkg 文件：
The structure of the .nupkg is created so it can be loaded part of a PSRepository. Additionally, this package is in a format for distribution to the PSGallery.
我猜这是可能的，但我不知道该怎么做。任何帮助将不胜感激
从 PowerShellGet 模块的版本 2.2.5 开始 - PowerShell 7.2 预览版附带的那个 - Publish-Module cmdlet for publishing PowerShell modules to the PowerShell Gallery 不 支持正在上传 .nupkg 个文件。
相反，它需要一个（未压缩的）目录，其中包含要发布的 PowerShell 模块[1]，即 然后 在后台压缩成一个（临时）NuGet 包（.nupkg 存档）并上传到图库。
我不熟悉 AutoRest.PowerShell，但如果它声称它创建的 .nupkg 存档与 PowerShell Gallery 兼容，您可以尝试 extract（解压）这样一个存档（NuGet 文件是 ZIP 存档，所以你可以将它们传递给 Expand-Archive）到一个目录中，并尝试将该目录的路径传递给 Publish-Module 的 -Path参数（选择包含模块清单文件（.psd1）的目录，它可能是一个子文件夹）。
[1] 如果要发布的模块位于 $env:PSModulePath 中列出的目录之一，其目录位置可以从模块的 name，传递给-Name参数。