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

Update-AzScVmmVMExtension

用于更新扩展的作。

语法

Update-AzScVmmVMExtension
      -ExtensionName <String>
      -vmName <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      [-Publisher <String>]
      [-Setting <Hashtable>]
      [-ProtectedSetting <Hashtable>]
      [-Type <String>]
      [-TypeHandlerVersion <String>]
      [-AutoUpgradeMinorVersion]
      [-EnableAutomaticUpgrade]
      [-ForceUpdateTag <String>]
      [-Tag <Hashtable>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzScVmmVMExtension
      -ExtensionName <String>
      -vmName <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      -JsonString <String>
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzScVmmVMExtension
      -ExtensionName <String>
      -vmName <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      -JsonFilePath <String>
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

用于更新扩展的作。

示例

示例 1:更新扩展

Update-AzScVmmVMExtension -vmName 'test-vm' -ResourceGroupName 'test-rg-01' -ExtensionName 'RunCommand' -Setting @{"commandToExecute"="echo %SYSTEMROOT%"}

AutoUpgradeMinorVersion        : False
EnableAutomaticUpgrade         : True
ForceUpdateTag                 :
Id                             : /subscriptions/00000000-abcd-0000-abcd-000000000000/resourceGroups/test-rg-01/providers/Microsoft.HybridCompute/machines/test-vm/extensions/RunCommand
InstanceViewName               : RunCommand
InstanceViewType               : CustomScriptExtension
InstanceViewTypeHandlerVersion : 1.10.20
Location                       : eastus
Name                           : RunCommand
PropertiesType                 : CustomScriptExtension
ProtectedSetting               : {
                                 }
ProvisioningState              : Succeeded
Publisher                      : Microsoft.Compute
ResourceGroupName              : test-rg-01
Setting                        : {
                                   "commandToExecute": "echo %SYSTEMROOT%"
                                 }
StatusCode                     : 0
StatusDisplayStatus            :
StatusLevel                    : Information
StatusMessage                  : Extension Message: , StdOut: C:\Windows

StatusTime                     :
SystemDataCreatedAt            :
SystemDataCreatedBy            :
SystemDataCreatedByType        :
SystemDataLastModifiedAt       :
SystemDataLastModifiedBy       :
SystemDataLastModifiedByType   :
Tag                            : {
                                 }
Type                           : Microsoft.HybridCompute/machines/extensions
TypeHandlerVersion             : 1.10.20

更新 VM 扩展。

参数

-AsJob

以作业身份运行命令

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

-AutoUpgradeMinorVersion

指示扩展是否应在部署时使用较新的次要版本。 但是,部署后,除非重新部署,否则扩展不会升级次要版本,即使此属性设置为 true 也是如此。

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

-Confirm

在运行 cmdlet 之前,提示你进行确认。

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

-DefaultProfile

DefaultProfile 参数不起作用。 如果对其他订阅执行 cmdlet,请使用 SubscriptionId 参数。

类型:PSObject
别名:AzureRMContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-EnableAutomaticUpgrade

指示如果有较新版本可用,平台是否应自动升级扩展。

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

-ExtensionName

计算机扩展的名称。

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

-ForceUpdateTag

即使扩展配置未更改,扩展处理程序也应强制更新。

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

-JsonFilePath

提供给更新作的 Json 文件的路径

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

-JsonString

提供给更新作的 Json 字符串

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

-NoWait

异步运行命令

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

-ProtectedSetting

该扩展可以包含 protectedSettings 或 protectedSettingsFromKeyVault,或者根本不包含受保护的设置。

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

-Publisher

扩展处理程序发布者的名称。

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

-ResourceGroupName

资源组的名称。 名称不区分大小写。

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

-Setting

扩展的 Json 格式公共设置。

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

-SubscriptionId

目标订阅的 ID。 该值必须是 UUID。

类型:String
Position:Named
默认值:(Get-AzContext).Subscription.Id
必需:False
接受管道输入:False
接受通配符:False

-Tag

资源标记

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

-Type

指定扩展的类型;例如“CustomScriptExtension”。

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

-TypeHandlerVersion

指定脚本处理程序的版本。

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

-vmName

应在其中创建或更新扩展的计算机的名称。

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

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

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

输出