通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Set-AzServiceFabricManagedClusterApplication

  • 参考
模块:
Az.ServiceFabric

更新 Service Fabric 托管应用程序。 这允许更新应用程序参数和/或升级将触发应用程序升级或其他仅配置更新的应用程序类型版本。 仅支持 ARM 部署的应用程序。

语法

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>]

说明

此 cmdlet 可用于更新应用程序参数和升级应用程序类型版本以及其他仅配置更新。 更新参数只会更改 ARM 端的模型，仅当使用新类型版本时，该命令才会触发应用程序升级。 应已在群集中使用 New-AzServiceFabricManagedClusterApplicationTypeVersion创建指定的类型版本。

示例

示例 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"}

此示例将启动托管应用程序升级，将类型版本更新为“v2”，该版本是使用 new-AzServiceFabricManagedClusterApplicationTypeVersion创建的。 应在应用程序清单中定义所使用的应用程序参数。

示例 2

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

此示例将 FailureAction 更新并将 ForceRestart 设置为 false。

示例 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

此示例将启动应用程序升级，将类型版本更新为“v2”，并设置一些将从当前升级生效的升级策略参数。

示例 4

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

此示例更新应用程序参数，但这些更改只会生效，直到下一个版本升级到应用程序。

参数

-ApplicationParameter

将应用程序参数指定为键/值对。 这些参数必须存在于应用程序清单中。

类型:Hashtable
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ApplicationTypeVersion

指定应用程序类型版本

类型:String
Position:3
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-AsJob

在后台运行 cmdlet 并返回作业以跟踪进度。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ClusterName

指定群集的名称。

类型:String
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ConsiderWarningAsError

指示在运行状况评估期间是否将警告运行状况事件视为错误事件。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:IAzureContextContainer
别名:AzContext, AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DefaultServiceTypeMaxPercentUnhealthyPartitionsPerService

指定默认服务类型用于监视升级的默认服务类型的运行状况策略允许的每个服务的最大未保留分区百分比。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DefaultServiceTypeMaxPercentUnhealthyReplicasPerPartition

指定默认服务类型用于监视升级的默认服务类型的运行状况策略允许的每个服务的最大未保留副本百分比。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DefaultServiceTypeUnhealthyServicesMaxPercent

指定运行状况策略允许的默认服务类型用于监视升级的最大未维护服务百分比。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-FailureAction

指定监视升级失败时要执行的操作。 此参数的可接受值为 Rollback 或 Manual。

类型:FailureAction
接受的值:Rollback, Manual
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Force

在没有提示的情况下继续

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ForceRestart

指示即使升级是仅配置更改，服务主机也会重启。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-HealthCheckRetryTimeoutSec

指定持续时间（以秒为单位），之后，Service Fabric 会重试运行状况检查（如果上一个运行状况检查失败）。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-HealthCheckStableDurationSec

指定 Service Fabric 等待的持续时间（以秒为单位）以验证应用程序在移动到下一个升级域或完成升级之前是否稳定。 执行运行状况检查后，此等待持续时间可防止未检测到的运行状况更改。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-HealthCheckWaitDurationSec

指定 Service Fabric 在升级域完成升级后执行初始运行状况检查之前等待的持续时间（以秒为单位）。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-InputObject

托管应用程序资源。

类型:PSManagedApplication
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-InstanceCloseDelayDurationSec

指定在关闭无状态实例之前等待的持续时间（以秒为单位）以允许活动请求正常清空。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Name

指定应用程序的名称

类型:String
别名:ApplicationName
Position:2
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-RecreateApplication

确定是否应在更新时重新创建应用程序。 如果 value=true，则不允许使用升级策略参数的其余部分。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ResourceGroupName

指定资源组的名称。

类型:String
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-ResourceId

托管应用程序的 Arm ResourceId。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-ServiceTypeHealthPolicyMap

指定用于不同服务类型的运行状况策略的映射，格式如下：@ {“ServiceTypeName” ： “MaxPercentUnhealthyPartitionsPerService，MaxPercentUnhealthyReplicasPerPartition，MaxPercentUnhealthyServices”}。 例如：@{ “ServiceTypeName01” = “5,10,5”;“ServiceTypeName02” = “5,5,5” }

类型:Hashtable
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Tag

将标记指定为键/值对。

类型:Hashtable
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-UnhealthyDeployedApplicationsMaxPercent

指定在群集中的节点上部署的应用程序实例的最大百分比，这些实例在群集的应用程序运行状况状态出错之前处于运行状况状态。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-UpgradeDomainTimeoutSec

指定 Service Fabric 升级单个升级域所需的时间（以秒为单位）。 在此时间段后，升级失败。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-UpgradeMode

用于在滚动升级期间监视运行状况的模式。 值为 Monitored 和 UnmonitoredAuto。

类型:ApplicationUpgradeMode
接受的值:Monitored, UnmonitoredAuto
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-UpgradeReplicaSetCheckTimeoutSec

指定在 Service Fabric 继续升级之前，Service Fabric 等待服务重新配置为安全状态（如果尚未处于安全状态）的最长时间。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-UpgradeTimeoutSec

指定 Service Fabric 在整个升级中花费的最大时间（以秒为单位）。 在此时间段后，升级失败。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

String

Hashtable

PSManagedApplication

输出

PSManagedApplication