Compartilhar via


Update-ServiceFabricService

Atualizações um serviço do Service Fabric.

Sintaxe

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>]

Description

O cmdlet Update-ServiceFabricService atualiza as propriedades de um serviço do Service Fabric em execução. O conjunto de propriedades que pode ser atualizado é um subconjunto das propriedades que foram especificadas no momento da criação do serviço (usando New-ServiceFabricService ou New-ServiceFabricServiceFromTemplate). Você pode obter as propriedades atuais do serviço usando Get-ServiceFabricServiceDescription.

Observe que atualizar as propriedades de um serviço em execução é diferente de atualizar seu serviço usando Start-ServiceFabricApplicationUpgrade. Atualizar seu serviço (ou seja, aplicativo) é uma tarefa em segundo plano de execução longa que envolve mover seu aplicativo, de uma versão para outra, um domínio de atualização por vez. Consulte a Atualização de Aplicativo do Service Fabric para obter mais detalhes.

Antes de executar qualquer operação em um cluster do Service Fabric, estabeleça uma conexão com o cluster usando o cmdlet Connect-ServiceFabricCluster .

Exemplos

Exemplo 1: Atualizar um serviço com estado

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

Esse comando atualiza minReplicaSetSize e TargetReplicaSetSize de um Serviço fabric em execução para três (3) e cinco (5).

Exemplo 2: Atualizar um serviço sem estado

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

Esse comando atualiza a contagem de instâncias de um Serviço fabric em execução para um valor de -1.

Exemplo 3: atualizar restrições de posicionamento

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

Esse comando atualiza as restrições de posicionamento.

Exemplo 4: Atualizar métricas de carga padrão

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")

O primeiro comando atualiza as métricas de carga padrão para um serviço sem estado.

O segundo comando atualiza as métricas de carga padrão para um serviço com estado.

Exemplo 5: Política de posicionamento de atualização

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

Esse comando atualiza a política de posicionamento.

Exemplo 6: Atualizar correlação de serviço

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

Esse comando atualiza a correlação de serviço.

Exemplo 7: Atualizar o nome DNS do serviço

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

Esse comando atualiza o nome DNS do serviço de um serviço. Observação: se o nome DNS atualizado já tiver sido consultado no cluster ou o serviço de atualização já tiver um nome DNS, o serviço DNS deverá ser reiniciado após a atualização para invalidar o cache.

Parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Correlation

Especifica uma matriz atualizada de restrições de correlação para esse serviço. Para saber mais sobre a correlação de serviço, consulte Configurar e usar a afinidade de serviço no Service Fabric.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultMoveCost

Especifica o custo de movimentação padrão atualizado que as réplicas têm quando são criadas. Os valores aceitáveis para esse parâmetro são:

  • Zero
  • Baixo
  • Médio
  • Alto

Para obter mais detalhes sobre o custo de movimentação, consulte o custo de movimentação do serviço para influenciar as opções de Resource Manager de cluster.

Tipo:String
Valores aceitos:Zero, Low, Medium, High, VeryHigh
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DropSourceReplicaOnMove

Permite que as réplicas secundárias de origem sejam descartadas antes que novas réplicas secundárias terminem o build.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

Força o comando a ser executado sem solicitar a confirmação do usuário.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InstanceCloseDelayDuration

Especifica a duração em segundos, aguardar até que uma instância sem estado afetada pela atualização do aplicativo seja fechada, para permitir que as solicitações ativas sejam drenadas normalmente. Essa duração de espera é efetiva apenas para as instâncias desses serviços sem estado que têm um valor diferente de zero configurado para o InstanceCloseDelayDuration e substituirão o valor pré-configurado. Consulte InstanceCloseDelayDuration para obter detalhes. Não especifique esse parâmetro para serviços com estado.

Tipo:TimeSpan
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InstanceCount

Especifica o número atualizado de instâncias para o serviço sem estado do Service Fabric. Não especifique esse parâmetro para serviços com estado.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InstanceLifecycleDescription

Descrição do ciclo de vida das instâncias que pertencem a esse serviço. Se alguma configuração nesta seção não for especificada, o valor padrão será obtido do parâmetro de cluster de mesmo nome (se existente).

Tipo:InstanceLifecycleDescription
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InstanceRestartWaitDuration

Quando uma instância sem estado fica inoperante, esse temporizador é iniciado. Quando expirar, o Service Fabric criará uma nova instância em qualquer nó no cluster. Essa configuração é para reduzir a criação desnecessária de uma nova instância em situações em que a instância desativada provavelmente se recuperará em pouco tempo. Por exemplo, durante uma atualização. O valor padrão é 0, o que indica que, quando a instância sem estado for inoperante, o Service Fabric começará imediatamente a criar sua substituição.

Tipo:TimeSpan
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Metric

