Partilhar via

Start-ServiceFabricApplicationUpgrade

Módulo:
ServiceFabric Module

Atualiza um aplicativo do Service Fabric para ApplicationTypeVersion especificado.

Sintaxe

UnmonitoredAuto (Predefinição) 

Start-ServiceFabricApplicationUpgrade
    [-ApplicationName] <Uri>
    [-ApplicationTypeVersion] <String>
    [[-ApplicationParameter] <Hashtable>]
    [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
    [[-SortOrder] <UpgradeSortOrder>]
    [-ForceRestart]
    [-ReplicaQuorumTimeoutSec <UInt32>]
    [-RestartProcess]
    [-InstanceCloseDelayDurationSec <UInt32>]
    [-UnmonitoredAuto]
    [-Force]
    [-TimeoutSec <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UnmonitoredManual 

Start-ServiceFabricApplicationUpgrade
    [-ApplicationName] <Uri>
    [-ApplicationTypeVersion] <String>
    [[-ApplicationParameter] <Hashtable>]
    [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
    [[-SortOrder] <UpgradeSortOrder>]
    [-ForceRestart]
    [-ReplicaQuorumTimeoutSec <UInt32>]
    [-RestartProcess]
    [-InstanceCloseDelayDurationSec <UInt32>]
    [-UnmonitoredManual]
    [-Force]
    [-TimeoutSec <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Monitored 

Start-ServiceFabricApplicationUpgrade
    [-ApplicationName] <Uri>
    [-ApplicationTypeVersion] <String>
    [[-ApplicationParameter] <Hashtable>]
    [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
    [[-SortOrder] <UpgradeSortOrder>]
    -FailureAction <UpgradeFailureAction>
    [-ForceRestart]
    [-ReplicaQuorumTimeoutSec <UInt32>]
    [-RestartProcess]
    [-InstanceCloseDelayDurationSec <UInt32>]
    [-Monitored]
    [-HealthCheckRetryTimeoutSec <UInt32>]
    [-HealthCheckWaitDurationSec <UInt32>]
    [-HealthCheckStableDurationSec <UInt32>]
    [-UpgradeDomainTimeoutSec <UInt32>]
    [-UpgradeTimeoutSec <UInt32>]
    [-ConsiderWarningAsError <Boolean>]
    [-DefaultServiceTypeHealthPolicy <String>]
    [-MaxPercentUnhealthyDeployedApplications <Byte>]
    [-ServiceTypeHealthPolicyMap <Hashtable>]
    [-Force]
    [-TimeoutSec <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O cmdlet Start-ServiceFabricApplicationUpgrade atualiza um aplicativo do Service Fabric. Antes de usar esse cmdlet, você precisa copiar o pacote de aplicativo atualizado para o armazenamento de imagens e registrar o tipo de aplicativo atualizado. Use o Copy-ServiceFabricApplicationPackage para copiar o pacote do aplicativo para o armazenamento de imagens. Use o cmdlet Register-ServiceFabricApplicationType para registrar o tipo de aplicativo atualizado.

Este cmdlet inicia a atualização no cluster.

ApplicationParameters não são preservados em uma atualização de aplicativo. Para preservar os parâmetros atuais do aplicativo, o usuário deve obter os parâmetros primeiro e passá-los para a chamada de API de atualização, conforme mostrado no Exemplo 1 abaixo.

Para obter mais informações sobre atualizações de aplicativos do Service Fabric, consulte a documentação conceitual.

Antes de executar qualquer operação em um cluster do Service Fabric, estabeleça uma ligação ao cluster utilizando o cmdlet Connect-ServiceFabricCluster .

Exemplos

Exemplo 1: Obter os parâmetros do aplicativo para passar para a chamada de atualização

$myApplication = Get-ServiceFabricApplication -ApplicationName fabric:/myApplication
$appParamCollection = $myApplication.ApplicationParameters
$applicationParameterMap = @{}

foreach ($pair in $appParamCollection)
{ $applicationParameterMap.Add($pair.Name, $pair.Value); }

Start-ServiceFabricApplicationUpgrade -ApplicationName fabric:/myApplication -ApplicationTypeVersion 2.0.0 -ApplicationParameter $applicationParameterMap -Monitored -FailureAction Rollback

Exemplo 2: Atualizar um aplicativo

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "C:\PersistentToDoListServiceV2" -ImageStoreConnectionString "file:C:\ProgramData\ServiceFabric\ImageStore"
PS C:\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore "PersistentToDoListServiceV2"
PS C:\> Start-ServiceFabricApplicationUpgrade -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeVersion "2.0" -ForceRestart -UnMonitoredManual

O primeiro comando usa o cmdlet Copy-ServiceFabricApplicationPackage para copiar o pacote de aplicativo atualizado para o repositório de imagens.

O segundo comando usa o cmdlet Register-ServiceFabricApplicationType para registrar o tipo de aplicativo atualizado.

O terceiro comando atualiza o aplicativo. O comando executa uma atualização manual não monitorada, que inclui uma reinicialização do servidor que hospeda o aplicativo.

Parâmetros

-ApplicationName

Especifica o URI (Uniform Resource Identifier) de um aplicativo do Service Fabric. O cmdlet atualiza o aplicativo que tem o URI especificado.

Propriedades dos parâmetros

Tipo:Uri
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ApplicationParameter

Especifica as substituições para parâmetros de aplicativo como pares nome/valor.

Propriedades dos parâmetros

Tipo:Hashtable
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:2
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ApplicationTypeVersion

Especifica a versão de um tipo de aplicativo do Service Fabric. O cmdlet atualiza o aplicativo para a versão especificada.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ConsiderWarningAsError

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

Propriedades dos parâmetros

Tipo:Boolean
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Monitored
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DefaultServiceTypeHealthPolicy

Especifica a política de saúde para o tipo de serviço padrão usado na atualização monitorada no formato MaxPercentUnhealthyPartitionsPerService, MaxPercentUnhealthyReplicasPerPartition, MaxPercentUnhealthyServices. Por exemplo, 5,10,15 indica os seguintes valores:

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Monitored
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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

Propriedades dos parâmetros

Tipo:UpgradeFailureAction
Default value:None
Valores aceites:Invalid, Rollback, Manual
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Monitored
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Force

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ForceRestart

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:3
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:UInt32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Monitored
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-HealthCheckStableDurationSec

Especifica a duração, em segundos, que o Service Fabric aguarda para verificar se o aplicativo está estável antes de passar 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.

Propriedades dos parâmetros

Tipo:UInt32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Monitored
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:UInt32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Monitored
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 (em New-ServiceFabricService) para obter detalhes.

Propriedades dos parâmetros

Tipo:UInt32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-MaxPercentUnhealthyDeployedApplications

Especifica a porcentagem máxima das instâncias de aplicativo implantadas nos nós do cluster que têm um estado de integridade de erro antes que o estado de integridade do aplicativo para o cluster seja erro.

Propriedades dos parâmetros

Tipo:Byte
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Monitored
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Monitored

Indica que o modo de atualização é monitorado. Depois que o cmdlet concluir uma atualização para um domínio de atualização, se a integridade do domínio de atualização e do cluster atenderem às políticas de integridade definidas, o Service Fabric atualizará o próximo domínio de atualização. Se o domínio ou cluster de atualização não atender às políticas de integridade, a atualização falhará e o Service Fabric reverterá a atualização para o domínio de atualização ou reverterá para o modo manual de acordo com a política especificada. Este é o modo recomendado para atualizações de aplicativos em um ambiente de produção.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Monitored
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ReplicaQuorumTimeoutSec

Especifica o período de tempo limite, em segundos, para verificar se o conjunto de réplicas tem quórum. Após o período de tempo limite, a atualização prossegue.

Este parâmetro foi preterido. Em vez disso, especifique o parâmetro UpgradeReplicaSetCheckTimeoutSec .

Propriedades dos parâmetros

Tipo:UInt32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-RestartProcess

Indica que o host de serviço é reiniciado como parte da atualização.

Este parâmetro foi preterido. Em vez disso, especifique o parâmetro ForceRestart .

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ServiceTypeHealthPolicyMap

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

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

Propriedades dos parâmetros

Tipo:Hashtable
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Monitored
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-SortOrder

Define a ordem em que uma atualização prossegue através do cluster.

Os valores possíveis são:

  • Invalid - Indica que esta ordem de classificação não é válida. Todas as enumerações do Service Fabric têm o tipo inválido.
  • Default - Indica que a ordem de classificação padrão (conforme especificado no manifesto do cluster) será usada.
  • Numeric - Indica que a ordem de classificação numérica direta (nomes UD classificados como números) será usada.
  • Lexicographical - Indica que a ordem de classificação lexicográfica direta (nomes UD classificados como strings) será usada.
  • ReverseNumeric - Indica que a ordem de classificação numérica inversa (nomes UD ordenados como números) será usada.
  • ReverseLexicographical- Indica que a ordem de classificação lexicográfica inversa (nomes UD classificados como strings) será usada.

Propriedades dos parâmetros

Tipo:UpgradeSortOrder
Default value:None
Valores aceites:Invalid, Default, Numeric, Lexicographical, ReverseNumeric, ReverseLexicographical
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:5
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-TimeoutSec

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

Propriedades dos parâmetros

Tipo:Int32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-UnmonitoredAuto

Indica que o modo de atualização é automático não monitorado. Depois que o Service Fabric atualiza um domínio de atualização, o Service Fabric atualiza o próximo domínio de atualização, independentemente do estado de integridade do aplicativo. Este modo não é recomendado para produção e só é útil durante o desenvolvimento de uma aplicação.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

UnmonitoredAuto
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-UnmonitoredManual

Indica que o modo de atualização não é monitorado manualmente. Depois que o Service Fabric atualiza um domínio de atualização, ele aguarda que você atualize o próximo domínio de atualização usando o cmdlet Resume-ServiceFabricApplicationUpgrade .

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

UnmonitoredManual
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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á.

Propriedades dos parâmetros

Tipo:UInt32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Monitored
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-UpgradeReplicaSetCheckTimeoutSec

Especifica o tempo máximo que o Service Fabric aguarda para 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.

Propriedades dos parâmetros

Tipo:UInt32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:4
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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á.

Propriedades dos parâmetros

Tipo:UInt32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Monitored
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

None

Saídas

System.Object