Update-ServiceFabricApplicationUpgrade
Modifica a descrição da atualização de uma atualização ativa da Aplicação.
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 da atualização da aplicação enquanto a atualização ainda está ativa. O Tecido de Serviço deteta e aplica alterações de acordo com o valor UpgradeStatusPollInterval , conforme especificado no manifesto do cluster. Com exceção das políticas de avaliação da saúde, este cmdlet atualiza apenas os parâmetros que especifica. Os parâmetros não especificados permanecem inalterados. Deve atualizar em conjunto as seguintes políticas de avaliação da saúde, não individualmente:
- ConsidereWarningAsError
- DefaultServiceTypeHealthPolicy
- MaxPercentUnhealthyDeployedApplicações
- ServiceTypeHealthPolicyMap
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 valor para uma atualização de aplicação
PS C:\> Update-ServiceFabricApplicationUpgrade -ApplicationName fabric:/MyApplication -UpgradeReplicaSetCheckTimeoutSec 0
Este comando define o valor de tempo de verificação definido da réplica para 0 para uma atualização pendente no tecido:/MyApplication. A atualização deixa todos os outros valores de upgrade em paz.
Parâmetros
-ApplicationName
Especifica o Identificador de Recursos Uniforme (URI) de uma aplicação de Tecido de Serviço. O cmdlet atualiza as definições para a atualização da aplicação que tem o URI que este parâmetro especifica.
Type: | Uri |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-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 |
-ConsiderWarningAsError
Indica se deve tratar um relatório de saúde de aviso como erro durante a avaliação de saúde.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultServiceTypeHealthPolicy
Especifica a política de saúde padrão para os tipos de serviço. A política de saúde é utilizada para a atualização monitorizada. A política segue o formato MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices. Por exemplo, 5,10,15 indica 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 tomar se a atualização monitorizada falhar. Os valores aceitáveis para este 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 este 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 anfitrião de serviço reinicia mesmo que a atualização seja uma alteração apenas 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 o qual o Service Fabric retira o exame de saúde se o exame de saúde 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 a aplicação é estável antes de continuar para o domínio de atualização seguinte ou completar a atualização. Esta duração de espera evita alterações de saúde não detetadas logo após a verificação de saúde.
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 efetuar a verificação de saúde inicial depois de terminar a atualização no domínio da 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, 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.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxPercentUnhealthyDeployedApplications
Especifica a percentagem máxima de aplicações implementadas toleradas que podem ter um estado de erro na saúde. Se a percentagem de instâncias de aplicação pouco saudáveis implementadas nos nós do cluster exceder o valor que este parâmetro especifica, o estado de saúde da aplicação é 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 saúde a utilizar para diferentes tipos de serviço. Especificar o mapa como uma tabela hash no seguinte formato: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyService"}. 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 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 |
-UpgradeDomainTimeoutSec
Especifica o tempo máximo, em segundos, que o Service Fabric leva para atualizar um único domínio de atualização. Após este período, a atualização falha.
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 espera que um serviço se reconfigure em estado seguro, se não já em estado seguro, antes de o Service Fabric prosseguir 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 este período, a atualização falha.
Type: | UInt32 |
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
None
Saídas
System.Object