Set-AzServiceFabricManagedClusterApplication

Modulo:: Az.ServiceFabric Module

Aggiornare un'applicazione gestita di Service Fabric. In questo modo è possibile aggiornare i parametri dell'applicazione e/o aggiornare la versione del tipo di applicazione che attiverà un aggiornamento dell'applicazione o altri aggiornamenti di sola configurazione. Supporta solo le applicazioni arm distribuite.

Sintassi

ByResourceGroup (Impostazione predefinita)

Set-AzServiceFabricManagedClusterApplication
    [-ResourceGroupName] <String>
    [-ClusterName] <String>
    [-Name] <String>
    [[-ApplicationTypeVersion] <String>]
    [-ApplicationParameter <Hashtable>]
    [-ForceRestart]
    [-RecreateApplication]
    [-UpgradeReplicaSetCheckTimeoutSec <Int32>]
    [-InstanceCloseDelayDurationSec <Int32>]
    [-UpgradeMode <ApplicationUpgradeMode>]
    [-FailureAction <FailureAction>]
    [-HealthCheckRetryTimeoutSec <Int32>]
    [-HealthCheckWaitDurationSec <Int32>]
    [-HealthCheckStableDurationSec <Int32>]
    [-UpgradeDomainTimeoutSec <Int32>]
    [-UpgradeTimeoutSec <Int32>]
    [-ConsiderWarningAsError]
    [-DefaultServiceTypeMaxPercentUnhealthyPartitionsPerService <Int32>]
    [-DefaultServiceTypeMaxPercentUnhealthyReplicasPerPartition <Int32>]
    [-DefaultServiceTypeUnhealthyServicesMaxPercent <Int32>]
    [-UnhealthyDeployedApplicationsMaxPercent <Int32>]
    [-ServiceTypeHealthPolicyMap <Hashtable>]
    [-Tag <Hashtable>]
    [-Force]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByResourceId

Set-AzServiceFabricManagedClusterApplication
    [[-ApplicationTypeVersion] <String>]
    -ResourceId <String>
    [-ApplicationParameter <Hashtable>]
    [-ForceRestart]
    [-RecreateApplication]
    [-UpgradeReplicaSetCheckTimeoutSec <Int32>]
    [-InstanceCloseDelayDurationSec <Int32>]
    [-UpgradeMode <ApplicationUpgradeMode>]
    [-FailureAction <FailureAction>]
    [-HealthCheckRetryTimeoutSec <Int32>]
    [-HealthCheckWaitDurationSec <Int32>]
    [-HealthCheckStableDurationSec <Int32>]
    [-UpgradeDomainTimeoutSec <Int32>]
    [-UpgradeTimeoutSec <Int32>]
    [-ConsiderWarningAsError]
    [-DefaultServiceTypeMaxPercentUnhealthyPartitionsPerService <Int32>]
    [-DefaultServiceTypeMaxPercentUnhealthyReplicasPerPartition <Int32>]
    [-DefaultServiceTypeUnhealthyServicesMaxPercent <Int32>]
    [-UnhealthyDeployedApplicationsMaxPercent <Int32>]
    [-ServiceTypeHealthPolicyMap <Hashtable>]
    [-Tag <Hashtable>]
    [-Force]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByInputObject

Set-AzServiceFabricManagedClusterApplication
    [[-ApplicationTypeVersion] <String>]
    -InputObject <PSManagedApplication>
    [-ApplicationParameter <Hashtable>]
    [-ForceRestart]
    [-RecreateApplication]
    [-UpgradeReplicaSetCheckTimeoutSec <Int32>]
    [-InstanceCloseDelayDurationSec <Int32>]
    [-UpgradeMode <ApplicationUpgradeMode>]
    [-FailureAction <FailureAction>]
    [-HealthCheckRetryTimeoutSec <Int32>]
    [-HealthCheckWaitDurationSec <Int32>]
    [-HealthCheckStableDurationSec <Int32>]
    [-UpgradeDomainTimeoutSec <Int32>]
    [-UpgradeTimeoutSec <Int32>]
    [-ConsiderWarningAsError]
    [-DefaultServiceTypeMaxPercentUnhealthyPartitionsPerService <Int32>]
    [-DefaultServiceTypeMaxPercentUnhealthyReplicasPerPartition <Int32>]
    [-DefaultServiceTypeUnhealthyServicesMaxPercent <Int32>]
    [-UnhealthyDeployedApplicationsMaxPercent <Int32>]
    [-ServiceTypeHealthPolicyMap <Hashtable>]
    [-Tag <Hashtable>]
    [-Force]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrizione

