Update-AzConnectedMachineExtension
Der Vorgang zum Aktualisieren der Erweiterung.
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>]
Beschreibung
Der Vorgang zum Aktualisieren der Erweiterung.
Beispiele
Beispiel 1: Aktualisieren einer Erweiterung
$splat = @{
ResourceGroupName = "connectedMachines"
MachineName = "linux-eastus1_1"
Name = "customScript"
Settings = @{
commandToExecute = "ls -l"
}
}
Update-AzConnectedMachineExtension @splat
Name Location ProvisioningState
---- -------- -----------------
customScript eastus Succeeded
Aktualisiert eine Erweiterung auf einem bestimmten Computer.
Beispiel 2: Aktualisieren einer Erweiterung mit Standort, der über die Pipeline angegeben ist
$extToUpdate = Get-AzConnectedMachineExtension -ResourceGroupName connectedMachines -MachineName linux-eastus1_1 -Name customScript
$extToUpdate | Update-AzConnectedMachineExtension -Settings @{
commandToExecute = "ls -l"
}
Name Location ProvisioningState
---- -------- -----------------
customScript eastus Succeeded
Aktualisiert eine bestimmte Erweiterung, die über die Pipeline übergeben wird.
Hier verwenden wir die über die Pipeline übergebene Erweiterung, um zu ermitteln, an welcher Erweiterung wir arbeiten möchten, und geben an, was wir über die normalen Parameter ändern möchten (z. B. -Settings
)
Beispiel 3: Aktualisieren einer Erweiterung mit Erweiterungsparametern, die über die Pipeline angegeben sind
$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
Aktualisiert eine bestimmte Erweiterung, die über die Pipeline übergeben wird. Hier verwenden wir die über die Pipeline übergebene Erweiterung, um die Änderungen bereitzustellen, die wir an der Erweiterung vornehmen möchten. Die Position der Erweiterung wird nicht über die Pipeline abgerufen, sondern über die normal angegebenen Parameter (durch den Parameter splat).
Beispiel 4: Verwenden eines Erweiterungsobjekts als Speicherort und Parameter für die Aktualisierung
$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
Aktualisiert eine bestimmte Erweiterung, die über die Pipeline übergeben wird. Hier verwenden wir die über die Pipeline übergebene Erweiterung, um zu ermitteln, welche Erweiterung wir betreiben möchten. Darüber hinaus verwenden wir die Parameter des Erweiterungsobjekts, um anzugeben, was aktualisiert werden soll.
Parameter
-AsJob
Ausführen des Befehls als Auftrag
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-AutoUpgradeMinorVersion
Gibt an, ob die Erweiterung eine neuere Nebenversion verwenden soll, wenn sie zur Bereitstellungszeit verfügbar ist. Nach der Bereitstellung aktualisiert die Erweiterung jedoch keine Nebenversionen, es sei denn, sie werden erneut bereitgestellt, auch wenn diese Eigenschaft auf "true" festgelegt ist.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
Typ: | SwitchParameter |
Aliase: | cf |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-DefaultProfile
Der Parameter DefaultProfile ist nicht funktionsfähig. Verwenden Sie den Parameter "SubscriptionId", wenn sie verfügbar ist, wenn Sie das Cmdlet für ein anderes Abonnement ausführen.
Typ: | PSObject |
Aliase: | AzureRMContext, AzureCredential |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-EnableAutomaticUpgrade
Gibt an, ob die Erweiterung automatisch von der Plattform aktualisiert werden soll, wenn eine neuere Version verfügbar ist.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ExtensionParameter
Beschreibt ein Computererweiterungsupdate.
Typ: | IMachineExtensionUpdate |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-ForceRerun
Wie der Erweiterungshandler aktualisiert werden soll, auch wenn sich die Erweiterungskonfiguration nicht geändert hat.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-InputObject
Identity-Parameter
Typ: | IConnectedMachineIdentity |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-JsonFilePath
Pfad der json-Datei, die für den Updatevorgang bereitgestellt wird
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-JsonString
Json-Zeichenfolge, die für den Updatevorgang bereitgestellt wird
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-MachineInputObject
Identity-Parameter
Typ: | IConnectedMachineIdentity |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-MachineName
Der Name des Computers, auf dem die Erweiterung erstellt oder aktualisiert werden soll.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Name
Der Name der Computererweiterung.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-NoWait
Asynchrones Ausführen des Befehls
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ProtectedSetting
Die Erweiterung kann entweder protectedSettings oder protectedSettingsFromKeyVault oder gar keine geschützten Einstellungen enthalten.
Typ: | Hashtable |
Aliase: | ProtectedSettings |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Publisher
Der Name des Herausgebers des Erweiterungshandlers.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ResourceGroupName
Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Setting
Json formatierte öffentliche Einstellungen für die Erweiterung.
Typ: | Hashtable |
Aliase: | Settings |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-SubscriptionId
Die ID des Zielabonnements.
Typ: | String |
Position: | Named |
Standardwert: | (Get-AzContext).Subscription.Id |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Tag
Ressourcentags
Typ: | Hashtable |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Type
Gibt den Typ der Erweiterung an; Ein Beispiel ist "CustomScriptExtension".
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-TypeHandlerVersion
Gibt die Version des Skripthandlers an.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Typ: | SwitchParameter |
Aliase: | wi |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Eingaben
Ausgaben
Azure PowerShell