你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Set-AzureVMCustomScriptExtension

  • 参考
模块:
Azure

设置 Azure 虚拟机自定义脚本扩展的信息。

注意

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager （ASM） API 的旧 Azure 资源。 创建新的资源时，不建议使用此旧版 PowerShell 模块，因为 ASM 计划停用。 有关详细信息，请参阅 Azure Service Manager 停用。

Az PowerShell 模块是推荐的 PowerShell 模块，用于使用 PowerShell 管理 Azure 资源管理器 （ARM） 资源。

语法

Set-AzureVMCustomScriptExtension
   [[-ReferenceName] <String>]
   [[-Version] <String>]
   [-ContainerName] <String>
   [-FileName] <String[]>
   [[-StorageAccountName] <String>]
   [[-StorageEndpointSuffix] <String>]
   [[-StorageAccountKey] <String>]
   [[-Run] <String>]
   [[-Argument] <String>]
   [-ForceUpdate]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureVMCustomScriptExtension
   [[-ReferenceName] <String>]
   [[-Version] <String>]
   [-Disable]
   [-ForceUpdate]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureVMCustomScriptExtension
   [[-ReferenceName] <String>]
   [[-Version] <String>]
   [-Uninstall]
   [-ForceUpdate]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureVMCustomScriptExtension
   [[-ReferenceName] <String>]
   [[-Version] <String>]
   [[-FileUri] <String[]>]
   [-Run] <String>
   [[-Argument] <String>]
   [-ForceUpdate]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

说明

Set-AzureVMCustomScriptExtension cmdlet 设置 Azure 虚拟机自定义脚本扩展的信息。

示例

示例 1：设置虚拟机自定义脚本扩展的信息

PS C:\> $VM = Set-AzureVMCustomScriptExtension -VM $VM -ContainerName "Container01" -FileName "script1.ps1","script2.ps1" -Run "script1.ps1" -Argument "arg1 arg2";
PS C:\> New-AzureVM -Location "West US" -ServiceName $SVC -VM $VM;

此命令设置虚拟机自定义脚本扩展的信息。

示例 2：使用文件路径设置虚拟机自定义脚本扩展的信息

PS C:\> Set-AzureVMCustomScriptExtension -VM $VM -FileUri "http://www.blob.core.contoso.net/bar/script1.ps1","http://www.blob.core.contoso.net/baz/script2.ps1" -Run "script1.ps1" -Argument "arg1 arg2";
PS C:\> Update-AzureVM -ServiceName $SVC -Name $Name -VM VM;

此命令使用多个文件 URL 设置虚拟机自定义脚本扩展的信息。

参数

-Argument

指定一个字符串，该字符串提供此 cmdlet 在虚拟机上运行的参数。

类型:String
Position:8
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-ContainerName

指定存储帐户中的容器名称。

类型:String
Position:2
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Disable

指示此 cmdlet 禁用扩展状态。

类型:SwitchParameter
Position:2
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-FileName

指定一个字符串数组，其中包含指定容器中 blob 文件的名称。

类型:String[]
Position:3
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-FileUri

指定包含 Blob 文件的 URL 的字符串数组。

类型:String[]
Position:2
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-ForceUpdate

指示未更新配置时，此 cmdlet 将配置重新应用到扩展。

类型:SwitchParameter
Position:9
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-InformationAction

指定此 cmdlet 如何响应信息事件。

此参数的可接受值为：

  • 继续
  • 忽略
  • 询问
  • SilentlyContinue
  • 停止
  • Suspend
类型:ActionPreference
别名:infa
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-InformationVariable

指定信息变量。

类型:String
别名:iv
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Profile

指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件，此 cmdlet 将从本地默认配置文件中读取。

类型:AzureSMProfile
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ReferenceName

指定扩展的引用名称。

此参数是一个用户定义的字符串，可用于引用扩展。 首次将扩展添加到虚拟机时指定。 对于后续更新，需要在更新扩展时指定以前使用的引用名称。 使用 Get-AzureVM cmdlet 返回分配给扩展的 ReferenceName。

类型:String
Position:0
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Run

指定此 cmdlet 由虚拟机上的扩展运行的命令。 仅支持“powershell.exe”。

类型:String
别名:RunFile, Command
Position:7
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-StorageAccountKey

指定存储帐户密钥

类型:String
Position:6
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-StorageAccountName

指定当前订阅中的存储帐户名称。

类型:String
Position:4
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-StorageEndpointSuffix

指定存储服务终结点。

类型:String
Position:5
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Uninstall

指示此 cmdlet 从虚拟机卸载自定义脚本扩展。

类型:SwitchParameter
Position:2
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Version

指定自定义脚本扩展的版本。

类型:String
Position:1
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-VM

指定持久性虚拟机对象。

类型:IPersistentVM
别名:InputObject
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False