Update-AzServiceFabricApplication

Ссылка

Модуль:: Az.ServiceFabric

Обновите приложение Service Fabric. Это позволяет обновить параметры приложения и (или) обновить версию типа приложения, которая активирует обновление приложения. Поддерживает только развернутые приложения ARM.

Синтаксис

Update-AzServiceFabricApplication
      [-ResourceGroupName] <String>
      [-ClusterName] <String>
      [-Name] <String>
      [[-ApplicationTypeVersion] <String>]
      [-ApplicationParameter <Hashtable>]
      [-MinimumNodeCount <Int64>]
      [-MaximumNodeCount <Int64>]
      [-ForceRestart]
      [-UpgradeReplicaSetCheckTimeoutSec <Int32>]
      [-FailureAction <FailureAction>]
      [-HealthCheckRetryTimeoutSec <Int32>]
      [-HealthCheckWaitDurationSec <Int32>]
      [-HealthCheckStableDurationSec <Int32>]
      [-UpgradeDomainTimeoutSec <Int32>]
      [-UpgradeTimeoutSec <Int32>]
      [-ConsiderWarningAsError]
      [-DefaultServiceTypeMaxPercentUnhealthyPartitionsPerService <Int32>]
      [-DefaultServiceTypeMaxPercentUnhealthyReplicasPerPartition <Int32>]
      [-DefaultServiceTypeUnhealthyServicesMaxPercent <Int32>]
      [-UnhealthyDeployedApplicationsMaxPercent <Int32>]
      [-ServiceTypeHealthPolicyMap <Hashtable>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzServiceFabricApplication
      [[-ApplicationTypeVersion] <String>]
      [-ApplicationParameter <Hashtable>]
      [-MinimumNodeCount <Int64>]
      [-MaximumNodeCount <Int64>]
      [-ForceRestart]
      [-UpgradeReplicaSetCheckTimeoutSec <Int32>]
      [-FailureAction <FailureAction>]
      [-HealthCheckRetryTimeoutSec <Int32>]
      [-HealthCheckWaitDurationSec <Int32>]
      [-HealthCheckStableDurationSec <Int32>]
      [-UpgradeDomainTimeoutSec <Int32>]
      [-UpgradeTimeoutSec <Int32>]
      [-ConsiderWarningAsError]
      [-DefaultServiceTypeMaxPercentUnhealthyPartitionsPerService <Int32>]
      [-DefaultServiceTypeMaxPercentUnhealthyReplicasPerPartition <Int32>]
      [-DefaultServiceTypeUnhealthyServicesMaxPercent <Int32>]
      [-UnhealthyDeployedApplicationsMaxPercent <Int32>]
      [-ServiceTypeHealthPolicyMap <Hashtable>]
      [-ResourceId] <String>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzServiceFabricApplication
      -InputObject <PSApplication>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Этот командлет можно использовать для обновления параметров приложения и обновления версии типа приложения. Обновление параметра изменит модель только на стороне ARM, только если используется новая версия типа, команда запустит обновление приложения. Указанная версия типа уже должна быть создана в кластере с помощью New-AzServiceFabricApplicationTypeVersion.

Примеры

Пример 1

$resourceGroupName = "testRG"
$clusterName = "testCluster"
$appName = "testApp"
$version = "v2"
$packageUrl = "https://sftestapp.blob.core.windows.net/sftestapp/testAppType_v2.sfpkg"
New-AzServiceFabricApplicationTypeVersion -ResourceGroupName $resourceGroupName -ClusterName $clusterName -Name $appName -Version $version -PackageUrl $packageUrl -Verbose
Update-AzServiceFabricApplication -ResourceGroupName $resourceGroupName -ClusterName $clusterName -ApplicationTypeVersion $version -Name $appName -ApplicationParameter @{key0="value0";key1=$null;key2="value2"}

В этом примере будет запущено обновление приложения для обновления версии типа до версии 2, созданной с New-AzServiceFabricApplicationTypeVersion. Используемые параметры приложения должны быть определены в манифесте приложения.

Пример 2

$resourceGroupName = "testRG"
$clusterName = "testCluster"
$appName = "testApp"
Update-AzServiceFabricApplication -ResourceGroupName $resourceGroupName -ClusterName $clusterName -Name $appName -MinimumNodeCount 1 -MaximumNodeCount 4 -Verbose

В этом примере будет обновлено минимальное и максимальное количество узлов для приложения.

Пример 3

$resourceGroupName = "testRG"
$clusterName = "testCluster"
$appName = "testApp"
$version = "v2"
$packageUrl = "https://sftestapp.blob.core.windows.net/sftestapp/testAppType_v2.sfpkg"
New-AzServiceFabricApplicationTypeVersion -ResourceGroupName $resourceGroupName -ClusterName $clusterName -Name $appName -Version $version -PackageUrl $packageUrl -Verbose
Update-AzServiceFabricApplication -ResourceGroupName $resourceGroupName -ClusterName $clusterName -ApplicationTypeVersion $version -Name $appName -ApplicationParameter @{key0="value0";key1=$null;key2="value2"} -HealthCheckStableDurationSec 0 -HealthCheckWaitDurationSec 0 -HealthCheckRetryTimeoutSec 0 -UpgradeDomainTimeoutSec 5000 -UpgradeTimeoutSec 7000 -FailureAction Rollback -UpgradeReplicaSetCheckTimeoutSec 300 -ForceRestart

В этом примере будет запущено обновление приложения, чтобы обновить версию типа до версии 2, а также задать некоторые параметры политики обновления, которые вступают в силу с текущего обновления.

Пример 4

Update-AzServiceFabricApplication -ResourceGroupName $resourceGroupName -ClusterName $clusterName -Name $appName -ApplicationParameter @{key0="value0";key1=$null;key2="value2"}

В этом примере обновляются параметры приложения, но эти изменения вступают в силу только до обновления следующей версии приложения.

Параметры

-ApplicationParameter

Укажите параметры приложения в виде пар "ключ-значение". Эти параметры должны существовать в манифесте приложения.

Тип:	Hashtable
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ApplicationTypeVersion

Укажите версию типа приложения

Тип:	String
Position:	3
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ClusterName

Укажите имя кластера.

Тип:	String
Position:	1
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-Confirm

Запрашивает подтверждение перед запуском командлета.

Тип:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ConsiderWarningAsError

Указывает, следует ли рассматривать событие работоспособности предупреждения как событие ошибки во время оценки работоспособности.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure.

Тип:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DefaultServiceTypeMaxPercentUnhealthyPartitionsPerService

Указывает максимальный процент несхельных секций для каждой службы, разрешенной политикой работоспособности для типа службы по умолчанию, используемого для отслеживаемого обновления.

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DefaultServiceTypeMaxPercentUnhealthyReplicasPerPartition

Указывает максимальный процент несхелых реплик для каждой службы, разрешенной политикой работоспособности для типа службы по умолчанию, используемого для отслеживаемого обновления.

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DefaultServiceTypeUnhealthyServicesMaxPercent

Указывает максимальный процент несхельных служб, разрешенных политикой работоспособности для типа службы по умолчанию, используемого для отслеживаемого обновления.

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-FailureAction

Указывает действие, которое необходимо предпринять, если отслеживаемое обновление завершается сбоем. Допустимые значения для этого параметра — rollback или Manual.

Тип:	FailureAction
Допустимые значения:	Rollback, Manual
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ForceRestart

Указывает, что узел службы перезапускается, даже если обновление является изменением только конфигурации.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-HealthCheckRetryTimeoutSec

Указывает длительность в секундах, после чего Service Fabric повторяет проверку работоспособности, если предыдущая проверка работоспособности завершается ошибкой.

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-HealthCheckStableDurationSec

Указывает длительность( в секундах), которую Service Fabric ожидает, чтобы убедиться, что приложение стабильно, прежде чем перейти к следующему домену обновления или завершить обновление. Эта длительность ожидания предотвращает незамеченные изменения работоспособности сразу после выполнения проверки работоспособности.

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-HealthCheckWaitDurationSec

Указывает длительность( в секундах), которую Service Fabric ожидает, прежде чем она выполнит начальную проверку работоспособности после завершения обновления в домене обновления.

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-InputObject

Ресурс приложения.

Тип:	PSApplication
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-MaximumNodeCount

Указывает максимальное количество узлов, на которых должно размещаться приложение.

Тип:	Int64
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-MinimumNodeCount

Указывает минимальное количество узлов, в которых Service Fabric будет резервировать емкость для этого приложения.

Тип:	Int64
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Name

Укажите имя приложения

Тип:	String
Aliases:	ApplicationName
Position:	2
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ResourceGroupName

Укажите имя группы ресурсов.

Тип:	String
Position:	0
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-ResourceId

Arm ResourceId приложения.

Тип:	String
Position:	0
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-ServiceTypeHealthPolicyMap

Указывает карту политики работоспособности для различных типов служб в виде хэш-таблицы в следующем формате: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPercentUnhealthyService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Например: @{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5"}

Тип:	Hashtable
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-UnhealthyDeployedApplicationsMaxPercent

Указывает максимальный процент экземпляров приложения, развернутых на узлах в кластере с состоянием работоспособности, прежде чем состояние работоспособности приложения для кластера будет ошибкой.

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-UpgradeDomainTimeoutSec

Указывает максимальное время в секундах, которое Service Fabric занимает для обновления одного домена обновления. После этого периода обновление завершается ошибкой.

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-UpgradeReplicaSetCheckTimeoutSec

Указывает максимальное время, когда Service Fabric ожидает перенастройки службы в безопасное состояние, если оно еще не в безопасном состоянии, прежде чем Service Fabric продолжит обновление.

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-UpgradeTimeoutSec

Указывает максимальное время в секундах, которое занимает Service Fabric для всего обновления. После этого периода обновление завершается ошибкой.

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-WhatIf

Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.

Тип:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

Входные данные

String

PSApplication

Выходные данные