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

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

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

-Correlation

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultMoveCost

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

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

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

Type:	String
Accepted values:	Zero, Low, Medium, High, VeryHigh
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DropSourceReplicaOnMove

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

Type:	Boolean
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

-InstanceCloseDelayDuration

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

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

-InstanceCount

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

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

-InstanceLifecycleDescription

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

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

-InstanceRestartWaitDuration

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

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

-Metric

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MinInstanceCount

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

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

-MinInstancePercentage

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

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

-MinReplicaSetSize

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

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

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

-PartitionNamesToAdd

{{Fill PartitionNamesToAdd Description}}

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PartitionNamesToRemove

{{Fill PartitionNamesToRemove Description}}

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PlacementConstraints

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

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

-PlacementPolicy

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-QuorumLossWaitDuration

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

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

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

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

-ReplicaLifecycleDescription

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

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

-ReplicaRestartWaitDuration

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

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

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

-ScalingPolicies

{{Fill ScalingPolicies Description}}

Type:	System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServiceDnsName

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

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

-ServiceName

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

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

-ServicePlacementTimeLimit

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

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

-StandByReplicaKeepDuration

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

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

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

-Stateful

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

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

-Stateless

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

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

-TagsRequiredToPlace

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

Type:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TagsRequiredToRun

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

Type:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TargetReplicaSetSize

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

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

Type:	Int32
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

-WhatIf

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

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

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

System.Uri

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

System.Object

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

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