Especifica a matriz atualizada de métricas que o serviço relata. Para saber mais sobre as métricas, consulte Gerenciando o consumo de recursos e a carga no Service Fabric com métricas.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MinInstanceCount

Especifica o número mínimo atualizado de instâncias da partição de serviço sem estado. Consulte MinInstanceCount (in New-ServiceFabricService) para obter detalhes. Não especifique esse parâmetro para serviços com estado.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MinInstancePercentage

Especifica o percentual mínimo atualizado de InstanceCount de uma partição de serviço sem estado. Consulte MinInstancePercentage (in New-ServiceFabricService) para obter detalhes. Não especifique esse parâmetro para serviços com estado.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MinReplicaSetSize

Especifica o tamanho do conjunto de réplicas mínimo atualizado para o serviço com estado do Service Fabric. O valor deve ser menor que o TargetReplicaSetSize deste serviço. Para obter mais detalhes, consulte StatefulServiceDescription.MinReplicaSetSize.

Não especifique esse parâmetro para serviços sem estado.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PartitionNamesToAdd

{{Fill PartitionNamesToAdd Description}}

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PartitionNamesToRemove

{{Fill PartitionNamesToRemove Description}}

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PlacementConstraints

Especifica a restrição de posicionamento atualizada para o serviço. Para saber mais sobre restrições de posicionamento, consulte restrições de posicionamento e propriedades de nó.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PlacementPolicy

Especifica uma matriz atualizada de políticas de posicionamento para um serviço. Para saber mais sobre PlacementPolicy, consulte Políticas de posicionamento para serviços do service fabric.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-QuorumLossWaitDuration

Especifica a duração atualizada, como um objeto TimeSpan , que o Service Fabric aguarda antes de declarar perda de dados para uma partição de serviço.

Para obter um objeto TimeSpan , use o cmdlet New-TimeSpan . Para obter mais informações, digite Get-Help New-TimeSpan.

Para saber mais sobre o parâmetro QuorumLossWaitDuration, consulte StatefulServiceDescription.QuorumLossWaitDuration.

Tipo:TimeSpan
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ReplicaLifecycleDescription

Descrição do ciclo de vida das réplicas que pertencem a este serviço. Se alguma configuração nesta seção não for especificada, o valor padrão será obtido do parâmetro de cluster de mesmo nome (se existente).

Tipo:ReplicaLifecycleDescription
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ReplicaRestartWaitDuration

Especifica o intervalo atualizado, como um objeto TimeSpan , que o Service Fabric espera que a réplica seja reiniciada antes de criar uma réplica de substituição. Para obter um objeto TimeSpan , use o cmdlet New-TimeSpan .

Para saber mais sobre QuorumLossWaitDuration, consulte StatefulServiceDescription.ReplicaRestartWaitDuration.

Tipo:TimeSpan
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ScalingPolicies

{{Fill ScalingPolicies Description}}

Tipo:System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ServiceDnsName

Especifica o nome DNS atualizado de um serviço.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ServiceName

Especifica o URI de um serviço do Service Fabric cujas propriedades precisam ser atualizadas.

Tipo:Uri
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ServicePlacementTimeLimit

Define o limite de tempo de posicionamento do serviço.

Tipo:TimeSpan
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-StandByReplicaKeepDuration

Especifica a duração de manter a réplica em espera atualizada como um objeto TimeSpan .

Para saber mais sobre QuorumLossWaitDuration, consulte StatefulServiceDescription.StandByReplicaKeepDuration.

Tipo:TimeSpan
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Stateful

Indica que o serviço é um serviço com estado do Service Fabric.

Tipo:SwitchParameter
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Stateless

Indica que o serviço é um serviço sem estado do Service Fabric.

Tipo:SwitchParameter
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TagsRequiredToPlace

Declara as marcas necessárias para o posicionamento de um serviço. Útil para influenciar dinamicamente o posicionamento do serviço. Para obter mais informações, consulte Marcas de Nó Dinâmico do Service Fabric.

Tipo:System.Collections.Generic.List`1[System.String]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TagsRequiredToRun

Declara as marcas necessárias para o posicionamento e a execução de um serviço. Útil para influenciar dinamicamente o posicionamento e a execução do serviço. Para obter mais informações, consulte Marcas de Nó Dinâmico do Service Fabric

Tipo:System.Collections.Generic.List`1[System.String]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TargetReplicaSetSize

Especifica o tamanho do conjunto de réplicas de destino atualizado para um serviço com estado do Service Fabric. Para obter mais detalhes, consulte StatefulServiceDescription.TargetReplicaSetSize.

Não especifique esse parâmetro para um serviço sem estado.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TimeoutSec

Especifica o período de tempo limite, em segundos, para a operação.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

System.Uri

Saídas

System.Object