使用PowerShell配置APIM自定义域名失败，SubnetResourceId格式报错

问题原因 #

直接通过Get-AzApiManagement获取实例对象后修改属性再调用Set-AzApiManagement，会导致对象中VNet相关属性（比如SubnetResourceId）在序列化过程中出现格式异常或丢失，触发Azure的格式验证错误——尤其是当你的APIM实例部署在虚拟网络环境中时，这个问题更容易出现。

修正后的脚本 #

放弃修改Get-AzApiManagement返回的对象，直接通过Set-AzApiManagement的参数传递自定义域名配置：

[CmdletBinding()]
param (
    [String]
    $ResourceGroupName,
    [String]
    $Hostname,
    [String]
    $ApimServiceName,
    [string]
    $KeyVaultId
)

# 创建自定义域名配置
$ProxyHostnameConf = New-AzApiManagementCustomHostnameConfiguration -Hostname $Hostname -HostnameType "Proxy" -KeyVaultId $KeyVaultId -DefaultSslBinding

# 直接通过参数更新APIM配置，避免修改完整对象
Set-AzApiManagement -ResourceGroupName $ResourceGroupName -Name $ApimServiceName -ProxyCustomHostnameConfiguration $ProxyHostnameConf

额外说明 #

如果确实需要使用InputObject方式操作，需先检查$apim.VirtualNetworkConfiguration.SubnetResourceId的格式是否符合要求：

• 格式必须严格匹配^/subscriptions/[^/]*/resourceGroups/[^/]*/providers/Microsoft.(ClassicNetwork|Network)/virtualNetworks/[^/]*/subnets/[^/]*$
• 若该值为空或格式错误，需手动修正后再调用Set-AzApiManagement

但推荐使用参数传递的方式，它能让Azure PowerShell cmdlet自动处理原有配置与新配置的合并，避免不必要的验证错误。

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