Командлет Update-ServiceFabricService обновляет свойства работающей службы Service Fabric. Набор свойств, которые могут быть обновлены, является подмножеством свойств, которые были указаны во время создания сервиса (с помощью или New-ServiceFabricServiceNew-ServiceFabricServiceFromTemplate). Вы можете получить текущие свойства вашего сервиса с помощью Get-ServiceFabricServiceDescription.
Обратите внимание, что обновление свойств работающей службы отличается от обновления службы с помощью Start-ServiceFabricApplicationUpgrade. Обновление службы (т.е. приложения) — это длительная фоновая задача, которая включает в себя перемещение приложения с одной версии на другую, по одному домену обновления за раз. Дополнительные сведения см. в разделе Обновление приложения Service Fabric .
Прежде чем выполнять какие-либо операции с кластером Service Fabric, установите подключение к кластеру с помощью командлета Connect-ServiceFabricCluster.
Примеры
Пример 1: Обновление службы с отслеживанием состояния
Эта команда обновляет DNS-имя службы службы.
Примечание: Если обновленное DNS-имя уже было запрошено в кластере или у службы обновления уже было DNS-имя, служба DNS должна быть перезапущена после обновления, чтобы сделать кэш недействительным.
Позволяет удалить исходные вторичные реплики до того, как новые вторичные реплики завершат сборку.
Свойства параметров
Тип:
Boolean
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
Stateful
Position:
Named
Обязательно:
False
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-Force
Принудительно выполняется команда без запроса подтверждения пользователя.
Свойства параметров
Тип:
SwitchParameter
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
(All)
Position:
Named
Обязательно:
False
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-InstanceCloseDelayDuration
Указывает продолжительность ожидания в секундах перед закрытием экземпляра без отслеживания состояния, на который влияет обновление приложения, чтобы обеспечить корректную очистку активных запросов. Эта продолжительность ожидания действует только для тех служб без отслеживания состояния, которые имеют ненулевое значение, настроенное для InstanceCloseDelayDuration, и переопределяет предварительно настроенное значение. Дополнительные сведения см. в разделе InstanceCloseDelayDuration . Не указывайте этот параметр для служб с отслеживанием состояния.
Свойства параметров
Тип:
TimeSpan
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
Stateless
Position:
Named
Обязательно:
False
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-InstanceCount
Указывает обновленное количество экземпляров для службы Service Fabric без отслеживания состояния.
Не указывайте этот параметр для служб с отслеживанием состояния.
Свойства параметров
Тип:
Int32
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
Stateless
Position:
Named
Обязательно:
False
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-InstanceLifecycleDescription
Описание жизненного цикла экземпляров, принадлежащих данной службе. Если какая-либо конфигурация в этом разделе не указана, то значение по умолчанию берется из одноименного параметра кластера (если он существует).
Свойства параметров
Тип:
InstanceLifecycleDescription
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
Stateless
Position:
Named
Обязательно:
False
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-InstanceRestartWaitDuration
Когда экземпляр без отслеживания состояния выходит из строя, этот таймер запускается. По истечении срока действия Service Fabric создаст новый экземпляр на любом узле кластера. Эта конфигурация предназначена для уменьшения ненужного создания нового экземпляра в ситуациях, когда неисправный экземпляр может восстановиться за короткое время. Например, во время обновления. Значение по умолчанию — 0, что указывает на то, что при выходе из строя экземпляра без отслеживания состояния Service Fabric немедленно начнет создание его замены.
Указывает обновленное минимальное количество экземпляров раздела службы без отслеживания состояния. Подробнее см. в разделе MinInstanceCount (in New-ServiceFabricService). Не указывайте этот параметр для служб с отслеживанием состояния.
Свойства параметров
Тип:
Int32
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
Stateless
Position:
Named
Обязательно:
False
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-MinInstancePercentage
Указывает обновленный минимальный процент InstanceCount для секции службы без отслеживания состояния. Подробнее см. в разделе MinInstancePercentage (in New-ServiceFabricService). Не указывайте этот параметр для служб с отслеживанием состояния.
Свойства параметров
Тип:
Int32
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
Stateless
Position:
Named
Обязательно:
False
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-MinReplicaSetSize
Указывает обновленный минимальный размер набора реплик для службы Service Fabric с отслеживанием состояния. Значение должно быть меньше TargetReplicaSetSize этой службы. Дополнительные сведения см. в разделе StatefulServiceDescription.MinReplicaSetSize.
Не указывайте этот параметр для служб без отслеживания состояния.
Описание жизненного цикла реплик, принадлежащих данной службе. Если какая-либо конфигурация в этом разделе не указана, то значение по умолчанию берется из одноименного параметра кластера (если он существует).
Свойства параметров
Тип:
ReplicaLifecycleDescription
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
Stateful
Position:
Named
Обязательно:
False
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-ReplicaRestartWaitDuration
Указывает обновленный интервал в виде объекта TimeSpan , в течение которого Service Fabric ожидает перезапуска реплики перед созданием реплики на замену.
Чтобы получить объект TimeSpan , используйте командлет New-TimeSpan .
Указывает, что служба является службой Service Fabric с отслеживанием состояния.
Свойства параметров
Тип:
SwitchParameter
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
Stateful
Position:
0
Обязательно:
True
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-Stateless
Указывает, что служба является службой Service Fabric без отслеживания состояния.
Свойства параметров
Тип:
SwitchParameter
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
Stateless
Position:
0
Обязательно:
True
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-TagsRequiredToPlace
Объявляет теги, необходимые для размещения услуги. Полезно для динамического влияния на размещение услуг. Дополнительные сведения см. в разделе Теги динамических узлов Service Fabric.
Свойства параметров
Тип:
System.Collections.Generic.List`1[System.String]
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
(All)
Position:
Named
Обязательно:
False
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-TagsRequiredToRun
Объявляет теги, необходимые для размещения и работы сервиса. Полезно для динамического влияния на размещение и работу сервиса. Дополнительные сведения см. в статье Теги динамических узлов Service Fabric
Свойства параметров
Тип:
System.Collections.Generic.List`1[System.String]
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
(All)
Position:
Named
Обязательно:
False
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-TargetReplicaSetSize
Указывает обновленный размер целевого набора реплик для службы Service Fabric с отслеживанием состояния. Дополнительные сведения см. в статье StatefulServiceDescription.TargetReplicaSetSize.
Не указывайте этот параметр для службы без отслеживания состояния.
Свойства параметров
Тип:
Int32
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
Stateful
Position:
Named
Обязательно:
False
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-TimeoutSec
Указывает период ожидания операции в секундах.
Свойства параметров
Тип:
Int32
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
(All)
Position:
Named
Обязательно:
False
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-WhatIf
Показывает, что произойдет, если командлет будет запущен.
Командлет не запускается.
Свойства параметров
Тип:
SwitchParameter
Default value:
False
Поддерживаются подстановочные знаки:
False
DontShow:
False
Aliases:
wi
Наборы параметров
(All)
Position:
Named
Обязательно:
False
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.