使用PowerShell设置Azure Function IP限制遇PUT请求错误求助

嘿，我之前也踩过这个坑，给你几个实用的排查和解决方向：

• 检查资源路径与API版本是否正确
  Function App的IP限制配置属于Microsoft.Web/sites/config类型下的web子资源，路径一定不能写错。同时要使用稳定且较新的API版本（比如2022-03-01），旧版本的API可能不支持PUT操作或者路径逻辑不同。
  正确的参数示例：

  $resourceParams = @{
      ResourceName = "你的FunctionApp名称/web"
      ResourceGroupName = "你的资源组名称"
      ResourceType = "Microsoft.Web/sites/config"
      ApiVersion = "2022-03-01"
      PropertyObject = @{
          ipSecurityRestrictions = @(
              @{
                  ipAddress = "192.168.1.0/24"
                  action = "Allow"
                  priority = 100
                  name = "允许内部子网访问"
              }
          )
      }
      Force = $true
  }
  Set-AzureRmResource @resourceParams
  

  另外注意：如果现在还在使用AzureRm模块，建议尽快迁移到Az模块（AzureRm已被官方弃用），对应cmdlet换成Set-AzResource，参数逻辑一致。

• 尝试改用PATCH方法进行部分更新
  报错提示PUT不支持，大概率是因为你用PUT尝试替换整个web配置资源，但IP限制只是其中一个属性。此时可以指定-Method Patch参数来做部分属性更新，这样更符合API的设计：

  Set-AzureRmResource @resourceParams -Method Patch
  

  PATCH方法只会更新你指定的ipSecurityRestrictions属性，不需要提交完整的web配置，能避免很多不必要的错误。

• 验证资源存在性与权限
  先确认你的账号有**网站参与者（Website Contributor）**或更高的权限，能修改Function App的配置。然后用Get-AzureRmResource验证资源路径是否正确：

  Get-AzureRmResource -ResourceName "你的FunctionApp名称/web" -ResourceGroupName "你的资源组名称" -ResourceType "Microsoft.Web/sites/config" -ApiVersion "2022-03-01"
  

  如果这个命令返回正常的资源信息，说明路径没问题；如果报错找不到资源，那就是名称或路径拼写错误了。

• 改用专门的App Service cmdlet（更推荐）
  其实官方有专门的cmdlet来管理IP限制，比直接调用Set-AzureRmResource更简单可靠，比如Set-AzureRmWebApp：

  $ipRules = @(
      @{
          IpAddress = "192.168.1.0/24"
          Action = "Allow"
          Priority = 100
          Name = "允许内部子网访问"
      }
  )
  Set-AzureRmWebApp -ResourceGroupName "你的资源组名称" -Name "你的FunctionApp名称" -IpSecurityRestrictions $ipRules
  

  这个cmdlet已经封装了正确的API调用逻辑，不需要你手动处理资源路径和HTTP方法，出错概率低很多。

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