Questo cmdlet può essere usato per aggiornare i parametri dell'applicazione e aggiornare la versione del tipo di applicazione insieme ad altri aggiornamenti di sola configurazione. L'aggiornamento del parametro modificherà il modello solo sul lato ARM, solo quando viene usata una nuova versione del tipo, il comando attiverà un aggiornamento dell'applicazione. La versione del tipo specificata deve essere già creata nel cluster usando New-AzServiceFabricManagedClusterApplicationTypeVersion.

Esempio

Esempio 1

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

Questo esempio avvia un aggiornamento dell'applicazione gestita per aggiornare la versione del tipo a "v2" creata con New-AzServiceFabricManagedClusterApplicationTypeVersion. I parametri dell'applicazione usati devono essere definiti nel manifesto dell'applicazione.

Esempio 2

$resourceGroupName = "testRG"
$clusterName = "testCluster"
$appName = "testApp"
Set-AzServiceFabricManagedClusterApplication -ResourceGroupName $resourceGroupName -ClusterName $clusterName -Name $appName -FailureAction Rollback -ForceRestart:$false -Verbose

Questo esempio aggiorna FailureAction e imposta ForceRestart su false.

Esempio 3

$resourceGroupName = "testRG"
$clusterName = "testCluster"
$appName = "testApp"
$version = "v2"
$packageUrl = "https://sftestapp.blob.core.windows.net/sftestapp/testAppType_v2.sfpkg"
New-AzServiceFabricManagedClusterApplicationTypeVersion -ResourceGroupName $resourceGroupName -ClusterName $clusterName -Name $appName -Version $version -PackageUrl $packageUrl -Verbose
Set-AzServiceFabricManagedClusterApplication -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

Questo esempio avvia un aggiornamento dell'applicazione per aggiornare la versione del tipo a "v2" e imposta anche alcuni parametri dei criteri di aggiornamento che avranno effetto dall'aggiornamento corrente.

Esempio 4

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

Questo esempio aggiorna i parametri dell'applicazione, ma queste modifiche avranno effetto solo fino all'aggiornamento della versione successiva all'applicazione.

Parametri

-ApplicationParameter

Specificare i parametri dell'applicazione come coppie chiave/valore. Questi parametri devono esistere nel manifesto dell'applicazione.

Proprietà dei parametri

Tipo:	Hashtable
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-ApplicationTypeVersion

Specificare la versione del tipo di applicazione

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	3
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-AsJob

Eseguire il cmdlet in background e restituire un processo per tenere traccia dello stato di avanzamento.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-ClusterName

Specificare il nome del cluster.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

ByResourceGroup

Posizione:	1
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	Cfr

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-ConsiderWarningAsError

Indica se considerare un evento di integrità di avviso come evento di errore durante la valutazione dell'integrità.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Proprietà dei parametri

Tipo:	IAzureContextContainer
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	AzContext, AzureRmContext, AzureCredential

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-DefaultServiceTypeMaxPercentUnhealthyPartitionsPerService

Specifica la percentuale massima di partizioni non integre per servizio consentite dai criteri di integrità per il tipo di servizio predefinito da utilizzare per l'aggiornamento monitorato.

Proprietà dei parametri

Tipo:	Int32
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-DefaultServiceTypeMaxPercentUnhealthyReplicasPerPartition

Specifica la percentuale massima di repliche non integre per servizio consentite dai criteri di integrità per il tipo di servizio predefinito da utilizzare per l'aggiornamento monitorato.

Proprietà dei parametri

Tipo:	Int32
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-DefaultServiceTypeUnhealthyServicesMaxPercent

Specifica la percentuale massima di servizi non integri consentiti dai criteri di integrità per il tipo di servizio predefinito da utilizzare per l'aggiornamento monitorato.

Proprietà dei parametri

Tipo:	Int32
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-FailureAction

