Update-ServiceFabricService

Módulo:

ServiceFabric

Atualizações um serviço de tecido de serviço.

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 de tecido de serviço em execução. O conjunto de propriedades que podem ser atualizadas são um subconjunto das propriedades que foram especificadas no momento da criação do serviço (usando New-ServiceFabricService ou New-ServiceFabricServiceFromTemplate). Pode obter propriedades atuais do seu serviço utilizando a Get-ServiceFabricServiceDescription.

Por favor, note que atualizar as propriedades de um serviço de execução é diferente de atualizar o seu serviço usando Start-ServiceFabricApplicationUpgrade. Atualizar o seu serviço (isto é, aplicação) é uma tarefa de fundo de longa duração que envolve mover a sua aplicação, de uma versão para outra, um domínio de upgrade de cada vez. Consulte a atualização da aplicação de tecido de serviço para mais detalhes.

Antes de efetuar qualquer operação num cluster de tecido de serviço, estabeleça uma ligação ao cluster utilizando o cmdlet Connect-ServiceFabricCluster .

Exemplos

Exemplo 1: Atualizar um serviço imponente

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

Este comando atualiza o MinReplicaSetSize e TargetReplicaSetSize de um Serviço de Tecido em execução para três (3) e cinco (5).

Exemplo 2: Atualizar um serviço apátrida

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

Este comando atualiza a contagem de exemplos de um Serviço de Tecido em Execução a um valor de -1.

Exemplo 3: Condicionantes de colocação de atualização

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

Este comando atualiza os constrangimentos de colocação.

Exemplo 4: Atualizar métricas de carga predefinidos

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 predefinidos para um serviço apátrida.

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

Exemplo 5: Atualizar a política de colocação

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

Este comando atualiza a política de colocação.

Exemplo 6: Correlação de serviço de atualização

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

Este 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

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

Parâmetros

-Confirm

Solicita a 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 gama atualizada de restrições de correlação para este serviço. Para saber mais sobre a correlação de serviço, consulte Configurar e utilizar afinidade de serviço em Tecido de Serviço.

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

-DefaultMoveCost

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

• Zero
• Baixo
• Médio
• Alto

Para obter mais detalhes sobre o custo de movimento, consulte o custo de movimento do serviço para influenciar as escolhas Resource Manager 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 largadas antes que as novas réplicas secundárias terminem a construção.

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

-Force

Força o comando a funcionar sem pedir confirmação do utilizador.

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

-InstanceCloseDelayDuration

Especifica a duração em segundos, para aguardar que uma instância apátrida que seja impactada pela atualização da aplicação seja encerrada, para permitir que os pedidos ativos drene graciosamente. Esta duração de espera só é eficaz para os casos dos serviços apátridas que têm um valor não nulo configurado para a InstanceCloseDelayDuration, e que sobreporão ao valor pré-configurado. Consulte InstanceCloseDelayDuration para mais detalhes. Não especifique este parâmetro para serviços estatais.

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

-InstanceCount

Especifica o número atualizado de casos para o serviço apátrida do Tecido de Serviço. Não especifique este parâmetro para serviços estatais.

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

-InstanceLifecycleDescription

Descrição do ciclo de vida de casos pertencentes a este serviço. Se não for especificada alguma configuração nesta secção, o valor predefinido é retirado do parâmetro de cluster do mesmo nome (se existir).

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

-InstanceRestartWaitDuration

Quando um caso apátrida acontece, este temporizador começa. Quando expirar o Tecido de Serviço criará uma nova instância em qualquer nó no cluster. Esta configuração é para reduzir a criação desnecessária de um novo caso em situações em que o caso em curso é suscetível de se recuperar em pouco tempo. Por exemplo, durante uma atualização. O valor padrão é 0, o que indica que quando a instância apátrida cai, a Service Fabric começará imediatamente a construir a sua substituição.

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

-Metric

Especifica o conjunto atualizado de métricas que o serviço reporta. Para saber mais sobre métricas, consulte Gerir o consumo de recursos e carregar em Tecido de Serviço 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 apátrida. Consulte MinInstanceCount (in New-ServiceFabricService) para obter mais informações. Não especifique este parâmetro para serviços estatais.

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

-MinInstancePercentage

Especifica a percentagem mínima atualizada de InstanceCount de uma divisória de serviço apátrida. Consulte MinInstancePercentage (in New-ServiceFabricService) para obter mais detalhes. Não especifique este parâmetro para serviços estatais.

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

-MinReplicaSetSize

Especifica o tamanho de conjunto de réplica mínima atualizado para o serviço stateful do Service Fabric. O valor deve ser inferior ao TargetReplicaSetSize deste serviço. Para mais detalhes, consulte StatefulServiceDescription.MinReplicaSetSize.

Não especifique este parâmetro para serviços apátridas.

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

-PartitionNamesToAdd

{{Preencha partitionNamesToAdd Descrição}}

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

-PartitionNamesToRemove

{{Preencha 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 colocação atualizada para o serviço. Para saber mais sobre as restrições de colocação, consulte as restrições de colocação e propriedades de nó.

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

-PlacementPolicy

Especifica um conjunto atualizado de políticas de colocação para um serviço. Para saber mais sobre PlacementPolicy, consulte políticas de colocação para serviços de tecido de serviço.

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 , utilize o cmdlet New-TimeSpan . Para mais informações, insira 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 pertencentes a este serviço. Se não for especificada alguma configuração nesta secção, o valor predefinido é retirado do parâmetro de cluster do mesmo nome (se existir).

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 Tecido de Serviço espera que a réplica reinicie antes de criar uma réplica de substituição. Para obter um objeto TimeSpan , utilize o cmdlet New-TimeSpan .

Para saber mais sobre o 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 de Tecido de Serviço cujas propriedades precisam de ser atualizadas.

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

-ServicePlacementTimeLimit

Define o prazo de colocação do serviço.

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

-StandByReplicaKeepDuration

Especifica a réplica de stand-by atualizada manter a duração como um objeto TimeSpan .

Para saber mais sobre o 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 stateful 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 apátrida de Service Fabric.

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

-TagsRequiredToPlace

Declara etiquetas necessárias para a colocação de um serviço. Útil para influenciar dinamicamente a colocação do serviço. Para mais informações, consulte tags de nó dinâmicos de tecido de serviço.

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 etiquetas necessárias para colocação e execução de um serviço. Útil para influenciar dinamicamente a colocação e execução do serviço. Para mais informações, consulte tags de nó dinâmicos de tecido de serviço

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 definido da réplica de alvo atualizada para um serviço stateful do Service Fabric. Para mais detalhes, consulte StatefulServiceDescription.TargetReplicaSetSize.

Não especifique este parâmetro para um serviço apátrida.

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

-TimeoutSec

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

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. 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

Ligações Relacionadas

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