Update-ServiceFabricApplicationUpgrade

Módulo:

ServiceFabric

Modifica a descrição de atualização de uma atualização ativa do aplicativo.

Syntax

Update-ServiceFabricApplicationUpgrade
      [-ApplicationName] <Uri>
      [-ForceRestart <Boolean>]
      [-UpgradeReplicaSetCheckTimeoutSec <UInt32>]
      [-UpgradeMode <RollingUpgradeMode>]
      [-FailureAction <UpgradeFailureAction>]
      [-HealthCheckRetryTimeoutSec <UInt32>]
      [-HealthCheckWaitDurationSec <UInt32>]
      [-HealthCheckStableDurationSec <UInt32>]
      [-UpgradeDomainTimeoutSec <UInt32>]
      [-UpgradeTimeoutSec <UInt32>]
      [-ConsiderWarningAsError <Boolean>]
      [-DefaultServiceTypeHealthPolicy <String>]
      [-MaxPercentUnhealthyDeployedApplications <Byte>]
      [-ServiceTypeHealthPolicyMap <Hashtable>]
      [-Force]
      [-InstanceCloseDelayDurationSec <UInt32>]
      [-TimeoutSec <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Update-ServiceFabricApplicationUpgrade modifica os parâmetros de uma descrição de atualização do aplicativo enquanto a atualização ainda está ativa. O Service Fabric detecta e aplica alterações de acordo com o valor UpgradeStatusPollInterval , conforme especificado no manifesto do cluster. Exceto para políticas de avaliação de integridade, esse cmdlet atualiza apenas os parâmetros especificados. Os parâmetros não especificados permanecem não afetados. Você deve atualizar as seguintes políticas de avaliação de integridade em conjunto, não individualmente:

• ConsiderWarningAsError
• DefaultServiceTypeHealthPolicy
• MaxPercentUnhealthyDeployedApplications
• ServiceTypeHealthPolicyMap

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 valor para uma atualização de aplicativo

PS C:\> Update-ServiceFabricApplicationUpgrade -ApplicationName fabric:/MyApplication -UpgradeReplicaSetCheckTimeoutSec 0

Esse comando define o valor de tempo limite de verificação do conjunto de réplicas como 0 para uma atualização pendente na malha:/MyApplication. A atualização deixa todos os outros valores de atualização sozinhos.

Parâmetros

-ApplicationName

Especifica o URI (Uniform Resource Identifier) de um aplicativo do Service Fabric. O cmdlet atualiza as configurações para a atualização do aplicativo que tem o URI especificado por esse parâmetro.

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

-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

-ConsiderWarningAsError

Indica se um relatório de integridade de aviso deve ser tratado como um erro durante a avaliação de integridade.

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

-DefaultServiceTypeHealthPolicy

Especifica a política de integridade padrão para tipos de serviço. A política de integridade é usada para a atualização monitorada. A política segue o formato MaxPercentUnhealthyPartitionsPerService, MaxPercentUnhealthyReplicasPerPartition, MaxPercentUnhealthyServices. Por exemplo, 5,10,15 indicam os seguintes valores:

• MaxPercentUnhealthyPartitionsPerService = 5
• MaxPercentUnhealthyReplicasPerPartition = 10
• MaxPercentUnhealthyServices = 15

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

-FailureAction

Especifica a ação a ser executada se a atualização monitorada falhar. Os valores aceitáveis para esse parâmetro são:

• Reversão
• Manual

Type:	UpgradeFailureAction
Accepted values:	Invalid, Rollback, Manual
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Indica que esse cmdlet ignora a mensagem de aviso e força a atualização.

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

-ForceRestart

Indica se o host de serviço é reiniciado mesmo que a atualização seja uma alteração somente de configuração.

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

-HealthCheckRetryTimeoutSec

Especifica a duração, em segundos, após a qual o Service Fabric tenta novamente a verificação de integridade se a verificação de integridade anterior falhar.

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

-HealthCheckStableDurationSec

Especifica a duração, em segundos, que o Service Fabric aguarda para verificar se o aplicativo está estável antes de continuar para o próximo domínio de atualização ou concluir a atualização. Essa duração de espera impede alterações não detectadas de integridade logo após a verificação de integridade ser executada.

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

-HealthCheckWaitDurationSec

Especifica a duração, em segundos, que o Service Fabric aguarda antes de executar a verificação de integridade inicial depois de concluir a atualização no domínio de atualização.

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

-InstanceCloseDelayDurationSec

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.

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

-MaxPercentUnhealthyDeployedApplications

Especifica o percentual máximo de aplicativos implantados tolerados que podem ter um estado de integridade de erro. Se a porcentagem de instâncias de aplicativo não íntegras implantadas nos nós no cluster exceder o valor especificado por esse parâmetro, o estado de integridade do aplicativo será um erro.

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

-ServiceTypeHealthPolicyMap

Especifica o mapa da política de integridade a ser usada para diferentes tipos de serviço. Especifique o mapa como uma tabela de hash no seguinte formato: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService, MaxPercentUnhealthyReplicasPerPartition, MaxPercentUnhealthyServices"}. Por exemplo:

@{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }

Type:	Hashtable
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

-UpgradeDomainTimeoutSec

Especifica o tempo máximo, em segundos, que o Service Fabric leva para atualizar um único domínio de atualização. Após esse período, a atualização falhará.

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

-UpgradeMode

Especifica o novo UpgradeMode para a atualização.

Type:	RollingUpgradeMode
Accepted values:	Invalid, UnmonitoredAuto, UnmonitoredManual, Monitored
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UpgradeReplicaSetCheckTimeoutSec

Especifica o tempo máximo, em segundos, que o Service Fabric aguarda que um serviço seja reconfigurado em um estado seguro, se ainda não estiver em um estado seguro, antes que o Service Fabric prossiga com a atualização.

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

-UpgradeTimeoutSec

Especifica o tempo máximo, em segundos, que o Service Fabric leva para toda a atualização. Após esse período, a atualização falhará.

Type:	UInt32
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

None

Saídas

System.Object

Links Relacionados

• Connect-ServiceFabricCluster
• Get-ServiceFabricApplicationUpgrade
• Get-ServiceFabricClusterConnection
• Resume-ServiceFabricApplicationUpgrade
• Start-ServiceFabricApplicationUpgrade
• Update-ServiceFabricClusterUpgrade