Specifica l'azione da eseguire se l'aggiornamento monitorato non riesce. I valori accettabili per questo parametro sono Rollback o Manual.

Proprietà dei parametri

Tipo:	FailureAction
Valore predefinito:	None
Valori accettati:	Rollback, Manual
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Force

Continuare senza prompt

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-ForceRestart

Indica che l'host del servizio viene riavviato anche se l'aggiornamento è una modifica di sola configurazione.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-HealthCheckRetryTimeoutSec

Specifica la durata, espressa in secondi, dopo la quale Il servizio Fabric ritenta il controllo integrità se il controllo integrità precedente ha esito negativo.

Proprietà dei parametri

Tipo:	Int32
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-HealthCheckStableDurationSec

Specifica la durata, in secondi, che Service Fabric attende per verificare che l'applicazione sia stabile prima di passare al dominio di aggiornamento successivo o completare l'aggiornamento. Questa durata di attesa impedisce modifiche non rilevate dell'integrità subito dopo l'esecuzione del controllo integrità.

Proprietà dei parametri

Tipo:	Int32
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-HealthCheckWaitDurationSec

Specifica la durata, espressa in secondi, che il servizio Fabric attende prima di eseguire il controllo di integrità iniziale al termine dell'aggiornamento nel dominio di aggiornamento.

Proprietà dei parametri

Tipo:	Int32
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-InputObject

Risorsa dell'applicazione gestita.

Proprietà dei parametri

Tipo:	PSManagedApplication
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

ByInputObject

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	True
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-InstanceCloseDelayDurationSec

Specifica la durata, in secondi, di attesa prima della chiusura di un'istanza senza stato, per consentire alle richieste attive di svuotare normalmente.

Proprietà dei parametri

Tipo:	Int32
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Name

Specificare il nome dell'applicazione

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	ApplicationName

Set di parametri

ByResourceGroup

Posizione:	2
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-RecreateApplication

Determina se l'applicazione deve essere ricreata in caso di aggiornamento. Se value=true, il resto dei parametri dei criteri di aggiornamento non è consentito.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-ResourceGroupName

Specificare il nome del gruppo di risorse.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

ByResourceGroup

Posizione:	0
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-ResourceId

ResourceId arm dell'applicazione gestita.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

ByResourceId

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-ServiceTypeHealthPolicyMap

Specifica la mappa dei criteri di integrità da usare per diversi tipi di servizio come tabella hash nel formato seguente: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Ad esempio: @{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }

Proprietà dei parametri

Tipo:	Hashtable
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Tag

Specificare i tag come coppie chiave/valore.

Proprietà dei parametri

Tipo:	Hashtable
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-UnhealthyDeployedApplicationsMaxPercent

Specifica la percentuale massima delle istanze dell'applicazione distribuite nei nodi del cluster con uno stato di integrità di errore prima che lo stato di integrità dell'applicazione per il cluster sia errore.

Proprietà dei parametri

Tipo:	Int32
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-UpgradeDomainTimeoutSec

Specifica il tempo massimo, espresso in secondi, che il servizio Fabric richiede per aggiornare un singolo dominio di aggiornamento. Dopo questo periodo, l'aggiornamento non riesce.

Proprietà dei parametri

Tipo:	Int32
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-UpgradeMode

Modalità utilizzata per monitorare l'integrità durante un aggiornamento in sequenza. I valori sono Monitored e UnmonitoredAuto.

Proprietà dei parametri

Tipo:	ApplicationUpgradeMode
Valore predefinito:	None
Valori accettati:	Monitored, UnmonitoredAuto
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-UpgradeReplicaSetCheckTimeoutSec

Specifica il tempo massimo di attesa del servizio Fabric per la riconfigurazione di un servizio in uno stato sicuro, se non già in uno stato sicuro, prima che il servizio Fabric procede con l'aggiornamento.

Proprietà dei parametri

Tipo:	Int32
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-UpgradeTimeoutSec

Specifica il tempo massimo, espresso in secondi, che il servizio Fabric richiede per l'intero aggiornamento. Dopo questo periodo, l'aggiornamento non riesce.

Proprietà dei parametri

Tipo:	Int32
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	Wi

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Output

PSManagedApplication

Commenti e suggerimenti

Questa pagina è stata utile?