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

Restart-ServiceFabricDeployedCodePackage

重启在群集中的节点上部署的代码包,以模拟进程失败。

语法

Restart-ServiceFabricDeployedCodePackage
       [-NodeName] <String>
       [-ApplicationName] <Uri>
       [-ServiceManifestName] <String>
       [-CodePackageName] <String>
       [[-CodePackageInstanceId] <Int64>]
       [-ServicePackageActivationId <String>]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -PartitionId <Guid>
       -ServiceName <Uri>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -PartitionId <Guid>
       -ServiceName <Uri>
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -PartitionId <Guid>
       -ServiceName <Uri>
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -PartitionId <Guid>
       -ServiceName <Uri>
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

说明

Restart-ServiceFabricDeployedCodePackage cmdlet 结束代码包进程,这将重启该进程中托管的所有用户服务副本。 此重启模拟群集中的代码包进程失败,这会测试服务的故障转移恢复路径。

可以指定代码包,也可以指定 ReplicaSelector 以重启托管副本的节点和代码包组合。 这简化了主主机节点上的测试,无需在重启该节点之前确定哪个 Service Fabric 节点是主节点。

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

示例

示例 1:重启随机次要副本的代码包

PS C:\> Restart-ServiceFabricDeployedCodePackage -ReplicaKindRandomSecondary -PartitionKindSingleton -ServiceName fabric:/SampleApp/SampleService -ApplicationName fabric:/SampleApp -CommandCompletionMode Verify

此命令在单一实例分区上为随机次要副本重启代码包。

示例 2:重启指定的代码包

PS C:\> Restart-ServiceFabricDeployedCodePackage -NodeName "Node01" -ApplicationName fabric:/App -CodePackageName "CodePackage01" -ServiceManifestName "ServiceManifest01" -CommandCompletionMode Verify

此命令从名为 Node01 的服务清单 ServiceManifest01 重新启动名为 CodePackage01 的代码包。

参数

-ApplicationName

指定代码包所属的应用程序的名称。

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

-CodePackageInstanceId

指定在重启之前针对已部署的代码包检查的代码包的实例 ID。 如果指定 0,则不执行任何比较。

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

-CodePackageName

指定要重启的代码包的名称。

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

-CommandCompletionMode

指定操作是否等待重启完成。

类型:CompletionMode
接受的值:Invalid, DoNotVerify, Verify
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-NodeName

指定 Service Fabric 节点的名称。 该 cmdlet 将重启指定的节点。

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

-PartitionId

指定重新启动代码包的分区的 ID。

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

-PartitionKey

指定重新启动代码包的分区的键。

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

-PartitionKindNamed

指示此 cmdlet 在命名分区上重启代码包。

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

-PartitionKindSingleton

指示此 cmdlet 在单一实例分区上重启代码包。

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

-PartitionKindUniformInt64

指示此 cmdlet 在 UniformInt64 分区上重启代码包。

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

-ReplicaKindPrimary

指示此 cmdlet 重新启动主副本的代码包。

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

-ReplicaKindRandomSecondary

指示此 cmdlet 重新启动随机次要副本的代码包。

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

-ReplicaOrInstanceId

指定 Service Fabric 服务副本或实例 ID。

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

-ServiceManifestName

指定在其中定义代码包的服务清单的名称。

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

-ServiceName

指定代码包所属的服务的名称。

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

-ServicePackageActivationId

已部署的 servicePackage 的激活 ID,其中包含 CodePackage。 这可以通过使用查询 Get-ServiceFabricDeployedCodePackage获取。

如果在创建服务 时指定 ServicePackageActivationMode SharedProcess(或者如果未指定,在这种情况下默认为 SharedProcess),则 servicePackageActivationId 的值始终为空字符串,无需指定。 若要了解有关服务包激活 ID 的详细信息,请参阅 [Service Fabric 托管模型][1]。

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

-TimeoutSec

指定操作的超时期限(以秒为单位)。

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

输入

System.String

System.Uri

System.Nullable`1[[System.Int64, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

System.Guid

输出

System.Object