PowerShell Core：UNC路径注册PSRepository失败的排查求助

一、解决UNC路径直接注册失败的问题 #

当前机器用UNC路径注册报错“找不到路径”，但另一台机器正常，可按以下步骤排查：

• 验证权限与连通性：
  执行Test-Path '\\10.0.0.1\PS' -Credential $Credential，若返回False，先手动建立SMB连接：

  net use \\10.0.0.1\PS /user:$($Credential.UserName)
  

  输入密码后再重试注册命令。同时检查共享的共享权限和NTFS文件夹权限，确保凭据用户拥有读取/写入权限。
• 确认凭据对象有效性：
  重新创建PSCredential对象避免格式问题：

  $Credential = Get-Credential
  Register-PSRepository -Name Test -SourceLocation '\\10.0.0.1\PS' -PublishLocation '\\10.0.0.1\PS' -InstallationPolicy Trusted -Credential $Credential
  

• 检查执行上下文：
  若在非交互式会话（如任务计划）中操作，需确保凭据能正确传递，建议先在交互式PowerShell窗口中完成注册测试。

二、映射盘符注册后的扩展名警告与模块查找失败问题 #

这是PowerShellGet对映射盘符路径的解析bug导致的——它会错误将P:\前缀识别为文件名的一部分，进而误判扩展名。解决方式：

• 优先切换回UNC路径注册：这是最稳定的方案，解决上述UNC路径问题后即可正常使用。
• 修正映射盘符路径格式：
  在路径末尾添加反斜杠，强制PowerShellGet正确解析路径：

  Register-PSRepository -Name Test -SourceLocation 'P:\' -PublishLocation 'P:\' -InstallationPolicy Trusted
  

• 升级PowerShellGet模块：
  安装最新版本修复已知bug：

  Install-Module PowerShellGet -Force -AllowClobber
  

三、通用验证步骤 #

注册完成后，执行以下命令确认仓库状态：

1. 查看仓库配置：

   Get-PSRepository Test
   

   确认SourceLocation和PublishLocation与实际共享路径一致。
2. 检查共享中的模块文件：

   Get-ChildItem '\\10.0.0.1\PS' -Filter *.nupkg
   

   确认目标模块（如TOML.0.1.0.nupkg）存在且扩展名正确。
3. 绕开仓库直接安装测试：

   Install-Module -Name TOML -Source '\\10.0.0.1\PS' -Credential $Credential
   

   若能正常安装，说明模块文件本身无问题，问题出在仓库注册环节。

内容的提问来源于stack exchange，提问作者Lars Grünheid