使用Publish-PnPApp向AppCatalog部署.sppkg时出现权限访问报错

你遇到的报错核心是Publish-PnPApp命令执行的站点上下文不是合法的应用目录站点，即使.sppkg包可以上传成功，部署操作强制要求当前PnP连接的站点必须和部署Scope对应的应用目录完全匹配，同时权限配置、参数匹配问题也可能触发该错误。

• 第一步：确认应用目录站点URL正确性
  你当前脚本中填写的https://tenant.sharepoint.com/sites/SiteName/大概率不是合法的应用目录站点：
  租户级应用目录的URL可以在SharePoint admin中心的「应用」-「应用目录」路径下查询，默认格式通常为https://<租户前缀>.sharepoint.com/sites/AppCatalog；
  如果你需要部署到单个站点集的专属应用目录，需要先确认该站点集已启用站点集应用目录功能，再使用该站点集的应用目录URL作为连接地址。
• 第二步：匹配Scope参数和应用目录类型
  如果你使用租户级应用目录部署，Add-PnPApp和Publish-PnPApp的Scope参数需统一设置为Tenant；
  如果你使用站点集专属应用目录部署，Scope参数需统一设置为Site，且连接的URL必须是该站点集的应用目录地址，不能是站点集的普通首页地址。
• 第三步：补全应用目录站点权限
  即使账号持有Office365服务支持管理员角色，也需要手动将该账号添加为你连接的应用目录站点的站点管理员，租户管理员角色不会自动继承所有站点的管理权限。
• 第四步：添加同步延迟规避偶发错误
  上传.sppkg包后建议等待几秒再执行部署操作，避免SharePoint后台同步延迟导致找不到应用ID的问题。

租户级全局部署示例 #

# 替换为你实际的租户应用目录站点URL
$AppCatalogURL = "https://tenant.sharepoint.com/sites/AppCatalog"
$AppFilePath = "D:\AzureDevOps\sfpxProject\sharepoint\solution"
$Cred = new-object -typename System.Management.Automation.PSCredential -argumentlist username, (Get-Content "D:\TestScript\svc.CredNew.txt" | ConvertTo-SecureString -Key $key)
# 精准获取sppkg包，避免目录下有多个文件时出错
$spPkg = Get-ChildItem -Path $AppFilePath -Filter *.sppkg | Select-Object -First 1
# 连接租户应用目录
Connect-PnPOnline -Url $AppCatalogURL -Credentials $Cred
# 上传包到租户应用目录
$App = Add-PnPApp -Path $spPkg.FullName -Scope Tenant -Overwrite
# 等待后台同步
Start-Sleep -Seconds 5
# 执行租户级部署
Publish-PnPApp -Identity $App.ID -Scope Tenant

站点集专属部署示例 #

# 替换为你实际的站点集应用目录URL
$AppCatalogURL = "https://tenant.sharepoint.com/sites/目标站点名/AppCatalog"
$AppFilePath = "D:\AzureDevOps\sfpxProject\sharepoint\solution"
$Cred = new-object -typename System.Management.Automation.PSCredential -argumentlist username, (Get-Content "D:\TestScript\svc.CredNew.txt" | ConvertTo-SecureString -Key $key)
$spPkg = Get-ChildItem -Path $AppFilePath -Filter *.sppkg | Select-Object -First 1
Connect-PnPOnline -Url $AppCatalogURL -Credentials $Cred
$App = Add-PnPApp -Path $spPkg.FullName -Scope Site -Overwrite
Start-Sleep -Seconds 5
Publish-PnPApp -Identity $App.ID -Scope Site

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