Update-ServiceFabricApplicationUpgrade
Modifica a descrição da atualização de uma atualização ativa da Aplicação.
Sintaxe
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.
Tipo: | Uri |
Position: | 0 |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-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 |
-ConsiderWarningAsError
Indica se deve tratar um relatório de saúde de aviso como erro durante a avaliação de saúde.
Tipo: | Boolean |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | 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
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | 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
Tipo: | UpgradeFailureAction |
Valores aceites: | Invalid, Rollback, Manual |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-Force
Indica que este cmdlet ignora a mensagem de aviso e força a atualização.
Tipo: | SwitchParameter |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-ForceRestart
Indica se o anfitrião de serviço reinicia mesmo que a atualização seja uma alteração apenas de configuração.
Tipo: | Boolean |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | 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.
Tipo: | UInt32 |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | 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.
Tipo: | UInt32 |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | 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.
Tipo: | UInt32 |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | 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.
Tipo: | UInt32 |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | 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.
Tipo: | Byte |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | 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" }
Tipo: | Hashtable |
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 |
-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.
Tipo: | UInt32 |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-UpgradeMode
Especifica o novo UpgradeMode para a atualização.
Tipo: | RollingUpgradeMode |
Valores aceites: | Invalid, UnmonitoredAuto, UnmonitoredManual, Monitored |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | 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.
Tipo: | UInt32 |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | 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.
Tipo: | UInt32 |
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
None
Saídas
System.Object