使用Restore-PowerAppEnvironment cmdlet报错无法识别如何解决

错误1：GUID值报CommandNotFoundException #

• 根因：创建[PSCustomObject]时，SourceEnvironmentId对应的GUID值未使用引号包裹，PowerShell默认将无引号、含横杠的内容识别为可执行命令，才会触发未找到命令的报错。
• 解决方法：所有字符串类型的参数值（包括环境ID、实例名称、标签等）都使用单引号/双引号包裹。
  正确的参数对象创建示例：

$RestoreParams = [PSCustomObject]@{
    SourceEnvironmentId = 'c3aae985-d87c-49cb-8212-8624159a6ed8'
    TargetEnvironmentId = '你的目标环境ID'
    RestorePointDateTime = $ValidBackupTime
    FriendlyName = '恢复测试环境'
}

错误2：RestorePointDateTime报空对象调用方法错误 #

• 根因：该报错是因为你调用方法的对象为null，常见场景有两类：
  1. 你尝试从备份列表中提取恢复时间点时，未先正确获取到备份对象，返回结果为空后调用了DateTime相关方法
  2. 直接赋值时未将时间字符串转换为有效的DateTime类型，或指定的时间点不存在对应的备份
• 解决方法：
  1. 先执行获取环境备份列表的命令，校验返回结果不为空后再提取时间点，示例：

  # 先获取源环境的所有可用备份
  $Backups = Get-PowerAppEnvironmentBackup -EnvironmentId 'c3aae985-d87c-49cb-8212-8624159a6ed8'
  # 校验备份不为空
  if ($null -eq $Backups -or $Backups.Count -eq 0) {
      Write-Error "未找到源环境的可用备份"
      return
  }
  # 取最新的备份时间点
  $RestorePointDateTime = $Backups[0].CreatedTime
  

  2. 若手动指定时间点，需先转换为合法的DateTime类型：

  $RestorePointDateTime = [DateTime]::Parse('2024-01-01 12:00:00')
  

完整恢复流程示例 #

# 1. 连接PowerApps管理中心
Add-PowerAppsAccount

# 2. 获取源环境备份
$SourceEnvId = 'c3aae985-d87c-49cb-8212-8624159a6ed8'
$Backups = Get-PowerAppEnvironmentBackup -EnvironmentId $SourceEnvId
if ($null -eq $Backups) {
    Write-Error "无可用备份"
    exit
}

# 3. 构造恢复参数
$RestoreParams = [PSCustomObject]@{
    SourceEnvironmentId = $SourceEnvId
    TargetEnvironmentId = '目标环境ID'
    RestorePointDateTime = $Backups[0].CreatedTime
    FriendlyName = '恢复后的环境'
}

# 4. 执行恢复
Restore-PowerAppEnvironment @RestoreParams

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