Update-AzConnectedMachineExtension

Module:

Az.ConnectedMachine

De bewerking voor het maken of bijwerken van de extensie.

Syntax

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>]

Description

De bewerking voor het maken of bijwerken van de extensie.

Voorbeelden

Voorbeeld 1: Een extensie bijwerken

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

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

Hiermee werkt u een extensie op een specifieke computer bij.

Voorbeeld 2: Een extensie bijwerken met de locatie die is opgegeven via de pijplijn

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

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

Hiermee wordt een specifieke extensie bijgewerkt die via de pijplijn is doorgegeven. Hier gebruiken we de extensie die via de pijplijn is doorgegeven om ons te helpen bepalen op welke extensie we willen werken en geven we op wat we willen wijzigen via de normale parameters (zoals -Settings)

Voorbeeld 3: Een extensie bijwerken met extensieparameters die zijn opgegeven via de pijplijn

$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

Hiermee wordt een specifieke extensie bijgewerkt die via de pijplijn is doorgegeven. Hier gebruiken we de extensie die via de pijplijn is doorgegeven om de wijzigingen op te geven die we voor de extensie willen aanbrengen. De locatie van de extensie wordt niet opgehaald via de pijplijn, maar via de parameters die normaal zijn opgegeven (door de parameter splat).

Voorbeeld 4: Een extensieobject gebruiken als de locatie en parameters voor het bijwerken

$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

Hiermee wordt een specifieke extensie bijgewerkt die via de pijplijn is doorgegeven. Hier gebruiken we de extensie die via de pijplijn is doorgegeven om ons te helpen bepalen op welke extensie we willen werken. Daarnaast gebruiken we de parameters van het extensieobject om op te geven wat er moet worden bijgewerkt.

Parameters

-AsJob

De opdracht uitvoeren als een taak

Type:	SwitchParameter
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AutoUpgradeMinorVersion

Geeft aan of de extensie een nieuwere secundaire versie moet gebruiken als deze beschikbaar is tijdens de implementatie. Zodra de extensie eenmaal is geïmplementeerd, worden er echter geen secundaire versies bijgewerkt, tenzij deze opnieuw wordt geïmplementeerd, zelfs niet als deze eigenschap is ingesteld op true.

Type:	SwitchParameter
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

De parameter DefaultProfile is niet functioneel. Gebruik de parameter SubscriptionId indien beschikbaar als u de cmdlet uitvoert voor een ander abonnement.

Type:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableAutomaticUpgrade

Geeft aan of de extensie automatisch moet worden bijgewerkt door het platform als er een nieuwere versie beschikbaar is.

Type:	SwitchParameter
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ExtensionParameter

Beschrijft een update van de machineextensie.

Type:	IMachineExtensionUpdate
Position:	Named
standaardwaarde:	None
Vereist:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ForceRerun

Hoe de extensie-handler moet worden gedwongen om bij te werken, zelfs als de extensieconfiguratie niet is gewijzigd.

Type:	String
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Identiteitsparameter

Type:	IConnectedMachineIdentity
Position:	Named
standaardwaarde:	None
Vereist:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-JsonFilePath

Pad van het Json-bestand dat is opgegeven bij de updatebewerking

Type:	String
Position:	Named
standaardwaarde:	None
Vereist:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-JsonString

Json-tekenreeks die is opgegeven bij de updatebewerking

Type:	String
Position:	Named
standaardwaarde:	None
Vereist:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-MachineInputObject

Identiteitsparameter

Type:	IConnectedMachineIdentity
Position:	Named
standaardwaarde:	None
Vereist:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-MachineName

De naam van de computer waarop de extensie moet worden gemaakt of bijgewerkt.

Type:	String
Position:	Named
standaardwaarde:	None
Vereist:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

De naam van de computerextensie.

Type:	String
Position:	Named
standaardwaarde:	None
Vereist:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NoWait

De opdracht asynchroon uitvoeren

Type:	SwitchParameter
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ProtectedSetting

De extensie kan beveiligde Instellingen of beveiligde Instellingen FromKeyVault of helemaal geen beveiligde instellingen bevatten.

Type:	Hashtable
Aliases:	ProtectedSettings
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Publisher

De naam van de uitgever van de extensie-handler.

Type:	String
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.

Type:	String
Position:	Named
standaardwaarde:	None
Vereist:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Setting

In Json opgemaakte openbare instellingen voor de extensie.

Type:	Hashtable
Aliases:	Settings
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SubscriptionId

De id van het doelabonnement.

Type:	String
Position:	Named
standaardwaarde:	(Get-AzContext).Subscription.Id
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

Resourcetags

Type:	Hashtable
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Type

Hiermee geeft u het type van de extensie; een voorbeeld is CustomScriptExtension.

Type:	String
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TypeHandlerVersion

Hiermee geeft u de versie van de scripthandler.

Type:	String
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Invoerwaarden

IConnectedMachineIdentity

IMachineExtensionUpdate

Uitvoerwaarden

IMachineExtension