Update-AzConnectedMachineExtension
Operace aktualizace rozšíření.
Syntax
UpdateExpanded (Výchozí)
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>]
UpdateViaJsonString
Update-AzConnectedMachineExtension
-MachineName <String>
-Name <String>
-ResourceGroupName <String>
-JsonString <String>
[-SubscriptionId <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
UpdateViaJsonFilePath
Update-AzConnectedMachineExtension
-MachineName <String>
-Name <String>
-ResourceGroupName <String>
-JsonFilePath <String>
[-SubscriptionId <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Update
Update-AzConnectedMachineExtension
-MachineName <String>
-Name <String>
-ResourceGroupName <String>
-ExtensionParameter <IMachineExtensionUpdate>
[-SubscriptionId <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
UpdateViaIdentityMachineExpanded
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>]
UpdateViaIdentityMachine
Update-AzConnectedMachineExtension
-Name <String>
-MachineInputObject <IConnectedMachineIdentity>
-ExtensionParameter <IMachineExtensionUpdate>
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
UpdateViaIdentityExpanded
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>]
UpdateViaIdentity
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, na kterém rozšíření 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
Vlastnosti parametru
Typ: SwitchParameter
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
(All)
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: 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.
Vlastnosti parametru
Typ: SwitchParameter
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
UpdateExpanded
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaIdentityMachineExpanded
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaIdentityExpanded
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-Confirm
Před spuštěním cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
Typ: SwitchParameter
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Aliasy: viz
Sady parametrů
(All)
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-DefaultProfile
Parametr DefaultProfile není funkční.
Pokud je k dispozici spuštění rutiny pro jiné předplatné, použijte parametr SubscriptionId.
Vlastnosti parametru
Typ: PSObject
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Aliasy: AzureRMContext, AzureCredential
Sady parametrů
(All)
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-EnableAutomaticUpgrade
Označuje, jestli má být rozšíření automaticky upgradováno platformou, pokud je k dispozici novější verze.
Vlastnosti parametru
Typ: SwitchParameter
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
UpdateExpanded
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaIdentityMachineExpanded
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaIdentityExpanded
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-ExtensionParameter
Popisuje aktualizaci rozšíření počítače.
Vlastnosti parametru
Sady parametrů
Update
Position: Named
Povinné: True
Hodnota z kanálu: True
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaIdentityMachine
Position: Named
Povinné: True
Hodnota z kanálu: True
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaIdentity
Position: Named
Povinné: True
Hodnota z kanálu: True
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-ForceRerun
Způsob vynucení aktualizace obslužné rutiny rozšíření i v případě, že se konfigurace rozšíření nezměnila.
Vlastnosti parametru
Typ: String
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
UpdateExpanded
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaIdentityMachineExpanded
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaIdentityExpanded
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
Parametr identity
UpdateViaIdentityExpanded
Position: Named
Povinné: True
Hodnota z kanálu: True
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaIdentity
Position: Named
Povinné: True
Hodnota z kanálu: True
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-JsonFilePath
Cesta k souboru JSON zadanému pro operaci aktualizace
Vlastnosti parametru
Typ: String
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
UpdateViaJsonFilePath
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-JsonString
Řetězec JSON zadaný pro operaci aktualizace
Vlastnosti parametru
Typ: String
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
UpdateViaJsonString
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
Parametr identity
UpdateViaIdentityMachineExpanded
Position: Named
Povinné: True
Hodnota z kanálu: True
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaIdentityMachine
Position: Named
Povinné: True
Hodnota z kanálu: True
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-MachineName
Název počítače, ve kterém se má rozšíření vytvořit nebo aktualizovat.
Vlastnosti parametru
Typ: String
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
UpdateExpanded
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaJsonString
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaJsonFilePath
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
Update
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-Name
Název rozšíření počítače.
Vlastnosti parametru
Typ: String
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
UpdateExpanded
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaJsonString
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaJsonFilePath
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
Update
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaIdentityMachineExpanded
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaIdentityMachine
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-NoWait
Asynchronní spuštění příkazu
Vlastnosti parametru
Typ: SwitchParameter
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
(All)
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-ProtectedSetting
Rozšíření může obsahovat buď protectedSettings, nebo protectedSettingsFromKeyVault, nebo vůbec žádná chráněná nastavení.
Vlastnosti parametru
Typ: Hashtable
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Aliasy: ProtectedSettings
Sady parametrů
UpdateExpanded
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaIdentityMachineExpanded
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaIdentityExpanded
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-Publisher
Název vydavatele obslužné rutiny rozšíření.
Vlastnosti parametru
Typ: String
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
UpdateExpanded
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaIdentityMachineExpanded
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaIdentityExpanded
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-ResourceGroupName
Název skupiny prostředků.
Název nerozlišuje malá a velká písmena.
Vlastnosti parametru
Typ: String
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
UpdateExpanded
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaJsonString
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaJsonFilePath
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
Update
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-Setting
Veřejná nastavení formátovaná json pro rozšíření
Vlastnosti parametru
Typ: Hashtable
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Aliasy: Nastavení
Sady parametrů
UpdateExpanded
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaIdentityMachineExpanded
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaIdentityExpanded
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-SubscriptionId
ID cílového předplatného.
Vlastnosti parametru
Typ: String
Default value: (Get-AzContext).Subscription.Id
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
UpdateExpanded
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaJsonString
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaJsonFilePath
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
Update
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-Tag
Štítky prostředků
Vlastnosti parametru
Typ: Hashtable
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
UpdateExpanded
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaIdentityMachineExpanded
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaIdentityExpanded
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-Type
Určuje typ rozšíření; Příkladem je CustomScriptExtension.
Vlastnosti parametru
Typ: String
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
UpdateExpanded
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaIdentityMachineExpanded
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaIdentityExpanded
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-TypeHandlerVersion
Určuje verzi obslužné rutiny skriptu.
Vlastnosti parametru
Typ: String
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
UpdateExpanded
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaIdentityMachineExpanded
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
UpdateViaIdentityExpanded
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-WhatIf
Ukazuje, co se stane, když se příkaz spustí.
Příkazový modul nebyl spuštěn.
Vlastnosti parametru
Typ: SwitchParameter
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Aliasy: Wi
Sady parametrů
(All)
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters .
Výstupy