Set-AzConnectedMachineExtension

Sintaxe

UpdateExpanded (Default)

Set-AzConnectedMachineExtension
    -MachineName <String>
    -Name <String>
    -ResourceGroupName <String>
    -Location <String>
    [-SubscriptionId <String>]
    [-AutoUpgradeMinorVersion]
    [-EnableAutomaticUpgrade]
    [-ExtensionType <String>]
    [-ForceRerun <String>]
    [-InstanceViewName <String>]
    [-InstanceViewType <String>]
    [-InstanceViewTypeHandlerVersion <String>]
    [-ProtectedSetting <Hashtable>]
    [-Publisher <String>]
    [-Setting <Hashtable>]
    [-StatusCode <String>]
    [-StatusDisplayStatus <String>]
    [-StatusLevel <String>]
    [-StatusMessage <String>]
    [-StatusTime <DateTime>]
    [-Tag <Hashtable>]
    [-TypeHandlerVersion <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Update

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

UpdateViaJsonFilePath

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

UpdateViaJsonString

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

Description

Exemplos

Exemplo 1: Definir uma extensão em um computador

$Settings = @{ "commandToExecute" = "powershell.exe -c Get-Process" }
Set-AzConnectedMachineExtension -Name custom -ResourceGroupName ContosoTest -MachineName win-eastus1 -Location eastus -Publisher "Microsoft.Compute" -TypeHandlerVersion 1.10 -Settings $Settings -ExtensionType CustomScriptExtension

Name   Location ProvisioningState
----   -------- -----------------
custom eastus   Succeeded

Exemplo 2: Definir uma extensão com parâmetros de extensão especificados por meio do pipeline

$otherExtension = Get-AzConnectedMachineExtension -Name custom -ResourceGroupName ContosoTest -MachineName other
$otherExtension | Set-AzConnectedMachineExtension -Name custom -ResourceGroupName ContosoTest -MachineName important

Name   Location ProvisioningState
----   -------- -----------------
custom eastus   Succeeded

Parâmetros

-AsJob

Executar o comando como um trabalho

Propriedades do parâmetro

Conjuntos de parâmetros

-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 do parâmetro

Conjuntos de parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Conjuntos de parâmetros

-DefaultProfile

O parâmetro DefaultProfile não está funcional. Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.

Propriedades do parâmetro

Conjuntos de parâmetros

-EnableAutomaticUpgrade

Indica se a extensão deve ser atualizada automaticamente pela plataforma se houver uma versão mais recente disponível.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExtensionParameter

Descreve uma extensão de máquina.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExtensionType

Especifica o tipo da extensão; um exemplo é "CustomScriptExtension".

Propriedades do parâmetro

Conjuntos de parâmetros

-ForceRerun

Como o manipulador de extensão deve ser forçado a atualizar mesmo que a configuração de extensão não tenha sido alterada.

Propriedades do parâmetro

Conjuntos de parâmetros

-InstanceViewName

O nome da extensão do computador.

Propriedades do parâmetro

Conjuntos de parâmetros

-InstanceViewType

Especifica o tipo da extensão; um exemplo é "CustomScriptExtension".

Propriedades do parâmetro

Conjuntos de parâmetros

-InstanceViewTypeHandlerVersion

Especifica a versão do manipulador de script.

Propriedades do parâmetro

Conjuntos de parâmetros

-JsonFilePath

Caminho do arquivo Json fornecido para a operação Update

Propriedades do parâmetro

Conjuntos de parâmetros

-JsonString

Cadeia de caracteres Json fornecida para a operação Update

Propriedades do parâmetro

Conjuntos de parâmetros

-Location

A localização geográfica onde o recurso reside

Propriedades do parâmetro

Conjuntos de parâmetros

-MachineName

O nome do computador em que a extensão deve ser criada ou atualizada.

Propriedades do parâmetro

Conjuntos de parâmetros

-Name

O nome da extensão do computador.

Propriedades do parâmetro

Conjuntos de parâmetros

-NoWait

Execute o comando de forma assíncrona

Propriedades do parâmetro

Conjuntos de parâmetros

-ProtectedSetting

A extensão pode conter protectedSettings ou protectedSettingsFromKeyVault ou nenhuma configuração protegida.

Propriedades do parâmetro

Conjuntos de parâmetros

-Publisher

O nome do editor do manipulador de extensão.

Propriedades do parâmetro

Conjuntos de parâmetros

-ResourceGroupName

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

Propriedades do parâmetro

Conjuntos de parâmetros

-Setting

Configurações públicas formatadas em Json para a extensão.

Propriedades do parâmetro

Conjuntos de parâmetros

-StatusCode

O código de status.

Propriedades do parâmetro

Conjuntos de parâmetros

-StatusDisplayStatus

O rótulo localizável curto para o status.

Propriedades do parâmetro

Conjuntos de parâmetros

-StatusLevel

O código de nível.

Propriedades do parâmetro

Conjuntos de parâmetros

-StatusMessage

A mensagem de status detalhada, inclusive para alertas e mensagens de erro.

Propriedades do parâmetro

Conjuntos de parâmetros

-StatusTime

A hora do status.

Propriedades do parâmetro

Conjuntos de parâmetros

-SubscriptionId

A ID da assinatura de destino.

Propriedades do parâmetro

Conjuntos de parâmetros

-Tag

Tags de recursos.

Propriedades do parâmetro

Conjuntos de parâmetros

-TypeHandlerVersion

Especifica a versão do manipulador de script.

Propriedades do parâmetro

Conjuntos de parâmetros

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades do parâmetro

Conjuntos de parâmetros

CommonParameters

Entradas

IMachineExtension

Saídas

IMachineExtension