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

Start-ServiceFabricComposeDeploymentUpgrade

参考

模块:: ServiceFabric

预览。使用新的撰写文件升级 Service Fabric 撰写部署。

语法

Start-ServiceFabricComposeDeploymentUpgrade
     [-DeploymentName] <String>
     [-Compose] <String>
     [[-RegistryUserName] <String>]
     [[-RegistryPassword] <String>]
     [-PasswordEncrypted]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [-UnmonitoredAuto]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-ServiceFabricComposeDeploymentUpgrade
     [-DeploymentName] <String>
     [-Compose] <String>
     [[-RegistryUserName] <String>]
     [[-RegistryPassword] <String>]
     [-PasswordEncrypted]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [-UnmonitoredManual]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-ServiceFabricComposeDeploymentUpgrade
     [-DeploymentName] <String>
     [-Compose] <String>
     [[-RegistryUserName] <String>]
     [[-RegistryPassword] <String>]
     [-PasswordEncrypted]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [-Monitored]
     -FailureAction <UpgradeFailureAction>
     [-HealthCheckRetryTimeoutSec <UInt32>]
     [-HealthCheckWaitDurationSec <UInt32>]
     [-HealthCheckStableDurationSec <UInt32>]
     [-UpgradeDomainTimeoutSec <UInt32>]
     [-UpgradeTimeoutSec <UInt32>]
     [-ConsiderWarningAsError <Boolean>]
     [-DefaultServiceTypeHealthPolicy <String>]
     [-MaxPercentUnhealthyDeployedApplications <Byte>]
     [-ServiceTypeHealthPolicyMap <Hashtable>]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

说明

此 cmdlet 以预览版提供，在下一个版本中可能会更改。没有兼容性保证。

Start-ServiceFabricComposeDeploymentUpgrade cmdlet 升级 Service Fabric compose 部署。此 cmdlet 在群集上启动升级。

在 Service Fabric 群集上执行任何操作之前，请使用 Connect-ServiceFabricCluster cmdlet 建立与群集的连接。

有关 Service Fabric 撰写部署的指导，请参阅：Service Fabric 中的 Compose 部署

示例

示例 1：升级撰写部署

PS C:\> Start-ServiceFabricComposeDeploymentUpgrade -DeploymentName mydeployment -Compose docker-compose.yml -Monitored -FailureAction Rollback

该命令在撰写文件docker-compose.yml中名为 mydeployment 的撰写部署上执行受监视的自动升级。如果受监视的升级失败，升级将回滚。无需事先注册应用程序类型。

参数

-Compose

指定目标撰写文件的文件路径，该文件描述 Service Fabric 撰写部署。

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

-Confirm

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

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

-ConsiderWarningAsError

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

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

-DefaultServiceTypeHealthPolicy

指定默认服务类型的运行状况策略，以 MaxPercentUnhealthyPartitionsPerService、MaxPercentUnhealthyReplicasPerPartition、MaxPercentUnhealthyServices 格式用于监视的升级。例如，5,10,15 指示以下值：

MaxPercentUnhealthyPartitionsPerService = 5
MaxPercentUnhealthyReplicasPerPartition = 10
MaxPercentUnhealthyServices = 15

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

-DeploymentName

指定撰写部署的名称。该 cmdlet 使用此名称升级撰写部署。

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

-FailureAction

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

反转
手动

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

-Force

指示此 cmdlet 跳过警告消息并强制升级。

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

-ForceRestart

指示即使新撰写文件中的服务说明未更改，也应重新创建撰写文件中的所有容器。

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

-HealthCheckRetryTimeoutSec

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

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

-HealthCheckStableDurationSec

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

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

-HealthCheckWaitDurationSec

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

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

-MaxPercentUnhealthyDeployedApplications

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

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

-Monitored

指示监视升级模式。 cmdlet 完成升级域的升级后，如果升级域的运行状况和群集满足定义的运行状况策略，Service Fabric 将升级下一个升级域。如果升级域或群集无法满足运行状况策略，升级失败，Service Fabric 会回滚升级域的升级，或者根据指定的策略恢复为手动模式。这是在生产环境中撰写部署升级的建议模式。

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

-PasswordEncrypted

指示 Invoke-ServiceFabricEncryptText是否加密了 RegistryPassword。

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

-RegistryPassword

指示容器注册表的密码。如果提供了此分析器，则需要 RegistryUserName 一起提供。

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

-RegistryUserName

指示容器注册表的用户名。如果提供了此分析器，则需要 RegistryPassword 一起提供。

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

-ServiceTypeHealthPolicyMap

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

@{ “ServiceTypeName01” = “5,10,5”;“ServiceTypeName02” = “5,5,5” }

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

-TimeoutSec

指定操作的超时期限（以秒为单位）。

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

-UnmonitoredAuto

指示升级模式为未受监视的自动模式。 Service Fabric 升级升级域后，Service Fabric 会升级下一个升级域，而不考虑应用程序运行状况。不建议将此模式用于生产，并且仅在开发撰写部署期间有用。

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

-UnmonitoredManual

指示升级模式未受监视手动。 Service Fabric 升级升级域后，它会等待你使用 Resume-ServiceFabricApplicationUpgrade cmdlet 升级下一个升级域。

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

-UpgradeDomainTimeoutSec

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

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

-UpgradeReplicaSetCheckTimeoutSec

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

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

-UpgradeTimeoutSec

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

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

-WhatIf

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

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

输入

None

输出

System.Object

通过

Start-ServiceFabricComposeDeploymentUpgrade

语法

说明

示例

示例 1：升级撰写部署

参数

-Compose

-Confirm

-ConsiderWarningAsError

-DefaultServiceTypeHealthPolicy

-DeploymentName

-FailureAction

-Force

-ForceRestart

-HealthCheckRetryTimeoutSec

-HealthCheckStableDurationSec

-HealthCheckWaitDurationSec

-MaxPercentUnhealthyDeployedApplications

-Monitored

-PasswordEncrypted

-RegistryPassword

-RegistryUserName

-ServiceTypeHealthPolicyMap

-TimeoutSec

-UnmonitoredAuto

-UnmonitoredManual

-UpgradeDomainTimeoutSec

-UpgradeReplicaSetCheckTimeoutSec

-UpgradeTimeoutSec

-WhatIf

输入

输出

其他资源

通过

Start-ServiceFabricComposeDeploymentUpgrade

语法

说明

示例

示例 1：升级撰写部署

参数

-Compose

-Confirm

-ConsiderWarningAsError

-DefaultServiceTypeHealthPolicy

-DeploymentName

-FailureAction

-Force

-ForceRestart

-HealthCheckRetryTimeoutSec

-HealthCheckStableDurationSec

-HealthCheckWaitDurationSec

-MaxPercentUnhealthyDeployedApplications

-Monitored

-PasswordEncrypted

-RegistryPassword

-RegistryUserName

-ServiceTypeHealthPolicyMap

-TimeoutSec

-UnmonitoredAuto

-UnmonitoredManual

-UpgradeDomainTimeoutSec

-UpgradeReplicaSetCheckTimeoutSec

-UpgradeTimeoutSec

-WhatIf

输入

输出

相关链接

其他资源