Update-ServiceFabricService

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

Синтаксис

Stateless (По умолчанию)

Update-ServiceFabricService
    [-ServiceName] <Uri>
    [-Stateless]
    [-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>]

Stateful

Update-ServiceFabricService
    [-ServiceName] <Uri>
    [-Stateful]
    [-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-ServiceFabricServiceNew-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 работающей службы структуры до трех (3) и пяти (5).

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

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

Эта команда обновляет число экземпляров работающей службы структуры до значения -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

Запрашивает подтверждение перед запуском cmdlet.

Свойства параметров

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Correlation

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

Свойства параметров

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DefaultMoveCost

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

  • Нуль
  • Низкий уровень
  • Medium
  • Высоко

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

Свойства параметров

Тип:String
Default value:None
Допустимые значения:Zero, Low, Medium, High, VeryHigh
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DropSourceReplicaOnMove

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

Свойства параметров

Тип: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 немедленно начнет создание его замены.

Свойства параметров

Тип:TimeSpan
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Stateless
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Metric

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

Свойства параметров

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-MinInstanceCount

Указывает обновленное минимальное количество экземпляров раздела службы без отслеживания состояния. Подробнее см. в разделе 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.

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

Свойства параметров

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Stateful
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PartitionNamesToAdd

{{Заполнить PartitionNamesToAdd Description}}

Свойства параметров

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PartitionNamesToRemove

{{Заполнить PartitionNamesToRemove Description}}

Свойства параметров

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PlacementConstraints

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

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PlacementPolicy

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

Свойства параметров

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-QuorumLossWaitDuration

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

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

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

Свойства параметров

Тип:TimeSpan
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Stateful
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ReplicaLifecycleDescription

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

Свойства параметров

Тип:ReplicaLifecycleDescription
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Stateful
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ReplicaRestartWaitDuration

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

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

Свойства параметров

Тип:TimeSpan
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Stateful
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ScalingPolicies

{{Заполнить описание ScalingPolicies}}

Свойства параметров

Тип:

System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ServiceDnsName

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

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ServiceName

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

Свойства параметров

Тип:Uri
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:1
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ServicePlacementTimeLimit

Задает ограничение по времени размещения сервиса.

Свойства параметров

Тип:TimeSpan
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Stateful
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-StandByReplicaKeepDuration

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

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

Свойства параметров

Тип:TimeSpan
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Stateful
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Stateful

Указывает, что служба является службой 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.

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

System.Uri

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

System.Object