Update-AzConnectedMachineExtension

Modul:

Az.ConnectedMachine

Operace aktualizace rozšíření.

Syntaxe

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

Operace aktualizace rozšíření.

Příklady

Příklad 1: Aktualizace rozšíření

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

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

Aktualizuje rozšíření na konkrétním počítači.

Příklad 2: Aktualizace rozšíření s umístěním zadaným prostřednictvím kanálu

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

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

Aktualizuje konkrétní rozšíření předané prostřednictvím kanálu. Tady používáme rozšíření předané prostřednictvím kanálu, abychom mohli určit, se kterým rozšířením chceme pracovat, a určujeme, na čem chceme změnit normální parametry (například -Settings).

Příklad 3: Aktualizace rozšíření s parametry rozšíření zadanými prostřednictvím kanálu

$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

Aktualizuje konkrétní rozšíření předané prostřednictvím kanálu. Tady používáme rozšíření předané kanálem k poskytnutí změn, které chceme v rozšíření provést. Umístění rozšíření se nečte prostřednictvím kanálu, ale spíše prostřednictvím parametrů určených normálně (parametrem splat).

Příklad 4: Použití objektu rozšíření jako umístění i parametrů pro aktualizaci

$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

Aktualizuje konkrétní rozšíření předané prostřednictvím kanálu. Tady používáme rozšíření předávané prostřednictvím kanálu, abychom mohli zjistit, na kterém rozšíření chceme pracovat. Kromě toho používáme parametry objektu rozšíření k určení, co se má aktualizovat.

Parametry

-AsJob

Spuštění příkazu jako úlohy

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-AutoUpgradeMinorVersion

Určuje, jestli má rozšíření používat novější podverzi, pokud je k dispozici v době nasazení. Po nasazení však rozšíření neupgraduje podverze, pokud se znovu nenasadí, a to ani s touto vlastností nastavenou na true.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DefaultProfile

Parametr DefaultProfile není funkční. Pokud je k dispozici spuštění rutiny pro jiné předplatné, použijte parametr SubscriptionId.

Typ:	PSObject
Aliasy:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-EnableAutomaticUpgrade

Označuje, jestli má být rozšíření automaticky upgradováno platformou, pokud je k dispozici novější verze.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ExtensionParameter

Popisuje aktualizaci rozšíření počítače.

Typ:	IMachineExtensionUpdate
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ForceRerun

Způsob vynucení aktualizace obslužné rutiny rozšíření i v případě, že se konfigurace rozšíření nezměnila.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-InputObject

Parametr identity

Typ:	IConnectedMachineIdentity
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-JsonFilePath

Cesta k souboru JSON zadanému pro operaci aktualizace

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-JsonString

Řetězec JSON zadaný pro operaci aktualizace

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-MachineInputObject

Parametr identity

Typ:	IConnectedMachineIdentity
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-MachineName

Název počítače, ve kterém se má rozšíření vytvořit nebo aktualizovat.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Name

Název rozšíření počítače.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-NoWait

Asynchronní spuštění příkazu

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ProtectedSetting

Rozšíření může obsahovat buď protectedSettings, nebo protectedSettingsFromKeyVault, nebo vůbec žádná chráněná nastavení.

Typ:	Hashtable
Aliasy:	ProtectedSettings
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Publisher

Název vydavatele obslužné rutiny rozšíření.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ResourceGroupName

Název skupiny prostředků. Název nerozlišuje malá a velká písmena.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Setting

Veřejná nastavení formátovaná json pro rozšíření

Typ:	Hashtable
Aliasy:	Settings
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SubscriptionId

ID cílového předplatného.

Typ:	String
Position:	Named
Default value:	(Get-AzContext).Subscription.Id
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Tag

Značky prostředků

Typ:	Hashtable
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Type

Určuje typ rozšíření; Příkladem je CustomScriptExtension.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-TypeHandlerVersion

Určuje verzi obslužné rutiny skriptu.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

IConnectedMachineIdentity

IMachineExtensionUpdate

Výstupy

IMachineExtension