Update-AzConnectedMachineExtension
Operacja aktualizowania rozszerzenia.
Składnia
UpdateExpanded (Domyślne)
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>]
Opis
Operacja aktualizowania rozszerzenia.
Przykłady
Przykład 1. Aktualizowanie rozszerzenia
$splat = @{
ResourceGroupName = "connectedMachines"
MachineName = "linux-eastus1_1"
Name = "customScript"
Settings = @{
commandToExecute = "ls -l"
}
}
Update-AzConnectedMachineExtension @splat
Name Location ProvisioningState
---- -------- -----------------
customScript eastus Succeeded
Aktualizuje rozszerzenie na określonej maszynie.
Przykład 2. Aktualizowanie rozszerzenia z lokalizacją określoną za pośrednictwem potoku
$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 określone rozszerzenie przekazywane za pośrednictwem potoku.
W tym miejscu używamy rozszerzenia przekazanego za pośrednictwem potoku, aby pomóc nam zidentyfikować, na którym rozszerzeniu chcemy działać, i określamy, co chcemy zmienić za pomocą normalnych parametrów (takich jak -Settings)
Przykład 3. Aktualizowanie rozszerzenia przy użyciu parametrów rozszerzenia określonych za pośrednictwem potoku
$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 określone rozszerzenie przekazywane za pośrednictwem potoku.
W tym miejscu używamy rozszerzenia przekazanego za pośrednictwem potoku, aby podać zmiany, które chcemy wprowadzić w rozszerzeniu.
Lokalizacja rozszerzenia nie jest pobierana za pośrednictwem potoku, ale raczej za pośrednictwem parametrów określonych normalnie (przez parametr splat).
Przykład 4: Używanie obiektu rozszerzenia jako lokalizacji i parametrów do aktualizowania
$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 określone rozszerzenie przekazywane za pośrednictwem potoku.
W tym miejscu używamy rozszerzenia przekazanego za pośrednictwem potoku, aby pomóc nam określić, na którym rozszerzeniu chcemy działać.
Oprócz tego używamy parametrów obiektu rozszerzenia, aby określić, co należy zaktualizować.
Parametry
-AsJob
Uruchamianie polecenia jako zadania
Właściwości parametrów
Typ: SwitchParameter
Wartość domyślna: None
Wspiera dzikie karty: False
DontShow: False
Zbiory parametrów
(All)
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
-AutoUpgradeMinorVersion
Wskazuje, czy rozszerzenie powinno używać nowszej wersji pomocniczej, jeśli jest ona dostępna w czasie wdrażania.
Po wdrożeniu rozszerzenie nie uaktualni wersji pomocniczych, chyba że zostanie ponownie wdrożone, nawet jeśli ta właściwość ma wartość true.
Właściwości parametrów
Typ: SwitchParameter
Wartość domyślna: None
Wspiera dzikie karty: False
DontShow: False
Zbiory parametrów
UpdateExpanded
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaIdentityMachineExpanded
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaIdentityExpanded
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
-Confirm
Prosi o potwierdzenie przed uruchomieniem cmdletu.
Właściwości parametrów
Typ: SwitchParameter
Wartość domyślna: None
Wspiera dzikie karty: False
DontShow: False
Aliasy: por
Zbiory parametrów
(All)
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
-DefaultProfile
Parametr DefaultProfile nie działa.
Użyj parametru SubscriptionId, jeśli jest dostępny, jeśli wykonuje polecenie cmdlet dla innej subskrypcji.
Właściwości parametrów
Typ: PSObject
Wartość domyślna: None
Wspiera dzikie karty: False
DontShow: False
Aliasy: AzureRMContext, AzureCredential
Zbiory parametrów
(All)
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
-EnableAutomaticUpgrade
Wskazuje, czy rozszerzenie powinno zostać automatycznie uaktualnione przez platformę, jeśli jest dostępna nowsza wersja.
Właściwości parametrów
Typ: SwitchParameter
Wartość domyślna: None
Wspiera dzikie karty: False
DontShow: False
Zbiory parametrów
UpdateExpanded
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaIdentityMachineExpanded
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaIdentityExpanded
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
-ExtensionParameter
Opisuje aktualizację rozszerzenia komputera.
Właściwości parametrów
Zbiory parametrów
Update
Pozycja: Named
Obowiązkowy: True
Wartość z pipeline: True
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaIdentityMachine
Pozycja: Named
Obowiązkowy: True
Wartość z pipeline: True
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaIdentity
Pozycja: Named
Obowiązkowy: True
Wartość z pipeline: True
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
-ForceRerun
Sposób, w jaki program obsługi rozszerzeń powinien zostać zmuszony do aktualizacji, nawet jeśli konfiguracja rozszerzenia nie uległa zmianie.
Właściwości parametrów
Typ: String
Wartość domyślna: None
Wspiera dzikie karty: False
DontShow: False
Zbiory parametrów
UpdateExpanded
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaIdentityMachineExpanded
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaIdentityExpanded
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
Parametr tożsamości
UpdateViaIdentityExpanded
Pozycja: Named
Obowiązkowy: True
Wartość z pipeline: True
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaIdentity
Pozycja: Named
Obowiązkowy: True
Wartość z pipeline: True
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
-JsonFilePath
Ścieżka pliku Json dostarczonego do operacji aktualizacji
Właściwości parametrów
Typ: String
Wartość domyślna: None
Wspiera dzikie karty: False
DontShow: False
Zbiory parametrów
UpdateViaJsonFilePath
Pozycja: Named
Obowiązkowy: True
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
-JsonString
Ciąg Json dostarczony do operacji aktualizacji
Właściwości parametrów
Typ: String
Wartość domyślna: None
Wspiera dzikie karty: False
DontShow: False
Zbiory parametrów
UpdateViaJsonString
Pozycja: Named
Obowiązkowy: True
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
Parametr tożsamości
UpdateViaIdentityMachineExpanded
Pozycja: Named
Obowiązkowy: True
Wartość z pipeline: True
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaIdentityMachine
Pozycja: Named
Obowiązkowy: True
Wartość z pipeline: True
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
-MachineName
Nazwa maszyny, na której ma zostać utworzone lub zaktualizowane rozszerzenie.
Właściwości parametrów
Typ: String
Wartość domyślna: None
Wspiera dzikie karty: False
DontShow: False
Zbiory parametrów
UpdateExpanded
Pozycja: Named
Obowiązkowy: True
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaJsonString
Pozycja: Named
Obowiązkowy: True
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaJsonFilePath
Pozycja: Named
Obowiązkowy: True
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
Update
Pozycja: Named
Obowiązkowy: True
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
-Name
Nazwa rozszerzenia maszyny.
Właściwości parametrów
Typ: String
Wartość domyślna: None
Wspiera dzikie karty: False
DontShow: False
Zbiory parametrów
UpdateExpanded
Pozycja: Named
Obowiązkowy: True
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaJsonString
Pozycja: Named
Obowiązkowy: True
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaJsonFilePath
Pozycja: Named
Obowiązkowy: True
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
Update
Pozycja: Named
Obowiązkowy: True
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaIdentityMachineExpanded
Pozycja: Named
Obowiązkowy: True
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaIdentityMachine
Pozycja: Named
Obowiązkowy: True
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
-NoWait
Uruchom polecenie asynchronicznie
Właściwości parametrów
Typ: SwitchParameter
Wartość domyślna: None
Wspiera dzikie karty: False
DontShow: False
Zbiory parametrów
(All)
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
-ProtectedSetting
Rozszerzenie może zawierać ustawienia protectedSettings lub protectedSettingsFromKeyVault lub w ogóle nie są chronione.
Właściwości parametrów
Typ: Hashtable
Wartość domyślna: None
Wspiera dzikie karty: False
DontShow: False
Aliasy: Ustawienia chronione
Zbiory parametrów
UpdateExpanded
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaIdentityMachineExpanded
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaIdentityExpanded
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
-Publisher
Nazwa wydawcy programu obsługi rozszerzeń.
Właściwości parametrów
Typ: String
Wartość domyślna: None
Wspiera dzikie karty: False
DontShow: False
Zbiory parametrów
UpdateExpanded
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaIdentityMachineExpanded
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaIdentityExpanded
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
-ResourceGroupName
Nazwa grupy zasobów.
Nazwa jest niewrażliwa na wielkość liter.
Właściwości parametrów
Typ: String
Wartość domyślna: None
Wspiera dzikie karty: False
DontShow: False
Zbiory parametrów
UpdateExpanded
Pozycja: Named
Obowiązkowy: True
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaJsonString
Pozycja: Named
Obowiązkowy: True
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaJsonFilePath
Pozycja: Named
Obowiązkowy: True
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
Update
Pozycja: Named
Obowiązkowy: True
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
-Setting
Ustawienia publiczne w formacie Json dla rozszerzenia.
Właściwości parametrów
Typ: Hashtable
Wartość domyślna: None
Wspiera dzikie karty: False
DontShow: False
Aliasy: Ustawienia
Zbiory parametrów
UpdateExpanded
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaIdentityMachineExpanded
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaIdentityExpanded
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
-SubscriptionId
Identyfikator subskrypcji docelowej.
Właściwości parametrów
Typ: String
Wartość domyślna: (Get-AzContext).Subscription.Id
Wspiera dzikie karty: False
DontShow: False
Zbiory parametrów
UpdateExpanded
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaJsonString
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaJsonFilePath
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
Update
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
-Tag
Tagi zasobów
Właściwości parametrów
Typ: Hashtable
Wartość domyślna: None
Wspiera dzikie karty: False
DontShow: False
Zbiory parametrów
UpdateExpanded
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaIdentityMachineExpanded
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaIdentityExpanded
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
-Type
Określa typ rozszerzenia; przykładem jest "CustomScriptExtension".
Właściwości parametrów
Typ: String
Wartość domyślna: None
Wspiera dzikie karty: False
DontShow: False
Zbiory parametrów
UpdateExpanded
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaIdentityMachineExpanded
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaIdentityExpanded
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
-TypeHandlerVersion
Określa wersję programu obsługi skryptów.
Właściwości parametrów
Typ: String
Wartość domyślna: None
Wspiera dzikie karty: False
DontShow: False
Zbiory parametrów
UpdateExpanded
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaIdentityMachineExpanded
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
UpdateViaIdentityExpanded
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione.
Cmdlet nie jest uruchomiony.
Właściwości parametrów
Typ: SwitchParameter
Wartość domyślna: None
Wspiera dzikie karty: False
DontShow: False
Aliasy: Wi
Zbiory parametrów
(All)
Pozycja: Named
Obowiązkowy: False
Wartość z pipeline: False
Wartość z pipeline według nazwy właściwości: False
Wartość pozostałych argumentów: False
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters .
Wyjść