适用于 Windows 的自定义脚本扩展
自定义脚本扩展在 Azure 虚拟机上下载并执行脚本。 此扩展适用于部署后配置、软件安装或其他任何配置/管理任务。 可以从 Azure 存储或 GitHub 下载脚本，或者在扩展运行时将脚本提供给 Azure 门户。 自定义脚本扩展与 Azure Resource Manager 模板集成，也可以使用 Azure CLI、PowerShell、Azure 门户或 Azure 虚拟机 REST API 运行它。
本文档详细说明了如何通过 Azure PowerShell 模块和 Azure Resource Manager 模板使用自定义脚本扩展，同时详细说明了 Windows 系统上的故障排除步骤。
先决条件
操作系统
可以针对 Windows 10 客户端、Windows Server 2008 R2、2012、2012 R2 和 2016 版本运行适用于 Windows 的自定义脚本扩展。
脚本位置
脚本需要存储在 Azure Blob 存储中或可通过有效 URL 访问的任何其他位置。
Internet 连接
适用于 Windows 的自定义脚本扩展要求目标虚拟机已连接到 Internet。
扩展架构
以下 JSON 显示自定义脚本扩展的架构。 扩展需要脚本位置（Azure 存储或其他具有有效 URL 的位置）以及命令才能执行。 如果使用 Azure 存储作为脚本源，则需 Azure 存储帐户名称和帐户密钥。 这些项目应视为敏感数据，并在扩展的受保护设置配置中指定。 Azure VM 扩展的受保护设置数据已加密，并且只能在目标虚拟机上解密。
JSON复制
{"apiVersion":"2015-06-15","type":"Microsoft.Compute/virtualMachines/extensions","name":"config-app","location":"[resourceGroup().location]","dependsOn": ["[concat('Microsoft.Compute/virtualMachines/', variables('vmName'),copyindex())]","[variables('musicstoresqlName')]"],"tags": {"displayName":"config-app"},"properties": {"publisher":"Microsoft.Compute","type":"CustomScriptExtension","typeHandlerVersion":"1.9","autoUpgradeMinorVersion":true,"settings": {"fileUris": ["script location"] },"protectedSettings": {"commandToExecute":"myExecutionCommand","storageAccountName":"myStorageAccountName","storageAccountKey":"myStorageAccountKey"} }}
属性值
名称值/示例
apiVersion2015-06-15
publisherMicrosoft.Compute
type扩展
typeHandlerVersion1.9
commandToExecute（例如）powershell -ExecutionPolicy Unrestricted -File configure-music-app.ps1
storageAccountName（例如）examplestorageacct
storageAccountKey（例如）TmJK/1N3AbAZ3q/+hOXoi/l73zOqsaxXDhqa9Y83/v5UpXQp2DQIBuv2Tifp60cE/OaHsJZmQZ7teQfczQj8hg==
注意- 这些属性名称区分大小写。 使用上述名称可避免部署问题。
模板部署
可使用 Azure Resource Manager 模板部署 Azure VM 扩展。 可以在 Azure 资源管理器模板中使用上一部分中详细介绍的 JSON 架构，以便在 Azure 资源管理器模板部署过程中运行自定义脚本扩展。 若需包含自定义脚本扩展的示例模板，可访问GitHub。
PowerShell 部署
可以使用Set-AzureRmVMCustomScriptExtension命令将自定义脚本扩展添加到现有虚拟机。 有关详细信息，请参阅Set-AzureRmVMCustomScriptExtension。
PowerShell复制
Set-AzureRmVMCustomScriptExtension-ResourceGroupNamemyResourceGroup `-VMNamemyVM `-LocationmyLocation `-FileUrimyURL `-Run'myScript.ps1'`-NameDemoScriptExtension
故障排除和支持
故障排除
有关扩展部署状态的数据可以从 Azure 门户和使用 Azure PowerShell 模块进行检索。 若要查看给定 VM 的扩展部署状态，请运行以下命令。
PowerShell复制
Get-AzureRmVMExtension-ResourceGroupNamemyResourceGroup-VMNamemyVM-NamemyExtensionName
扩展执行输出将记录到可在目标虚拟机上的以下目录中找到的文件中。
cmd复制
C:\WindowsAzure\Logs\Plugins\Microsoft.Compute.CustomScriptExtension
指定的文件下载到目标虚拟机上的以下目录中。
cmd复制
C:\Packages\Plugins\Microsoft.Compute.CustomScriptExtension\1.*\Downloads\
其中，是一个十进制整数，可以在不同的扩展执行之间更改。1.*值与扩展的typeHandlerVersion的当前实际值匹配。 例如，实际目录可能是C:\Packages\Plugins\Microsoft.Compute.CustomScriptExtension\1.8\Downloads\2。
执行commandToExecute命令时，扩展会将该目录（例如...\Downloads\2）设置为当前的工作目录。 这样可以通过fileURIs属性使用相对路径查找下载的文件。 请参阅下表中的示例。
绝对下载路径可能会随时间而变化，因此在可能情况下，最好是在commandToExecute字符串中选择使用相对的脚本/文件路径。 例如：
JSON复制
"commandToExecute":"powershell.exe . . . -File './scripts/myscript.ps1'"
会为通过fileUris属性列表下载的文件保留第一个 URI 段之后的路径信息。 如下表所示，下载的文件映射到下载子目录中，以便反映fileUris值的结构。
下载的文件的示例
fileUris 中的 URI相对下载位置绝对下载位置 *
https://someAcct.blob.core.chinacloudapi.cn/aContainer/scripts/myscript.ps1./scripts/myscript.ps1C:\Packages\Plugins\Microsoft.Compute.CustomScriptExtension\1.8\Downloads\2\scripts\myscript.ps1
https://someAcct.blob.core.chinacloudapi.cn/aContainer/topLevel.ps1./topLevel.ps1C:\Packages\Plugins\Microsoft.Compute.CustomScriptExtension\1.8\Downloads\2\topLevel.ps1
* 如上所示，绝对目录路径会在 VM 的生存期内更改，但不会在 CustomScript 扩展的某次执行期间更改。
支持
如果对本文中的任何观点存在疑问，可以联系MSDN Azure 和 CSDN Azure上的 Azure 专家。 或者，也可以提交 Azure 支持事件。 请转到Azure 支持站点并选择“获取支持”。 有关使用 Azure 支持的信息，请阅读Azure 支持常见问题。
立即访问http://market.azure.cn
