Update-ServiceFabricService

Módulo:

ServiceFabric

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

Syntax

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.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

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

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

-Force

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	TimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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).

Type:	InstanceLifecycleDescription
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	TimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

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ó.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	TimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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).

Type:	ReplicaLifecycleDescription
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

Especifica o nome DNS atualizado de um serviço.

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

-ServiceName

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

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

-ServicePlacementTimeLimit

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

Type:	TimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-Stateful

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

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

-Stateless

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

Type:	SwitchParameter
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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

Type:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-TimeoutSec

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

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

-WhatIf

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

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

Entradas

System.Uri

Saídas

System.Object

Links Relacionados

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