Update-AzServiceFabricApplication

Módulo:

Az.ServiceFabric

Atualize um aplicativo de malha de serviço. Isso permite atualizar os parâmetros do aplicativo e/ou atualizar a versão do tipo de aplicativo que acionará uma atualização do aplicativo. Suporta apenas aplicações implementadas por ARM.

Sintaxe

Update-AzServiceFabricApplication
      [-ResourceGroupName] <String>
      [-ClusterName] <String>
      [-Name] <String>
      [[-ApplicationTypeVersion] <String>]
      [-ApplicationParameter <Hashtable>]
      [-MinimumNodeCount <Int64>]
      [-MaximumNodeCount <Int64>]
      [-ForceRestart]
      [-UpgradeReplicaSetCheckTimeoutSec <Int32>]
      [-FailureAction <FailureAction>]
      [-HealthCheckRetryTimeoutSec <Int32>]
      [-HealthCheckWaitDurationSec <Int32>]
      [-HealthCheckStableDurationSec <Int32>]
      [-UpgradeDomainTimeoutSec <Int32>]
      [-UpgradeTimeoutSec <Int32>]
      [-ConsiderWarningAsError]
      [-DefaultServiceTypeMaxPercentUnhealthyPartitionsPerService <Int32>]
      [-DefaultServiceTypeMaxPercentUnhealthyReplicasPerPartition <Int32>]
      [-DefaultServiceTypeUnhealthyServicesMaxPercent <Int32>]
      [-UnhealthyDeployedApplicationsMaxPercent <Int32>]
      [-ServiceTypeHealthPolicyMap <Hashtable>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzServiceFabricApplication
      [[-ApplicationTypeVersion] <String>]
      [-ApplicationParameter <Hashtable>]
      [-MinimumNodeCount <Int64>]
      [-MaximumNodeCount <Int64>]
      [-ForceRestart]
      [-UpgradeReplicaSetCheckTimeoutSec <Int32>]
      [-FailureAction <FailureAction>]
      [-HealthCheckRetryTimeoutSec <Int32>]
      [-HealthCheckWaitDurationSec <Int32>]
      [-HealthCheckStableDurationSec <Int32>]
      [-UpgradeDomainTimeoutSec <Int32>]
      [-UpgradeTimeoutSec <Int32>]
      [-ConsiderWarningAsError]
      [-DefaultServiceTypeMaxPercentUnhealthyPartitionsPerService <Int32>]
      [-DefaultServiceTypeMaxPercentUnhealthyReplicasPerPartition <Int32>]
      [-DefaultServiceTypeUnhealthyServicesMaxPercent <Int32>]
      [-UnhealthyDeployedApplicationsMaxPercent <Int32>]
      [-ServiceTypeHealthPolicyMap <Hashtable>]
      [-ResourceId] <String>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzServiceFabricApplication
      -InputObject <PSApplication>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Esse cmdlet pode ser usado para atualizar parâmetros de aplicativo e atualizar a versão de tipo de aplicativo. A atualização do parâmetro só mudará o modelo no lado ARM, somente quando uma nova versão do tipo for usada, o comando acionará uma atualização do aplicativo. A versão do tipo especificada já deve ser criada no cluster usando New-AzServiceFabricApplicationTypeVersion.

Exemplos

Exemplo 1

$resourceGroupName = "testRG"
$clusterName = "testCluster"
$appName = "testApp"
$version = "v2"
$packageUrl = "https://sftestapp.blob.core.windows.net/sftestapp/testAppType_v2.sfpkg"
New-AzServiceFabricApplicationTypeVersion -ResourceGroupName $resourceGroupName -ClusterName $clusterName -Name $appName -Version $version -PackageUrl $packageUrl -Verbose
Update-AzServiceFabricApplication -ResourceGroupName $resourceGroupName -ClusterName $clusterName -ApplicationTypeVersion $version -Name $appName -ApplicationParameter @{key0="value0";key1=$null;key2="value2"}

Este exemplo iniciará uma atualização de aplicativo para atualizar a versão do tipo para "v2", que foi criada com New-AzServiceFabricApplicationTypeVersion. Os parâmetros de aplicação utilizados devem ser definidos no manifesto da aplicação.

Exemplo 2

$resourceGroupName = "testRG"
$clusterName = "testCluster"
$appName = "testApp"
Update-AzServiceFabricApplication -ResourceGroupName $resourceGroupName -ClusterName $clusterName -Name $appName -MinimumNodeCount 1 -MaximumNodeCount 4 -Verbose

Este exemplo atualizará o número mínimo e máximo de restrição de nós para o aplicativo.

Exemplo 3

$resourceGroupName = "testRG"
$clusterName = "testCluster"
$appName = "testApp"
$version = "v2"
$packageUrl = "https://sftestapp.blob.core.windows.net/sftestapp/testAppType_v2.sfpkg"
New-AzServiceFabricApplicationTypeVersion -ResourceGroupName $resourceGroupName -ClusterName $clusterName -Name $appName -Version $version -PackageUrl $packageUrl -Verbose
Update-AzServiceFabricApplication -ResourceGroupName $resourceGroupName -ClusterName $clusterName -ApplicationTypeVersion $version -Name $appName -ApplicationParameter @{key0="value0";key1=$null;key2="value2"} -HealthCheckStableDurationSec 0 -HealthCheckWaitDurationSec 0 -HealthCheckRetryTimeoutSec 0 -UpgradeDomainTimeoutSec 5000 -UpgradeTimeoutSec 7000 -FailureAction Rollback -UpgradeReplicaSetCheckTimeoutSec 300 -ForceRestart

Este exemplo iniciará uma atualização de aplicativo para atualizar a versão do tipo para "v2" e também define alguns parâmetros de política de atualização que entrarão em vigor a partir da atualização atual.

Exemplo 4

Update-AzServiceFabricApplication -ResourceGroupName $resourceGroupName -ClusterName $clusterName -Name $appName -ApplicationParameter @{key0="value0";key1=$null;key2="value2"}

Este exemplo atualiza os parâmetros do aplicativo, mas essas alterações só terão efeito até a próxima atualização da versão para o aplicativo.

Parâmetros

-ApplicationParameter

Especifique os parâmetros do aplicativo como pares chave/valor. Esses parâmetros devem existir no manifesto do aplicativo.

Tipo:	Hashtable
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ApplicationTypeVersion

Especificar a versão do tipo de aplicativo

Tipo:	String
Position:	3
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ClusterName

Especifique o nome do cluster.

Tipo:	String
Position:	1
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ConsiderWarningAsError

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

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DefaultServiceTypeMaxPercentUnhealthyPartitionsPerService

Especifica a porcentagem máxima de partições unhelthy por serviço permitido pela diretiva de integridade para o tipo de serviço padrão a ser usado para a atualização monitorada.

Tipo:	Int32
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DefaultServiceTypeMaxPercentUnhealthyReplicasPerPartition

Especifica a porcentagem máxima de réplicas não acumuladas por serviço permitida pela diretiva de integridade para o tipo de serviço padrão a ser usado para a atualização monitorada.

Tipo:	Int32
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DefaultServiceTypeUnhealthyServicesMaxPercent

Especifica a porcentagem máxima de serviços não autorizados pela diretiva de integridade para o tipo de serviço padrão a ser usado para a atualização monitorada.

Tipo:	Int32
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 Rollback ou Manual.

Tipo:	FailureAction
Valores aceites:	Rollback, Manual
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ForceRestart

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

Tipo:	SwitchParameter
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:	Int32
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 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.

Tipo:	Int32
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:	Int32
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-InputObject

O recurso do aplicativo.

Tipo:	PSApplication
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-MaximumNodeCount

Especifica o número máximo de nós nos quais colocar um aplicativo

Tipo:	Int64
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-MinimumNodeCount

Especifica o número mínimo de nós em que o Service Fabric reservará capacidade para este aplicativo

Tipo:	Int64
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Name

Especifique o nome do aplicativo

Tipo:	String
Aliases:	ApplicationName
Position:	2
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ResourceGroupName

Especifique o nome do grupo de recursos.

Tipo:	String
Position:	0
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-ResourceId

Arm ResourceId do aplicativo.

Tipo:	String
Position:	0
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	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" }

Tipo:	Hashtable
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-UnhealthyDeployedApplicationsMaxPercent

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.

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:	Int32
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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.

Tipo:	Int32
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:	Int32
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:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

Entradas

String

PSApplication

Saídas

PSApplication