Artifactory搭建PowerShell Gallery远程仓库异常问题咨询

微软并没有限制这类操作，问题出在Artifactory的仓库配置和PowerShell仓库注册的细节上。PSGallery本质是标准的NuGet v2源，所以需要按NuGet远程仓库来配置，而非通用远程仓库，具体步骤如下：

1. 在Artifactory中创建NuGet远程仓库 #

• 登录Artifactory后台，进入Repositories > Remote > New Remote Repository
• 选择NuGet类型，填写以下关键配置：
  • Repository Key：自定义名称（比如psgallery-remote）
  • URL：必须填https://www.powershellgallery.com/api/v2/（注意末尾的斜杠，缺失会导致元数据解析失败）
  • 勾选Store Artifacts Locally：开启本地缓存，满足内部副本的需求
  • 若内部网络需要代理，在Proxy标签页配置代理信息
• 保存后点击仓库页面的Test按钮，确认Artifactory能正常连通PSGallery

2. 注册PowerShell仓库 #

在Windows机器上执行以下命令，注意SourceLocation必须指向Artifactory的NuGet API端点：

Register-PSRepository -Name psgallery-remote -SourceLocation "http://your-artifactory-domain/artifactory/api/nuget/psgallery-remote" -InstallationPolicy Trusted

替换your-artifactory-domain为你的Artifactory实际地址，路径格式是固定的/artifactory/api/nuget/[仓库Key]

3. 测试模块查询 #

执行Find-Module命令时，第一次查询会触发Artifactory向PSGallery拉取元数据并缓存，所以可能稍慢：

Find-Module -Name InvokeBuild -Repository psgallery-remote

后续查询会直接从Artifactory的缓存中读取，速度更快，且仓库会逐步缓存你查询过的模块。

关键问题排查 #

• 之前创建通用远程仓库的错误：通用仓库无法解析NuGet的元数据结构，必须用NuGet专用仓库类型
• SourceLocation路径错误：必须指向Artifactory的NuGet API端点，而非仓库的普通访问路径
• 缓存未触发：第一次查询需要Artifactory主动拉取元数据，所以首次无结果的情况可能是网络延迟，等待片刻或重新执行即可

合规扫描适配 #

Artifactory缓存的模块会存储在本地仓库中，你可以直接使用JFrog Xray或集成第三方扫描工具，对缓存的PowerShell模块进行漏洞扫描和合规检查，完全满足内部合规需求。

内容的提问来源于stack exchange，提问作者CJVanderlinden