Update-AzConnectedMachineExtension

Odwołanie

Moduł:: Az.ConnectedMachine

Operacja aktualizowania rozszerzenia.

Składnia

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>]

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

Aktualizacje rozszerzenia na określonym komputerze.

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

Aktualizacje określone rozszerzenie przekazane 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

Aktualizacje określone rozszerzenie przekazane 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

Aktualizacje określone rozszerzenie przekazane 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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Parametr DefaultProfile nie działa. Użyj parametru SubscriptionId, jeśli jest dostępny, jeśli wykonuje polecenie cmdlet dla innej subskrypcji.

Type:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableAutomaticUpgrade

Wskazuje, czy rozszerzenie powinno zostać automatycznie uaktualnione przez platformę, jeśli jest dostępna nowsza wersja.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ExtensionParameter

Opisuje aktualizację rozszerzenia komputera.

Type:	IMachineExtensionUpdate
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ForceRerun

Sposób, w jaki program obsługi rozszerzeń powinien zostać zmuszony do aktualizacji, nawet jeśli konfiguracja rozszerzenia nie uległa zmianie.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Parametr tożsamości

Type:	IConnectedMachineIdentity
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-JsonFilePath

Ścieżka pliku Json dostarczonego do operacji aktualizacji

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-JsonString

Ciąg Json dostarczony do operacji aktualizacji

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-MachineInputObject

Parametr tożsamości

Type:	IConnectedMachineIdentity
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-MachineName

Nazwa maszyny, na której ma zostać utworzone lub zaktualizowane rozszerzenie.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Nazwa rozszerzenia maszyny.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NoWait

Uruchom polecenie asynchronicznie

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ProtectedSetting

Rozszerzenie może zawierać chronione Ustawienia lub chronione Ustawienia FromKeyVault lub żadne ustawienia chronione.

Type:	Hashtable
Aliases:	ProtectedSettings
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Publisher

Nazwa wydawcy programu obsługi rozszerzeń.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Setting

Ustawienia publiczne w formacie Json dla rozszerzenia.

Type:	Hashtable
Aliases:	Settings
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SubscriptionId

Identyfikator subskrypcji docelowej.

Type:	String
Position:	Named
Default value:	(Get-AzContext).Subscription.Id
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

Tagi zasobów

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Type

Określa typ rozszerzenia; przykładem jest "CustomScriptExtension".

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TypeHandlerVersion

Określa wersję programu obsługi skryptów.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Dane wejściowe

IConnectedMachineIdentity

IMachineExtensionUpdate

Dane wyjściowe

IMachineExtension

Udostępnij przez