Update-AzConnectedMachineExtension

Modul:

Az.ConnectedMachine

A bővítmény létrehozásához vagy frissítéséhez szükséges művelet.

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

A bővítmény létrehozásához vagy frissítéséhez szükséges művelet.

Példák

1. példa: Bővítmény frissítése

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

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

Frissítések egy adott gépen lévő bővítményt.

2. példa: Bővítmény frissítése a folyamaton keresztül megadott helyre

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

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

Frissítések egy adott bővítményt, amely a folyamaton keresztül lett átadva. Az alábbiakban a folyamaton keresztül átadott bővítményt használjuk annak azonosításához, hogy melyik bővítményen szeretnénk működni, és hogy a normál paraméterekkel (például -Settings) mit szeretnénk módosítani.

3. példa: Bővítmény frissítése a folyamaton keresztül megadott bővítményparaméterekkel

$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

Frissítések egy adott bővítményt, amely a folyamaton keresztül lett átadva. Itt a folyamaton keresztül átadott bővítményt használjuk a bővítményen végrehajtani kívánt módosítások biztosítására. A bővítmény helyét nem a folyamaton keresztül kéri le a rendszer, hanem a normál módon megadott paramétereken keresztül (a splat paraméter alapján).

4. példa: Bővítményobjektum használata helyként és paraméterekként a frissítéshez

$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

Frissítések egy adott bővítményt, amely a folyamaton keresztül lett átadva. Az alábbiakban a folyamaton keresztül átadott bővítményt használjuk annak azonosításához, hogy melyik bővítményen szeretnénk működni. Emellett a bővítményobjektum paramétereit használjuk a frissítési cél megadásához.

Paraméterek

-AsJob

A parancs futtatása feladatként

Típus:	SwitchParameter
Position:	Named
alapértelmezett érték:	None
Kötelező:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AutoUpgradeMinorVersion

Azt jelzi, hogy a bővítménynek egy újabb alverziót kell-e használnia, ha az üzembe helyezéskor elérhető. Az üzembe helyezés után azonban a bővítmény csak akkor frissíti az alverziókat, ha újra üzembe helyezi, még akkor sem, ha ez a tulajdonság igaz értékre van állítva.

Típus:	SwitchParameter
Position:	Named
alapértelmezett érték:	None
Kötelező:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Típus:	SwitchParameter
Aliases:	cf
Position:	Named
alapértelmezett érték:	None
Kötelező:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

A DefaultProfile paraméter nem működik. Ha a parancsmagot egy másik előfizetésen hajtja végre, használja az SubscriptionId paramétert, ha elérhető.

Típus:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
alapértelmezett érték:	None
Kötelező:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableAutomaticUpgrade

Azt jelzi, hogy a bővítményt automatikusan frissítenie kell-e a platformnak, ha újabb verzió érhető el.

Típus:	SwitchParameter
Position:	Named
alapértelmezett érték:	None
Kötelező:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ExtensionParameter

Egy gépbővítmény frissítését ismerteti.

Típus:	IMachineExtensionUpdate
Position:	Named
alapértelmezett érték:	None
Kötelező:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ForceRerun

Hogyan kell a bővítménykezelőt frissíteni, még akkor is, ha a bővítménykonfiguráció nem változott.

Típus:	String
Position:	Named
alapértelmezett érték:	None
Kötelező:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Identitásparaméter

Típus:	IConnectedMachineIdentity
Position:	Named
alapértelmezett érték:	None
Kötelező:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-JsonFilePath

A frissítési művelethez megadott Json-fájl elérési útja

Típus:	String
Position:	Named
alapértelmezett érték:	None
Kötelező:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-JsonString

A frissítési művelethez megadott Json-sztring

Típus:	String
Position:	Named
alapértelmezett érték:	None
Kötelező:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-MachineInputObject

Identitásparaméter

Típus:	IConnectedMachineIdentity
Position:	Named
alapértelmezett érték:	None
Kötelező:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-MachineName

Annak a gépnek a neve, ahol a bővítményt létre kell hozni vagy frissíteni kell.

Típus:	String
Position:	Named
alapértelmezett érték:	None
Kötelező:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

A gép bővítményének neve.

Típus:	String
Position:	Named
alapértelmezett érték:	None
Kötelező:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NoWait

A parancs aszinkron futtatása

Típus:	SwitchParameter
Position:	Named
alapértelmezett érték:	None
Kötelező:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ProtectedSetting

A bővítmény tartalmazhat védett Gépház vagy védett Gépház FromKeyVault vagy egyáltalán nem védett beállításokat.

Típus:	Hashtable
Aliases:	ProtectedSettings
Position:	Named
alapértelmezett érték:	None
Kötelező:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Publisher

A bővítménykezelő közzétevőjének neve.

Típus:	String
Position:	Named
alapértelmezett érték:	None
Kötelező:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.

Típus:	String
Position:	Named
alapértelmezett érték:	None
Kötelező:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Setting

Json formátumú nyilvános beállítások a bővítményhez.

Típus:	Hashtable
Aliases:	Settings
Position:	Named
alapértelmezett érték:	None
Kötelező:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SubscriptionId

A cél-előfizetés azonosítója.

Típus:	String
Position:	Named
alapértelmezett érték:	(Get-AzContext).Subscription.Id
Kötelező:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

Erőforráscímkék

Típus:	Hashtable
Position:	Named
alapértelmezett érték:	None
Kötelező:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Type

Megadja a bővítmény típusát; Ilyen például a "CustomScriptExtension".

Típus:	String
Position:	Named
alapértelmezett érték:	None
Kötelező:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TypeHandlerVersion

A szkriptkezelő verzióját adja meg.

Típus:	String
Position:	Named
alapértelmezett érték:	None
Kötelező:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Típus:	SwitchParameter
Aliases:	wi
Position:	Named
alapértelmezett érték:	None
Kötelező:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Bevitelek

IConnectedMachineIdentity

IMachineExtensionUpdate

Kimenetek

IMachineExtension