Update-AzServiceFabricApplication

Referens

Modul:: Az.ServiceFabric

Uppdatera ett Service Fabric-program. På så sätt kan du uppdatera programparametrarna och/eller uppgradera den version av programtypen som utlöser en programuppgradering. Stöder endast ARM-distribuerade program.

Syntax

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

Den här cmdleten kan användas för att uppdatera programparametrar och uppgradera programtypsversionen. Om du uppdaterar parametern ändras bara modellen på ARM-sidan, bara när en ny typversion används utlöser kommandot en programuppgradering. Den angivna typversionen bör redan skapas i klustret med hjälp av New-AzServiceFabricApplicationTypeVersion.

Exempel

Exempel 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"}

Det här exemplet startar en programuppgradering för att uppdatera typversionen till "v2" som skapades med New-AzServiceFabricApplicationTypeVersion. De programparametrar som används ska definieras i programmanifestet.

Exempel 2

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

Det här exemplet uppdaterar begränsningen för minsta och högsta antal noder för programmet.

Exempel 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

Det här exemplet startar en programuppgradering för att uppdatera typversionen till "v2" och anger även några uppgraderingsprincipparametrar som börjar gälla från den aktuella uppgraderingen.

Exempel 4

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

I det här exemplet uppdateras programparametrarna, men de här ändringarna börjar gälla först när nästa version uppgraderas till programmet.

Parametrar

-ApplicationParameter

Ange programparametrarna som nyckel/värde-par. Dessa parametrar måste finnas i programmanifestet.

Typ:	Hashtable
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ApplicationTypeVersion

Ange programtypsversionen

Typ:	String
Position:	3
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ClusterName

Ange namnet på klustret.

Typ:	String
Position:	1
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:	SwitchParameter
Alias:	cf
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ConsiderWarningAsError

Anger om en varningshälsohändelse ska behandlas som en felhändelse under hälsoutvärderingen.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DefaultServiceTypeMaxPercentUnhealthyPartitionsPerService

Anger den maximala procentandelen icke-hjälppartitioner per tjänst som tillåts av hälsoprincipen för standardtjänsttypen som ska användas för den övervakade uppgraderingen.

Typ:	Int32
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DefaultServiceTypeMaxPercentUnhealthyReplicasPerPartition

Anger den maximala procentandelen icke-hjälprepliker per tjänst som tillåts av hälsoprincipen för standardtjänsttypen som ska användas för den övervakade uppgraderingen.

Typ:	Int32
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DefaultServiceTypeUnhealthyServicesMaxPercent

Anger den maximala procentandelen ohjälpstjänster som tillåts av hälsoprincipen för den standardtjänsttyp som ska användas för den övervakade uppgraderingen.

Typ:	Int32
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-FailureAction

Anger vilken åtgärd som ska vidtas om den övervakade uppgraderingen misslyckas. De acceptabla värdena för den här parametern är Återställning eller Manuell.

Typ:	FailureAction
Godkända värden:	Rollback, Manual
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ForceRestart

Anger att tjänstvärden startas om även om uppgraderingen är en konfigurationsändring.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-HealthCheckRetryTimeoutSec

Anger varaktigheten, i sekunder, varefter Service Fabric försöker utföra hälsokontrollen igen om den tidigare hälsokontrollen misslyckas.

Typ:	Int32
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-HealthCheckStableDurationSec

Anger varaktigheten i sekunder som Service Fabric väntar för att kontrollera att programmet är stabilt innan det flyttas till nästa uppgraderingsdomän eller slutför uppgraderingen. Den här väntetiden förhindrar oupptäckta hälsoändringar direkt efter att hälsokontrollen har utförts.

Typ:	Int32
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-HealthCheckWaitDurationSec

Anger varaktigheten, i sekunder, som Service Fabric väntar innan den utför den första hälsokontrollen när uppgraderingen har slutförts på uppgraderingsdomänen.

Typ:	Int32
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-InputObject

Programresursen.

Typ:	PSApplication
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-MaximumNodeCount

Anger det maximala antalet noder som ett program ska placeras på

Typ:	Int64
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-MinimumNodeCount

Anger det minsta antalet noder där Service Fabric reserverar kapacitet för det här programmet

Typ:	Int64
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Name

Ange namnet på programmet

Typ:	String
Alias:	ApplicationName
Position:	2
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ResourceGroupName

Ange namnet på resursgruppen.

Typ:	String
Position:	0
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-ResourceId

Arm ResourceId för programmet.

Typ:	String
Position:	0
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-ServiceTypeHealthPolicyMap

Anger kartan över hälsoprincipen som ska användas för olika tjänsttyper som en hash-tabell i följande format: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Till exempel: @{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }

Typ:	Hashtable
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-UnhealthyDeployedApplicationsMaxPercent

Anger den maximala procentandelen av de programinstanser som distribueras på noderna i klustret som har ett feltillstånd innan programmets hälsotillstånd för klustret är fel.

Typ:	Int32
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-UpgradeDomainTimeoutSec

Anger den maximala tid i sekunder som Service Fabric tar att uppgradera en enda uppgraderingsdomän. Efter den här perioden misslyckas uppgraderingen.

Typ:	Int32
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-UpgradeReplicaSetCheckTimeoutSec

Anger den maximala tid som Service Fabric väntar på att en tjänst ska konfigureras om till ett säkert tillstånd, om inte redan i säkert tillstånd, innan Service Fabric fortsätter med uppgraderingen.

Typ:	Int32
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-UpgradeTimeoutSec

Anger den maximala tid i sekunder som Service Fabric tar för hela uppgraderingen. Efter den här perioden misslyckas uppgraderingen.

Typ:	Int32
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:	SwitchParameter
Alias:	wi
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

Indata

String

PSApplication

Utdata