Start-ServiceFabricApplicationUpgrade

Ссылка

Модуль:: ServiceFabric

Обновляет приложение Service Fabric до указанного ApplicationTypeVersion.

Синтаксис

Start-ServiceFabricApplicationUpgrade
     [-ApplicationName] <Uri>
     [-ApplicationTypeVersion] <String>
     [[-ApplicationParameter] <Hashtable>]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredAuto]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-ServiceFabricApplicationUpgrade
     [-ApplicationName] <Uri>
     [-ApplicationTypeVersion] <String>
     [[-ApplicationParameter] <Hashtable>]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredManual]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-ServiceFabricApplicationUpgrade
     [-ApplicationName] <Uri>
     [-ApplicationTypeVersion] <String>
     [[-ApplicationParameter] <Hashtable>]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-Monitored]
     -FailureAction <UpgradeFailureAction>
     [-HealthCheckRetryTimeoutSec <UInt32>]
     [-HealthCheckWaitDurationSec <UInt32>]
     [-HealthCheckStableDurationSec <UInt32>]
     [-UpgradeDomainTimeoutSec <UInt32>]
     [-UpgradeTimeoutSec <UInt32>]
     [-ConsiderWarningAsError <Boolean>]
     [-DefaultServiceTypeHealthPolicy <String>]
     [-MaxPercentUnhealthyDeployedApplications <Byte>]
     [-ServiceTypeHealthPolicyMap <Hashtable>]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Описание

Командлет Start-ServiceFabricApplicationUpgrade обновляет приложение Service Fabric. Перед использованием этого командлета необходимо скопировать обновленный пакет приложения в хранилище образов и зарегистрировать обновленный тип приложения. Используйте copy-ServiceFabricApplicationPackage, чтобы скопировать пакет приложения в хранилище образов. Используйте командлет Register-ServiceFabricApplicationType для регистрации обновленного типа приложения.

Этот командлет запускает обновление в кластере.

ApplicationParameters не сохраняются при обновлении приложения. Чтобы сохранить текущие параметры приложения, пользователь должен сначала получить параметры и передать их в вызов API обновления, как показано в примере 1 ниже.

Дополнительные сведения об обновлениях приложений Service Fabric см. в концептуальной документации.

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

Примеры

Пример 1. Получение параметров приложения для передачи в вызов обновления

$myApplication = Get-ServiceFabricApplication -ApplicationName fabric:/myApplication
$appParamCollection = $myApplication.ApplicationParameters
$applicationParameterMap = @{}

foreach ($pair in $appParamCollection)
{ $applicationParameterMap.Add($pair.Name, $pair.Value); }

Start-ServiceFabricApplicationUpgrade -ApplicationName fabric:/myApplication -ApplicationTypeVersion 2.0.0 -ApplicationParameter $applicationParameterMap -Monitored -FailureAction Rollback

Пример 2. Обновление приложения

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "C:\PersistentToDoListServiceV2" -ImageStoreConnectionString "file:C:\ProgramData\ServiceFabric\ImageStore"
PS C:\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore "PersistentToDoListServiceV2"
PS C:\> Start-ServiceFabricApplicationUpgrade -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeVersion "2.0" -ForceRestart -UnMonitoredManual

Первая команда использует командлет Copy-ServiceFabricApplicationPackage для копирования обновленного пакета приложения в хранилище образов.

Вторая команда использует командлет Register-ServiceFabricApplicationType для регистрации обновленного типа приложения.

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

Параметры

-ApplicationName

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

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

-ApplicationParameter

Задает переопределения параметров приложения в виде пар "имя-значение".

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

-ApplicationTypeVersion

Указывает версию типа приложения Service Fabric. Командлет обновляет приложение до указанной версии.

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

-Confirm

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

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

-ConsiderWarningAsError

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

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

-DefaultServiceTypeHealthPolicy

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

MaxPercentUnhealthyPartitionsPerService = 5
MaxPercentUnhealthyReplicasPerPartition = 10
MaxPercentUnhealthyServices = 15

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

-FailureAction

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

Откат
Вручную

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

-Force

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

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

-ForceRestart

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

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

-HealthCheckRetryTimeoutSec

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

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

