GCP中用gcloud部署Windows Server，如何为Cloud Storage的PowerShell启动脚本传参

GCP Windows Compute Engine实例的启动脚本执行有固定的默认逻辑：当metadata中配置了startup-script-url指向PS1脚本时，实例内的元数据服务代理会自动下载该脚本到本地，以无参数方式执行powershell -ExecutionPolicy Bypass -File <本地脚本路径>，不会自动将其他metadata键值对、URL拼接参数传入脚本作为命令行入参，这是直接传参无法生效的核心原因。

可落地的两种实现路径 #

路径1：自定义元数据传参，PS1脚本侧自行拉取参数 #

这是GCP生态下适配启动脚本的标准传参方式，改动成本最低：

• 在gcloud命令的--metadata配置段，除了原有startup-script-url配置，新增4个符合命名规则的自定义元数据键值对（键名仅允许小写字母、数字、短横线，禁止下划线、特殊字符），示例配置：

--metadata=startup-script-url="gs://bucketName/Server-Configuration-Script.ps1",\
script-param-a="paramA实际值",\
script-param-b="paramB实际值",\
script-param-c="paramC实际值",\
script-param-d="paramD实际值"

• 修改存储在GCS中的PowerShell脚本，移除原脚本的强制命令行入参定义，替换为从实例元数据接口拉取参数的逻辑，保留原有的必填校验即可：

# 元数据请求固定请求头
$metaHeaders = @{"Metadata-Flavor"="Google"}
$paramA = Invoke-RestMethod -Headers $metaHeaders -Uri "http://metadata.google.internal/computeMetadata/v1/instance/attributes/script-param-a"
$paramB = Invoke-RestMethod -Headers $metaHeaders -Uri "http://metadata.google.internal/computeMetadata/v1/instance/attributes/script-param-b"
$paramC = Invoke-RestMethod -Headers $metaHeaders -Uri "http://metadata.google.internal/computeMetadata/v1/instance/attributes/script-param-c"
$paramD = Invoke-RestMethod -Headers $metaHeaders -Uri "http://metadata.google.internal/computeMetadata/v1/instance/attributes/script-param-d"

# 保留原有的必填校验逻辑
if ([string]::IsNullOrWhiteSpace($paramA)) { throw "paramA 为必填参数" }
if ([string]::IsNullOrWhiteSpace($paramB)) { throw "paramB 为必填参数" }
if ([string]::IsNullOrWhiteSpace($paramC)) { throw "paramC 为必填参数" }
if ([string]::IsNullOrWhiteSpace($paramD)) { throw "paramD 为必填参数" }

路径2：内联包装脚本做入口，显式传递PS1脚本的命令行参数 #

如果不想修改原有带固定入参定义的PS1脚本，可以写一段短的内联启动脚本作为执行入口，先拉取GCS中的目标PS1，再按原有的入参格式执行：

• 在--metadata配置段移除原有startup-script-url配置，替换为内联的PowerShell启动逻辑，注意做好shell层面的引号转义，避免参数被截断：

--metadata=startup-script=@'
$tempDir = "C:\gcp-startup-temp"
New-Item -Path $tempDir -ItemType Directory -Force | Out-Null
$scriptPath = Join-Path $tempDir "Server-Configuration-Script.ps1"
# 拉取GCS中的目标配置脚本
Invoke-WebRequest -Uri "https://storage.googleapis.com/bucketName/Server-Configuration-Script.ps1" -OutFile $scriptPath
# 带固定入参执行目标脚本
& $scriptPath `
  -paramA "paramA实际值" `
  -paramB "paramB实际值" `
  -paramC "paramC实际值" `
  -paramD "paramD实际值"
'@

实操避坑点 #

• 不要在startup-script-url的URL后面拼接?xxx=xxx格式的查询参数，GCP元数据服务会完全忽略这些拼接内容，不会传递给执行的脚本。
• 自定义元数据的键名不能包含大写字母、下划线、冒号，否则gcloud命令会直接报元数据格式校验错误。
• 参数值如果包含空格、单引号等特殊字符，要在bash脚本和PowerShell脚本两层分别完成转义，避免执行时参数被截断。
• 拉取GCS脚本时要确保实例绑定的服务账号拥有对应GCS对象的读权限，否则脚本会因为权限不足拉取失败。

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