Update-ServiceFabricService

Referência

Módulo:: ServiceFabric

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

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

Tipo:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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.

Tipo:	String[]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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.

Tipo:	String
Valores aceites:	Zero, Low, Medium, High, VeryHigh
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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.

Tipo:	Boolean
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Force

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

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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.

Tipo:	TimeSpan
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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.

Tipo:	Int32
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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).

Tipo:	InstanceLifecycleDescription
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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.

Tipo:	TimeSpan
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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.

Tipo:	String[]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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.

Tipo:	Int32
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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.

Tipo:	Int32
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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.

Tipo:	Int32
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-PartitionNamesToAdd

Tipo:	String[]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-PartitionNamesToRemove

Tipo:	String[]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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ó.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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.

Tipo:	String[]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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.

Tipo:	TimeSpan
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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).

Tipo:	ReplicaLifecycleDescription
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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.

Tipo:	TimeSpan
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ScalingPolicies

Tipo:	System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ServiceDnsName

Especifica o nome DNS atualizado de um serviço.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ServiceName

Especifica o URI de um serviço de Tecido de Serviço cujas propriedades precisam de ser atualizadas.

Tipo:	Uri
Position:	1
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-ServicePlacementTimeLimit

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

Tipo:	TimeSpan
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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.

Tipo:	TimeSpan
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Stateful

Indica que o serviço é um serviço stateful service Fabric.

Tipo:	SwitchParameter
Position:	0
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Stateless

Indica que o serviço é um serviço apátrida de Service Fabric.

Tipo:	SwitchParameter
Position:	0
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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.

Tipo:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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

Tipo:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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.

Tipo:	Int32
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-TimeoutSec

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

Tipo:	Int32
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

Entradas

System.Uri

Saídas

System.Object

Partilhar via