Set-AzConnectedMachineExtension

Sintaxis

UpdateExpanded (valor predeterminado)

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

Ejemplos

Ejemplo 1: Establecer una extensión en un equipo

$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

Ejemplo 2: Establecimiento de una extensión con parámetros de extensión especificados a través de la canalización

$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

Ejecución del comando como trabajo

Propiedades de parámetro

Conjuntos de parámetros

-AutoUpgradeMinorVersion

Indica si la extensión debe usar una versión secundaria más reciente si está disponible en el momento de la implementación. Sin embargo, una vez implementada, la extensión no actualizará las versiones secundarias a menos que se vuelva a implementar, incluso con esta propiedad establecida en true.

Propiedades de parámetro

Conjuntos de parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Conjuntos de parámetros

-DefaultProfile

El parámetro DefaultProfile no es funcional. Use el parámetro SubscriptionId cuando esté disponible si ejecuta el cmdlet en otra suscripción.

Propiedades de parámetro

Conjuntos de parámetros

-EnableAutomaticUpgrade

Indica si la plataforma debe actualizar automáticamente la extensión si hay una versión más reciente disponible.

Propiedades de parámetro

Conjuntos de parámetros

-ExtensionParameter

Describe una extensión de máquina.

Propiedades de parámetro

Conjuntos de parámetros

-ExtensionType

Especifica el tipo de la extensión; Un ejemplo es "CustomScriptExtension".

Propiedades de parámetro

Conjuntos de parámetros

-ForceRerun

Cómo se debe forzar el controlador de extensión para actualizar incluso si la configuración de la extensión no ha cambiado.

Propiedades de parámetro

Conjuntos de parámetros

-InstanceViewName

Nombre de la extensión del equipo.

Propiedades de parámetro

Conjuntos de parámetros

-InstanceViewType

Especifica el tipo de la extensión; Un ejemplo es "CustomScriptExtension".

Propiedades de parámetro

Conjuntos de parámetros

-InstanceViewTypeHandlerVersion

Especifica la versión del controlador de script.

Propiedades de parámetro

Conjuntos de parámetros

-JsonFilePath

Ruta de acceso del archivo Json proporcionado a la operación de actualización

Propiedades de parámetro

Conjuntos de parámetros

-JsonString

Cadena JSON proporcionada a la operación de actualización

Propiedades de parámetro

Conjuntos de parámetros

-Location

Ubicación geográfica donde reside el recurso

Propiedades de parámetro

Conjuntos de parámetros

-MachineName

Nombre del equipo donde se debe crear o actualizar la extensión.

Propiedades de parámetro

Conjuntos de parámetros

-Name

Nombre de la extensión del equipo.

Propiedades de parámetro

Conjuntos de parámetros

-NoWait

Ejecutar el comando de forma asincrónica

Propiedades de parámetro

Conjuntos de parámetros

-ProtectedSetting

La extensión puede contener protectedSettings o protectedSettingsFromKeyVault o ninguna configuración protegida.

Propiedades de parámetro

Conjuntos de parámetros

-Publisher

Nombre del publicador de controladores de extensión.

Propiedades de parámetro

Conjuntos de parámetros

-ResourceGroupName

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

Propiedades de parámetro

Conjuntos de parámetros

-Setting

Configuración pública con formato JSON para la extensión.

Propiedades de parámetro

Conjuntos de parámetros

-StatusCode

Código de estado.

Propiedades de parámetro

Conjuntos de parámetros

-StatusDisplayStatus

Etiqueta localizable corta para el estado.

Propiedades de parámetro

Conjuntos de parámetros

-StatusLevel

Código de nivel.

Propiedades de parámetro

Conjuntos de parámetros

-StatusMessage

Mensaje de estado detallado, incluido para alertas y mensajes de error.

Propiedades de parámetro

Conjuntos de parámetros

-StatusTime

Hora del estado.

Propiedades de parámetro

Conjuntos de parámetros

-SubscriptionId

Identificador de la suscripción de destino.

Propiedades de parámetro

Conjuntos de parámetros

-Tag

Etiquetas de recursos.

Propiedades de parámetro

Conjuntos de parámetros

-TypeHandlerVersion

Especifica la versión del controlador de script.

Propiedades de parámetro

Conjuntos de parámetros

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Propiedades de parámetro

Conjuntos de parámetros

CommonParameters

Entradas

IMachineExtension

Salidas

IMachineExtension