Update-ServiceFabricApplicationUpgrade
Modifica a descrição de atualização de uma atualização de aplicativo ativa.
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 de atualização de aplicativo enquanto a atualização ainda está ativa. O Service Fabric deteta e aplica alterações de acordo com o valor de 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 inalterados. Você deve atualizar as seguintes políticas de avaliação de saúde 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
Exemplos
Exemplo 1: Atualizar um valor para uma atualização de aplicativo
PS C:\> Update-ServiceFabricApplicationUpgrade -ApplicationName fabric:/MyApplication -UpgradeReplicaSetCheckTimeoutSec 0
Este 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 da atualização para o aplicativo que tem o URI especificado por esse parâmetro.
Tipo: | Uri |
Position: | 0 |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-Confirm
Solicita 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 um relatório de integridade de aviso deve ser tratado como erro durante a avaliação de integridade.
Tipo: | Boolean |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-DefaultServiceTypeHealthPolicy
Especifica a diretiva 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 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 ser executada se a atualização monitorada 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 esse 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 host de serviço é reiniciado mesmo que a atualização seja uma alteração somente 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 a qual o Service Fabric tenta novamente a verificação de integridade se a verificação de integridade 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 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 evita alterações de integridade não detetadas logo após a verificação de integridade ser executada.
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 executar a verificação de integridade inicial depois de concluir a atualização no domínio de 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 até que uma instância sem monitoração de 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 somente para as instâncias dos serviços sem monitoração de estado que têm um valor diferente de zero configurado para InstanceCloseDelayDuration e substituirão o valor pré-configurado. Consulte InstanceCloseDelayDuration para obter detalhes.
Tipo: | UInt32 |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-MaxPercentUnhealthyDeployedApplications
Especifica a porcentagem máxima de aplicativos implantados tolerados que podem ter um estado de erro de integridade. Se a porcentagem de instâncias de aplicativo não íntegras implantadas nos nós do cluster exceder o valor especificado por esse parâmetro, o estado de integridade do aplicativo será de 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 diretiva 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" }
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 limite, 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 esse período, a atualização falhará.
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 aguarda a reconfiguração de um serviço em um estado seguro, se ainda não estiver em um estado seguro, antes que o Service Fabric prossiga 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 esse período, a atualização falhará.
Tipo: | UInt32 |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. 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