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

Update-AzConnectedMachineExtension

模块:

Az.ConnectedMachine

用于创建或更新扩展的操作。

语法

Update-AzConnectedMachineExtension
      -MachineName <String>
      -Name <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      [-AutoUpgradeMinorVersion]
      [-EnableAutomaticUpgrade]
      [-ForceRerun <String>]
      [-ProtectedSetting <Hashtable>]
      [-Publisher <String>]
      [-Setting <Hashtable>]
      [-Tag <Hashtable>]
      [-Type <String>]
      [-TypeHandlerVersion <String>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzConnectedMachineExtension
      -MachineName <String>
      -Name <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      -JsonString <String>
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzConnectedMachineExtension
      -MachineName <String>
      -Name <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      -JsonFilePath <String>
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzConnectedMachineExtension
      -MachineName <String>
      -Name <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      -ExtensionParameter <IMachineExtensionUpdate>
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzConnectedMachineExtension
      -Name <String>
      -MachineInputObject <IConnectedMachineIdentity>
      [-AutoUpgradeMinorVersion]
      [-EnableAutomaticUpgrade]
      [-ForceRerun <String>]
      [-ProtectedSetting <Hashtable>]
      [-Publisher <String>]
      [-Setting <Hashtable>]
      [-Tag <Hashtable>]
      [-Type <String>]
      [-TypeHandlerVersion <String>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzConnectedMachineExtension
      -Name <String>
      -MachineInputObject <IConnectedMachineIdentity>
      -ExtensionParameter <IMachineExtensionUpdate>
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzConnectedMachineExtension
      -InputObject <IConnectedMachineIdentity>
      [-AutoUpgradeMinorVersion]
      [-EnableAutomaticUpgrade]
      [-ForceRerun <String>]
      [-ProtectedSetting <Hashtable>]
      [-Publisher <String>]
      [-Setting <Hashtable>]
      [-Tag <Hashtable>]
      [-Type <String>]
      [-TypeHandlerVersion <String>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzConnectedMachineExtension
      -InputObject <IConnectedMachineIdentity>
      -ExtensionParameter <IMachineExtensionUpdate>
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

用于创建或更新扩展的操作。

示例

示例 1：更新扩展

$splat = @{
    ResourceGroupName = "connectedMachines"
    MachineName = "linux-eastus1_1"
    Name = "customScript"
    Settings = @{
        commandToExecute = "ls -l"
    }
}
Update-AzConnectedMachineExtension @splat

Name         Location ProvisioningState
----         -------- -----------------
customScript eastus   Succeeded

汇报特定计算机上的扩展。

示例 2：使用通过管道指定的位置更新扩展

$extToUpdate = Get-AzConnectedMachineExtension -ResourceGroupName connectedMachines -MachineName linux-eastus1_1 -Name customScript
$extToUpdate | Update-AzConnectedMachineExtension -Settings @{
    commandToExecute = "ls -l"
}

Name         Location ProvisioningState
----         -------- -----------------
customScript eastus   Succeeded

汇报通过管道传入的特定扩展。 在这里，我们使用通过管道传入的扩展来帮助我们确定要对其操作的扩展，并指定要通过普通参数更改的内容（例如 -Settings）

示例 3：使用通过管道指定的扩展参数更新扩展

$extToUpdate = Get-AzConnectedMachineExtension -ResourceGroupName connectedMachines -MachineName linux-eastus1_1 -Name customScript
# Update the settings on the object that will be used via the pipeline
$extToUpdate.Setting.commandToExecute = "ls -l"
$splat = @{
    ResourceGroupName = "connectedMachines"
    MachineName = "linux-eastus1_1"
    Name = "customScript"
}
$extToUpdate | Update-AzConnectedMachineExtension @splat

Name         Location ProvisioningState
----         -------- -----------------
customScript eastus   Succeeded

汇报通过管道传入的特定扩展。 在这里，我们使用通过管道传入的扩展来提供要在扩展上进行的更改。 扩展的位置不是通过管道检索的，而是通过通常指定的参数（由 splat 参数）检索。

示例 4：将扩展对象用作更新的位置和参数

$extToUpdate = Get-AzConnectedMachineExtension -ResourceGroupName connectedMachines -MachineName linux-eastus1_1 -Name customScript
# Update the settings on the object that will be used via the pipeline
$extToUpdate.Setting.commandToExecute = "ls -l"
$extToUpdate | Update-AzConnectedMachineExtension -ExtensionParameter $extToUpdate

Name         Location ProvisioningState
----         -------- -----------------
customScript eastus   Succeeded

汇报通过管道传入的特定扩展。 在这里，我们使用通过管道传入的扩展来帮助我们确定要对其操作的扩展。 除此之外，我们还使用扩展对象的参数来指定要更新的内容。

参数

-AsJob

以作业身份运行命令

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AutoUpgradeMinorVersion

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableAutomaticUpgrade

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ExtensionParameter

描述计算机扩展更新。 若要构造，请参阅 EXTENSIONPARAMETER 属性的 NOTES 部分，并创建哈希表。

Type:	IMachineExtensionUpdate
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ForceRerun

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

要构造的标识参数，请参阅 INPUTOBJECT 属性的 NOTES 部分并创建哈希表。

Type:	IConnectedMachineIdentity
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-JsonFilePath

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-JsonString

提供给更新操作的 Json 字符串

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-MachineInputObject

要构造的标识参数，请参阅 MACHINEINPUTOBJECT 属性的 NOTES 部分，并创建哈希表。

Type:	IConnectedMachineIdentity
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-MachineName

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

计算机扩展的名称。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NoWait

异步运行命令

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ProtectedSetting

该扩展可以包含受保护的设置或受保护设置FromKeyVault 或根本没有受保护的设置。

Type:	Hashtable
Aliases:	ProtectedSettings
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Publisher

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Setting

扩展的 Json 格式公共设置。

Type:	Hashtable
Aliases:	Settings
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SubscriptionId

目标订阅的 ID。

Type:	String
Position:	Named
Default value:	(Get-AzContext).Subscription.Id
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

资源标记

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Type

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TypeHandlerVersion

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

IMachineExtensionUpdate

IConnectedMachineIdentity

输出

IMachineExtension