Update-AzConnectedMachineExtension
A operação para atualizar a extensão.
Sintaxe
UpdateExpanded (Padrão)
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>]
UpdateViaJsonString
Update-AzConnectedMachineExtension
-MachineName <String>
-Name <String>
-ResourceGroupName <String>
-JsonString <String>
[-SubscriptionId <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
UpdateViaJsonFilePath
Update-AzConnectedMachineExtension
-MachineName <String>
-Name <String>
-ResourceGroupName <String>
-JsonFilePath <String>
[-SubscriptionId <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Update
Update-AzConnectedMachineExtension
-MachineName <String>
-Name <String>
-ResourceGroupName <String>
-ExtensionParameter <IMachineExtensionUpdate>
[-SubscriptionId <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
UpdateViaIdentityMachineExpanded
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>]
UpdateViaIdentityMachine
Update-AzConnectedMachineExtension
-Name <String>
-MachineInputObject <IConnectedMachineIdentity>
-ExtensionParameter <IMachineExtensionUpdate>
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
UpdateViaIdentityExpanded
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>]
UpdateViaIdentity
Update-AzConnectedMachineExtension
-InputObject <IConnectedMachineIdentity>
-ExtensionParameter <IMachineExtensionUpdate>
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrição
A operação para atualizar a extensão.
Exemplos
Exemplo 1: Atualizar uma extensão
$splat = @{
ResourceGroupName = "connectedMachines"
MachineName = "linux-eastus1_1"
Name = "customScript"
Settings = @{
commandToExecute = "ls -l"
}
}
Update-AzConnectedMachineExtension @splat
Name Location ProvisioningState
---- -------- -----------------
customScript eastus Succeeded
Atualiza uma extensão em uma máquina específica.
$extToUpdate = Get-AzConnectedMachineExtension -ResourceGroupName connectedMachines -MachineName linux-eastus1_1 -Name customScript
$extToUpdate | Update-AzConnectedMachineExtension -Settings @{
commandToExecute = "ls -l"
}
Name Location ProvisioningState
---- -------- -----------------
customScript eastus Succeeded
Atualiza uma extensão específica passada através do pipeline.
Aqui estamos usando a extensão passada através do pipeline para nos ajudar a identificar em qual extensão queremos operar e estamos especificando o que queremos mudar através dos parâmetros normais (como -Settings)
$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
Atualiza uma extensão específica passada através do pipeline.
Aqui estamos usando a extensão passada através do pipeline para fornecer as alterações que queremos fazer na extensão.
A localização da extensão não é recuperada através do pipeline, mas sim através dos parâmetros especificados normalmente (pelo parâmetro splat).
Exemplo 4: Usando um objeto de extensão como o local e os parâmetros para atualização
$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
Atualiza uma extensão específica passada através do pipeline.
Aqui estamos usando a extensão passada através do pipeline para nos ajudar a identificar em qual extensão queremos operar.
Além disso, estamos usando os parâmetros do objeto de extensão para especificar o que atualizar.
Parâmetros
-AsJob
Executar o comando como um trabalho
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-AutoUpgradeMinorVersion
Indica se a extensão deve usar uma versão secundária mais recente, se uma estiver disponível no momento da implantação.
Uma vez implantada, no entanto, a extensão não atualizará versões secundárias, a menos que seja reimplantada, mesmo com essa propriedade definida como true.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
UpdateExpanded
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaIdentityMachineExpanded
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaIdentityExpanded
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None Suporta curingas: False DontShow: False Pseudónimos: Cf.
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-DefaultProfile
O parâmetro DefaultProfile não é funcional.
Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.
Propriedades dos parâmetros
Tipo: PSObject
Valor padrão: None Suporta curingas: False DontShow: False Pseudónimos: AzureRMContext, AzureCredential
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-EnableAutomaticUpgrade
Indica se a extensão deve ser atualizada automaticamente pela plataforma se houver uma versão mais recente disponível.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
UpdateExpanded
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaIdentityMachineExpanded
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaIdentityExpanded
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-ExtensionParameter
Descreve uma atualização de extensão de máquina.
Propriedades dos parâmetros
Conjuntos de parâmetros
Update
Posição: Named Obrigatório: True Valor do pipeline: True Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaIdentityMachine
Posição: Named Obrigatório: True Valor do pipeline: True Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaIdentity
Posição: Named Obrigatório: True Valor do pipeline: True Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-ForceRerun
Como o manipulador de extensão deve ser forçado a atualizar mesmo que a configuração da extensão não tenha sido alterada.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
UpdateExpanded
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaIdentityMachineExpanded
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaIdentityExpanded
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
Parâmetro de identidade
UpdateViaIdentityExpanded
Posição: Named Obrigatório: True Valor do pipeline: True Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaIdentity
Posição: Named Obrigatório: True Valor do pipeline: True Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-JsonFilePath
Caminho do arquivo Json fornecido para a operação Update
Propriedades dos parâmetros
Tipo: String
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
UpdateViaJsonFilePath
Posição: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-JsonString
Cadeia de caracteres Json fornecida para a operação Update
Propriedades dos parâmetros
Tipo: String
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
UpdateViaJsonString
Posição: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
Parâmetro de identidade
UpdateViaIdentityMachineExpanded
Posição: Named Obrigatório: True Valor do pipeline: True Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaIdentityMachine
Posição: Named Obrigatório: True Valor do pipeline: True Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-MachineName
O nome da máquina onde a extensão deve ser criada ou atualizada.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
UpdateExpanded
Posição: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaJsonString
Posição: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaJsonFilePath
Posição: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
Update
Posição: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-Name
O nome da extensão da máquina.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
UpdateExpanded
Posição: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaJsonString
Posição: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaJsonFilePath
Posição: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
Update
Posição: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaIdentityMachineExpanded
Posição: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaIdentityMachine
Posição: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-NoWait
Execute o comando de forma assíncrona
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-ProtectedSetting
A extensão pode conter protectedSettings ou protectedSettingsFromKeyVault ou nenhuma configuração protegida.
Propriedades dos parâmetros
Tipo: Hashtable
Valor padrão: None Suporta curingas: False DontShow: False Pseudónimos: ProtectedSettings
Conjuntos de parâmetros
UpdateExpanded
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaIdentityMachineExpanded
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaIdentityExpanded
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-Publisher
O nome do editor do manipulador de extensão.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
UpdateExpanded
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaIdentityMachineExpanded
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaIdentityExpanded
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-ResourceGroupName
O nome do grupo de recursos.
O nome não diferencia maiúsculas de minúsculas.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
UpdateExpanded
Posição: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaJsonString
Posição: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaJsonFilePath
Posição: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
Update
Posição: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-Setting
Json formatou configurações públicas para a extensão.
Propriedades dos parâmetros
Tipo: Hashtable
Valor padrão: None Suporta curingas: False DontShow: False Pseudónimos: Configurações
Conjuntos de parâmetros
UpdateExpanded
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaIdentityMachineExpanded
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaIdentityExpanded
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-SubscriptionId
A ID da assinatura de destino.
Propriedades dos parâmetros
Tipo: String
Valor padrão: (Get-AzContext).Subscription.Id Suporta curingas: False DontShow: False
Conjuntos de parâmetros
UpdateExpanded
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaJsonString
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaJsonFilePath
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
Update
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-Tag
Etiquetas de recursos
Propriedades dos parâmetros
Tipo: Hashtable
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
UpdateExpanded
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaIdentityMachineExpanded
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaIdentityExpanded
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-Type
Especifica o tipo da extensão; um exemplo é "CustomScriptExtension".
Propriedades dos parâmetros
Tipo: String
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
UpdateExpanded
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaIdentityMachineExpanded
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaIdentityExpanded
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-TypeHandlerVersion
Especifica a versão do manipulador de script.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None Suporta curingas: False DontShow: False
Conjuntos de parâmetros
UpdateExpanded
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaIdentityMachineExpanded
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
UpdateViaIdentityExpanded
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado.
O cmdlet não é executado.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None Suporta curingas: False DontShow: False Pseudónimos: Wi
Conjuntos de parâmetros
(All)
Posição: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome da propriedade: False Valor dos argumentos restantes: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters .
Saídas
