Set-AzServiceFabricManagedClusterApplication
Actualice una aplicación administrada de Service Fabric. Esto permite actualizar los parámetros de la aplicación o actualizar la versión del tipo de aplicación que desencadenará una actualización de la aplicación u otras actualizaciones solo de configuración. Solo admite aplicaciones implementadas por ARM.
Syntax
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>]
Set-AzServiceFabricManagedClusterApplication
[[-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>]
-ResourceId <String>
[-Force]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzServiceFabricManagedClusterApplication
[[-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>]
-InputObject <PSManagedApplication>
[-Force]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Este cmdlet se puede usar para actualizar los parámetros de la aplicación y actualizar la versión del tipo de aplicación junto con otras actualizaciones solo de configuración. La actualización del parámetro solo cambiará el modelo en arm, solo cuando se use una nueva versión de tipo, el comando desencadenará una actualización de la aplicación. La versión de tipo especificada ya debe crearse en el clúster mediante New-AzServiceFabricManagedClusterApplicationTypeVersion.
Ejemplos
Ejemplo 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"}
En este ejemplo se iniciará una actualización de aplicación administrada para actualizar la versión de tipo a "v2", que se creó con New-AzServiceFabricManagedClusterApplicationTypeVersion. Los parámetros de aplicación usados deben definirse en el manifiesto de aplicación.
Ejemplo 2
$resourceGroupName = "testRG"
$clusterName = "testCluster"
$appName = "testApp"
Set-AzServiceFabricManagedClusterApplication -ResourceGroupName $resourceGroupName -ClusterName $clusterName -Name $appName -FailureAction Rollback -ForceRestart:$false -Verbose
En este ejemplo se actualiza FailureAction y se establece ForceRestart en false.
Ejemplo 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
En este ejemplo se iniciará una actualización de la aplicación para actualizar la versión de tipo a "v2" y también se establecen algunos parámetros de directiva de actualización que surtirán efecto a partir de la actualización actual.
Ejemplo 4
Set-AzServiceFabricManagedClusterApplication -ResourceGroupName $resourceGroupName -ClusterName $clusterName -Name $appName -ApplicationParameter @{key0="value0";key1=$null;key2="value2"}
En este ejemplo se actualizan los parámetros de la aplicación, pero estos cambios solo surtirán efecto hasta que la siguiente versión se actualice a la aplicación.
Parámetros
-ApplicationParameter
Especifique los parámetros de la aplicación como pares clave-valor. Estos parámetros deben existir en el manifiesto de aplicación.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApplicationTypeVersion
Especificar la versión del tipo de aplicación
Type: | String |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AsJob
Ejecute el cmdlet en segundo plano y devuelva un trabajo para realizar un seguimiento del progreso.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClusterName
Especifique el nombre del clúster.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConsiderWarningAsError
Indica si se debe tratar un evento de mantenimiento de advertencia como un evento de error durante la evaluación de estado.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultServiceTypeMaxPercentUnhealthyPartitionsPerService
Especifica el porcentaje máximo de particiones no actualizadas por servicio permitidas por la directiva de mantenimiento para el tipo de servicio predeterminado que se va a usar para la actualización supervisada.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultServiceTypeMaxPercentUnhealthyReplicasPerPartition
Especifica el porcentaje máximo de réplicas noheladas por servicio permitidas por la directiva de mantenimiento para el tipo de servicio predeterminado que se va a usar para la actualización supervisada.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultServiceTypeUnhealthyServicesMaxPercent
Especifica el porcentaje máximo de servicios no supervisados permitidos por la directiva de mantenimiento para el tipo de servicio predeterminado que se va a usar para la actualización supervisada.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FailureAction
Especifica la acción que se debe realizar si se produce un error en la actualización supervisada. Los valores aceptables para este parámetro son Rollback o Manual.
Type: | FailureAction |
Accepted values: | Rollback, Manual |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Continuar sin avisos
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceRestart
Indica que el host de servicio se reinicia aunque la actualización sea un cambio de solo configuración.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HealthCheckRetryTimeoutSec
Especifica la duración, en segundos, después de la cual Service Fabric vuelve a intentar la comprobación de estado si se produce un error en la comprobación de estado anterior.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HealthCheckStableDurationSec
Especifica la duración, en segundos, que Service Fabric espera para comprobar que la aplicación es estable antes de pasar al siguiente dominio de actualización o completar la actualización. Esta duración de espera evita cambios no detectados de mantenimiento justo después de realizar la comprobación de estado.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HealthCheckWaitDurationSec
Especifica la duración, en segundos, que Service Fabric espera antes de realizar la comprobación de estado inicial después de finalizar la actualización en el dominio de actualización.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Recurso de aplicación administrada.
Type: | PSManagedApplication |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InstanceCloseDelayDurationSec
Especifica la duración en segundos, para esperar antes de que se cierre una instancia sin estado, para permitir que las solicitudes activas se agoten correctamente.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especificar el nombre de la aplicación
Type: | String |
Aliases: | ApplicationName |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RecreateApplication
Determina si la aplicación se debe volver a crear al actualizar. Si value=true, no se permiten el resto de los parámetros de la directiva de actualización.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Especifique el nombre del grupo de recursos.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceId
ResourceId de arm de la aplicación administrada.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServiceTypeHealthPolicyMap
Especifica la asignación de la directiva de mantenimiento que se va a usar para distintos tipos de servicio como una tabla hash con el siguiente formato: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Por ejemplo: @{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tag
Especifique las etiquetas como pares clave-valor.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UnhealthyDeployedApplicationsMaxPercent
Especifica el porcentaje máximo de las instancias de aplicación implementadas en los nodos del clúster que tienen un estado de mantenimiento de error antes de que se produzca un error en el estado de mantenimiento de la aplicación para el clúster.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpgradeDomainTimeoutSec
Especifica el tiempo máximo, en segundos, que Service Fabric tarda en actualizar un único dominio de actualización. Después de este período, se produce un error en la actualización.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpgradeMode
El modo usado para supervisar el mantenimiento durante una actualización gradual. Los valores son Monitored y UnmonitoredAuto.
Type: | ApplicationUpgradeMode |
Accepted values: | Monitored, UnmonitoredAuto |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpgradeReplicaSetCheckTimeoutSec
Especifica el tiempo máximo que Service Fabric espera a que un servicio vuelva a configurarse en un estado seguro, si aún no está en un estado seguro, antes de que Service Fabric continúe con la actualización.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpgradeTimeoutSec
Especifica el tiempo máximo, en segundos, que Service Fabric tarda durante toda la actualización. Después de este período, se produce un error en la actualización.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Salidas
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de