Update-ServiceFabricService

Модуль:

ServiceFabric

Обновления службы Service Fabric.

Синтаксис

Update-ServiceFabricService
      [-Stateless]
      [-ServiceName] <Uri>
      [-InstanceCount <Int32>]
      [-MinInstanceCount <Int32>]
      [-MinInstancePercentage <Int32>]
      [-InstanceLifecycleDescription <InstanceLifecycleDescription>]
      [-Force]
      [-PlacementConstraints <String>]
      [-Metric <String[]>]
      [-Correlation <String[]>]
      [-PlacementPolicy <String[]>]
      [-DefaultMoveCost <String>]
      [-PartitionNamesToAdd <String[]>]
      [-PartitionNamesToRemove <String[]>]
      [-ScalingPolicies <System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]>]
      [-InstanceCloseDelayDuration <TimeSpan>]
      [-InstanceRestartWaitDuration <TimeSpan>]
      [-ServiceDnsName <String>]
      [-TagsRequiredToPlace <System.Collections.Generic.List`1[System.String]>]
      [-TagsRequiredToRun <System.Collections.Generic.List`1[System.String]>]
      [-TimeoutSec <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-ServiceFabricService
      [-Stateful]
      [-ServiceName] <Uri>
      [-TargetReplicaSetSize <Int32>]
      [-MinReplicaSetSize <Int32>]
      [-ReplicaRestartWaitDuration <TimeSpan>]
      [-QuorumLossWaitDuration <TimeSpan>]
      [-StandByReplicaKeepDuration <TimeSpan>]
      [-ServicePlacementTimeLimit <TimeSpan>]
      [-DropSourceReplicaOnMove <Boolean>]
      [-ReplicaLifecycleDescription <ReplicaLifecycleDescription>]
      [-Force]
      [-PlacementConstraints <String>]
      [-Metric <String[]>]
      [-Correlation <String[]>]
      [-PlacementPolicy <String[]>]
      [-DefaultMoveCost <String>]
      [-PartitionNamesToAdd <String[]>]
      [-PartitionNamesToRemove <String[]>]
      [-ScalingPolicies <System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]>]
      [-ServiceDnsName <String>]
      [-TagsRequiredToPlace <System.Collections.Generic.List`1[System.String]>]
      [-TagsRequiredToRun <System.Collections.Generic.List`1[System.String]>]
      [-TimeoutSec <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Командлет Update-ServiceFabricService обновляет свойства работающей службы Service Fabric. Набор свойств, которые можно обновить, — это подмножество свойств, указанных во время создания службы (с помощью New-ServiceFabricService или New-ServiceFabricServiceFromTemplate). Текущие свойства службы можно получить с помощью Get-ServiceFabricServiceDescription.

Обратите внимание, что обновление свойств запущенной службы отличается от обновления службы с помощью Start-ServiceFabricApplicationUpgrade. Обновление службы (т. е. приложения) — это длительная фоновая задача, которая включает перемещение приложения из одной версии в другую— по одному домену обновления за раз. Дополнительные сведения см. в разделе "Обновление приложений Service Fabric ".

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

Примеры

Пример 1. Обновление службы с отслеживанием состояния

PS C:\> Update-ServiceFabricService -Stateful fabric:/myapp/test -MinReplicaSetSize 3 -TargetReplicaSetSize 5

Эта команда обновляет MinReplicaSetSize и TargetReplicaSetSize запущенной службы Fabric до трех (3) и пяти (5).

Пример 2. Обновление службы без отслеживания состояния

PS C:\> Update-ServiceFabricService -Stateless fabric:/myapp/test -InstanceCount -1

Эта команда обновляет число экземпляров запущенной службы Fabric до значения –1.

Пример 3. Обновление ограничений размещения

PS C:\> Update-ServiceabricService -Stateless -ServiceName fabric:/myapp/test -PlacementConstraints "NodeName!=NodeBar"

Эта команда обновляет ограничения размещения.

Пример 4. Обновление метрик загрузки по умолчанию

PS C:\> Update-ServiceFabricService -Stateless -ServiceName fabric:/myapp/test -Metric @("CPU,High,10")
PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -Metric @("CPU,High,10,1")

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

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

Пример 5. Обновление политики размещения

PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -PlacementPolicy @("InvalidDomain,fd:/dc2/rack2")

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

Пример 6. Обновление корреляции службы

PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -Correlation @("fabric:/app/test2,AlignedAffinity")

Эта команда обновляет корреляцию службы.

Пример 7. Обновление DNS-имени службы

PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -ServiceDnsName stateful.dns
PS C:\> Update-ServiceFabricService -Stateless -ServiceName fabric:/myapp/test -ServiceDnsName stateless.dns

Эта команда обновляет DNS-имя службы службы. Примечание. Если обновленное DNS-имя уже было запрошено в кластере или обновляемая служба уже имела DNS-имя, служба DNS должна быть перезапущена после обновления, чтобы сделать кэш недействительным.

Параметры

-Confirm

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

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

-Correlation

Задает обновленный массив ограничений корреляции для этой службы. Дополнительные сведения о корреляции служб см. в статье " Настройка и использование сходства служб" в Service Fabric.

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

-DefaultMoveCost

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

• Ноль
• Низкий
• Средний
• Высокий

Дополнительные сведения о стоимости перемещения см. в разделе "Стоимость перемещения служб" для влияния на выбор Resource Manager кластера.

Тип:	String
Допустимые значения:	Zero, Low, Medium, High, VeryHigh
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DropSourceReplicaOnMove

Позволяет удалять исходные вторичные реплики до завершения сборки новых вторичных реплик.

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

-Force

Принудительное выполнение команды без запроса на подтверждение пользователем.

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

-InstanceCloseDelayDuration

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

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

-InstanceCount

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

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

-InstanceLifecycleDescription

Описание жизненного цикла экземпляров, принадлежащих этой службе. Если какая-то конфигурация в этом разделе не указана, значение по умолчанию берется из параметра кластера с тем же именем (если он существует).

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

-InstanceRestartWaitDuration

При отключении экземпляра без отслеживания состояния запускается этот таймер. По истечении срока действия Service Fabric создаст новый экземпляр на любом узле в кластере. Эта конфигурация заключается в сокращении ненужных операций создания нового экземпляра в ситуациях, когда происходит сход экземпляра, скорее всего, восстановится в течение короткого времени. Например, во время обновления. Значение по умолчанию — 0, указывающее, что при отключении экземпляра без отслеживания состояния Service Fabric немедленно начнет сборку замены.

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

-Metric

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

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

-MinInstanceCount

Указывает обновленное минимальное число экземпляров секции службы без отслеживания состояния. Дополнительные сведения см. в разделе MinInstanceCount (in New-ServiceFabricService). Не указывайте этот параметр для служб с отслеживанием состояния.

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

-MinInstancePercentage

Указывает обновленный минимальный процент instanceCount секции службы без отслеживания состояния. Дополнительные сведения см. в разделе MinInstancePercentage (in New-ServiceFabricService). Не указывайте этот параметр для служб с отслеживанием состояния.

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

-MinReplicaSetSize

Указывает обновленный минимальный размер набора реплик для службы Service Fabric с отслеживанием состояния. Значение должно быть меньше , чем TargetReplicaSetSize этой службы. Дополнительные сведения см. в разделе StatefulServiceDescription.MinReplicaSetSize.

Не указывайте этот параметр для служб без отслеживания состояния.

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

-PartitionNamesToAdd

{{Fill PartitionNamesToAdd Description}}

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

-PartitionNamesToRemove

{{Fill PartitionNamesToRemove Description}}

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

-PlacementConstraints

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

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

-PlacementPolicy

Задает обновленный массив политик размещения для службы. Дополнительные сведения о PlacementPolicy см. в разделе "Политики размещения" для служб Service Fabric.

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

-QuorumLossWaitDuration

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

Чтобы получить объект TimeSpan , используйте командлет New-TimeSpan . Для получения дополнительных сведений введите Get-Help New-TimeSpan.

Дополнительные сведения о параметре QuorumLossWaitDuration см. в разделе StatefulServiceDescription.QuorumLossWaitDuration.

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

-ReplicaLifecycleDescription

Описание жизненного цикла реплик, принадлежащих этой службе. Если какая-то конфигурация в этом разделе не указана, значение по умолчанию берется из параметра кластера с тем же именем (если он существует).

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

-ReplicaRestartWaitDuration

Указывает обновленный интервал в качестве объекта TimeSpan , который Service Fabric ожидает перезапуска реплики перед созданием реплики замены. Чтобы получить объект TimeSpan , используйте командлет New-TimeSpan .

Дополнительные сведения о QuorumLossWaitDuration см. в разделе StatefulServiceDescription.ReplicaRestartWaitDuration.

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

-ScalingPolicies

{{Fill ScalingPolicies Description}}

Тип:	System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ServiceDnsName

Указывает обновленное DNS-имя службы.

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

-ServiceName

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

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

-ServicePlacementTimeLimit

Задает ограничение времени размещения службы.

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

-StandByReplicaKeepDuration

Указывает обновленную длительность хранения реплики в качестве объекта TimeSpan .

Дополнительные сведения о QuorumLossWaitDuration см. в разделе StatefulServiceDescription.StandByReplicaKeepDuration.

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

-Stateful

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

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

-Stateless

Указывает, что служба является службой без отслеживания состояния Service Fabric.

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

-TagsRequiredToPlace

Объявляет теги, необходимые для размещения службы. Это удобно для динамического влияния на размещение службы. Дополнительные сведения см. в разделе "Теги динамических узлов Service Fabric".

Тип:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-TagsRequiredToRun

Объявляет теги, необходимые для размещения и работы службы. Это удобно для динамического влияния на размещение и работу службы. Дополнительные сведения см. в разделе "Теги динамических узлов Service Fabric"

Тип:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-TargetReplicaSetSize

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

Не указывайте этот параметр для службы без отслеживания состояния.

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

-TimeoutSec

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

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

-WhatIf

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

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

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

System.Uri

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

System.Object

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

• Connect-ServiceFabricCluster
• Get-ServiceFabricClusterConnection
• Get-ServiceFabricService
• New-ServiceFabricService
• Remove-ServiceFabricService
• Resolve-ServiceFabricService