-HealthCheckStableDurationSec

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

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

-HealthCheckWaitDurationSec

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

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

-InstanceCloseDelayDurationSec

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

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

-MaxPercentUnhealthyDeployedApplications

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

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

-Monitored

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

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

-ReplicaQuorumTimeoutSec

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

Этот параметр устарел. Укажите вместо этого параметр UpgradeReplicaSetCheckTimeoutSec .

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

-RestartProcess

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

Этот параметр устарел. Укажите вместо этого параметр ForceRestart .

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

-ServiceTypeHealthPolicyMap

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

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

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

-SortOrder

Определяет порядок, в котором выполняется обновление кластера.

Возможны следующие значения:

Invalid — указывает, что этот порядок сортировки недопустим. Все перечисления Service Fabric имеют недопустимый тип.
Default — указывает, что будет использоваться порядок сортировки по умолчанию (как указано в манифесте кластера).
Numeric — Указывает, что будет использоваться порядок переадресации числовых чисел (имена определяемых пользователем типов, отсортированные по числовым номерам).
Lexicographical — Указывает, что будет использоваться порядок сортировки пересылки лексикографических (имена определяемых пользователем типов, отсортированные по строкам).
ReverseNumeric — Указывает, что будет использоваться обратный порядок сортировки (имена пользователей, отсортированные по числу).
ReverseLexicographical— Указывает, что будет использоваться обратный лексикографический порядок сортировки (имена определяемых пользователем типов, отсортированные по строкам).

Тип:	UpgradeSortOrder
Допустимые значения:	Invalid, Default, Numeric, Lexicographical, ReverseNumeric, ReverseLexicographical
Position:	5
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-TimeoutSec

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

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

-UnmonitoredAuto

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

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

-UnmonitoredManual

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

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

-UpgradeDomainTimeoutSec

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

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

-UpgradeReplicaSetCheckTimeoutSec

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

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

-UpgradeTimeoutSec

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

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

-WhatIf

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

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

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

None

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

System.Object

Поделиться через

Start-ServiceFabricApplicationUpgrade

Синтаксис

Описание

Примеры

Пример 1. Получение параметров приложения для передачи в вызов обновления

Пример 2. Обновление приложения

Параметры

-ApplicationName

-ApplicationParameter

-ApplicationTypeVersion

-Confirm

-ConsiderWarningAsError

-DefaultServiceTypeHealthPolicy

-FailureAction

-Force

-ForceRestart

-HealthCheckRetryTimeoutSec

-HealthCheckStableDurationSec

-HealthCheckWaitDurationSec

-InstanceCloseDelayDurationSec

-MaxPercentUnhealthyDeployedApplications

-Monitored

-ReplicaQuorumTimeoutSec

-RestartProcess

-ServiceTypeHealthPolicyMap

-SortOrder

-TimeoutSec

-UnmonitoredAuto

-UnmonitoredManual

-UpgradeDomainTimeoutSec

-UpgradeReplicaSetCheckTimeoutSec

-UpgradeTimeoutSec

-WhatIf

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

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

Дополнительные ресурсы

Поделиться через

Start-ServiceFabricApplicationUpgrade

Синтаксис

Описание

Примеры

Пример 1. Получение параметров приложения для передачи в вызов обновления

Пример 2. Обновление приложения

Параметры

-ApplicationName

-ApplicationParameter

-ApplicationTypeVersion

-Confirm

-ConsiderWarningAsError

-DefaultServiceTypeHealthPolicy

-FailureAction

-Force

-ForceRestart

-HealthCheckRetryTimeoutSec

-HealthCheckStableDurationSec

-HealthCheckWaitDurationSec

-InstanceCloseDelayDurationSec

-MaxPercentUnhealthyDeployedApplications

-Monitored

-ReplicaQuorumTimeoutSec

-RestartProcess

-ServiceTypeHealthPolicyMap

-SortOrder

-TimeoutSec

-UnmonitoredAuto

-UnmonitoredManual

-UpgradeDomainTimeoutSec

-UpgradeReplicaSetCheckTimeoutSec

-UpgradeTimeoutSec

-WhatIf

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

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

Связанные ссылки

Дополнительные ресурсы