Update-ServiceFabricApplicationUpgrade

Изменяет описание обновления активного обновления приложения.

Синтаксис

Update-ServiceFabricApplicationUpgrade
      [-ApplicationName] <Uri>
      [-ForceRestart <Boolean>]
      [-UpgradeReplicaSetCheckTimeoutSec <UInt32>]
      [-UpgradeMode <RollingUpgradeMode>]
      [-FailureAction <UpgradeFailureAction>]
      [-HealthCheckRetryTimeoutSec <UInt32>]
      [-HealthCheckWaitDurationSec <UInt32>]
      [-HealthCheckStableDurationSec <UInt32>]
      [-UpgradeDomainTimeoutSec <UInt32>]
      [-UpgradeTimeoutSec <UInt32>]
      [-ConsiderWarningAsError <Boolean>]
      [-DefaultServiceTypeHealthPolicy <String>]
      [-MaxPercentUnhealthyDeployedApplications <Byte>]
      [-ServiceTypeHealthPolicyMap <Hashtable>]
      [-Force]
      [-InstanceCloseDelayDurationSec <UInt32>]
      [-TimeoutSec <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Командлет Update-ServiceFabricApplicationUpgrade изменяет параметры описания обновления приложения, пока обновление все еще активно. Service Fabric обнаруживает и применяет изменения в соответствии со значением UpgradeStatusPollInterval , как указано в манифесте кластера. За исключением политик оценки работоспособности, этот командлет обновляет только указанные параметры. Неуказаемые параметры остаются не затронутыми. Необходимо объединить следующие политики оценки работоспособности, а не по отдельности:

  • ConsiderWarningAsError
  • DefaultServiceTypeHealthPolicy
  • MaxPercentUnhealthyDeployedApplications
  • ServiceTypeHealthPolicyMap

Перед выполнением любой операции в кластере Service Fabric установите подключение к кластеру с помощью командлета Connect-ServiceFabricCluster .

Примеры

Пример 1. Обновление значения обновления приложения

PS C:\> Update-ServiceFabricApplicationUpgrade -ApplicationName fabric:/MyApplication -UpgradeReplicaSetCheckTimeoutSec 0

Эта команда задает для набора реплик значение времени ожидания проверки равным 0 для ожидающего обновления в fabric:/MyApplication. Это обновление оставляет все остальные значения обновления в одиночку.

Параметры

-ApplicationName

Указывает универсальный код ресурса (URI) приложения Service Fabric. Командлет обновляет параметры обновления для приложения с URI, заданным этим параметром.

Type:Uri
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Запрос подтверждения перед выполнением командлета.

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

-ConsiderWarningAsError

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

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

-DefaultServiceTypeHealthPolicy

Задает политику работоспособности по умолчанию для типов служб. Политика работоспособности используется для отслеживаемого обновления. Политика соответствует формату MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices. Например, "5,10,15" указывает следующие значения:

  • MaxPercentUnhealthyPartitionsPerService = 5
  • MaxPercentUnhealthyReplicasPerPartition = 10
  • MaxPercentUnhealthyServices = 15
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FailureAction

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

  • Откат
  • Вручную
Type:UpgradeFailureAction
Accepted values:Invalid, Rollback, Manual
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

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

-ForceRestart

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

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

-HealthCheckRetryTimeoutSec

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

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

-HealthCheckStableDurationSec

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

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

-HealthCheckWaitDurationSec

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

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

-InstanceCloseDelayDurationSec

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

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

-MaxPercentUnhealthyDeployedApplications

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

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

-ServiceTypeHealthPolicyMap

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

@{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }

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

-TimeoutSec

Указывает период времени ожидания (в секундах) для операции.

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

-UpgradeDomainTimeoutSec

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

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

-UpgradeMode

Указывает новый объект UpgradeMode для обновления.

Type:RollingUpgradeMode
Accepted values:Invalid, UnmonitoredAuto, UnmonitoredManual, Monitored
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UpgradeReplicaSetCheckTimeoutSec

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

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

-UpgradeTimeoutSec

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

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

-WhatIf

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

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

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

None

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

System.Object