Restart-ServiceFabricNode

重新開機 Service Fabric 節點以模擬叢集節點失敗。

Syntax

Restart-ServiceFabricNode
       [-NodeName] <String>
       [[-NodeInstanceId] <BigInteger>]
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -PartitionId <Guid>
       -ServiceName <Uri>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -PartitionId <Guid>
       -ServiceName <Uri>
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -PartitionId <Guid>
       -ServiceName <Uri>
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -PartitionId <Guid>
       -ServiceName <Uri>
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Description

Restart-ServiceFabricNode Cmdlet 會重新開機 Service Fabric 節點,方法是重新開機裝載節點的Fabric.exe進程。 此 Cmdlet 會模擬叢集中的 Service Fabric 節點失敗,以測試服務的容錯移轉復原路徑。 如需詳細資訊,請參閱 使用測試動作

要重新開機的 Service Fabric 節點可以透過下列方式指定:

  • 指定節點名稱,並選擇性地指定節點實例識別碼。
  • 指定具狀態服務複本或無狀態服務實例,並讓 Cmdlet 識別並重新啟動裝載它的節點。 複本/實例選取範圍的隱含行為值得注意:
    • 如果服務未使用 Singleton 資料分割,而且未指定 PartitionIdPartitionKey 參數,則 Cmdlet 會隨機挑選分割區。
    • 如果服務是具狀態服務,而且未指定 PrimaryRandomSecondaryReplicaOrInstanceId 參數,則 Cmdlet 會隨機挑選複本,而不論其角色為何。
    • 如果服務是無狀態服務,且未指定 ReplicaOrInstanceId 參數,則 Cmdlet 會隨機挑選實例。

如果您為 NodeInstanceId 參數指定非零值,該識別碼會與使用中的節點識別碼進行比較。 如果識別碼不相符,進程不會重新開機,而且會發生錯誤。 過時的訊息可能會導致此錯誤。

如果您指定 CreateFabricDump 參數,此 Cmdlet 會導致Fabric.exe程式在重新開機期間損毀于指定的節點上。 此損毀會建立Fabric.exe的進程傾印。

在 Service Fabric 叢集上執行任何作業之前,請使用 Connect-ServiceFabricCluster Cmdlet 建立叢集的連線。

範例

範例 1:重新開機裝載主要複本的節點

PS C:\> Restart-ServiceFabricNode -ReplicaKindPrimary -PartitionKindNamed -PartitionKey "Partition3" -CommandCompletionMode Verify

此命令會重新開機裝載名為 Partition3 之分割區主要複本的節點。 因為 CommandCompletionMode 參數是以 Verify 值指定,所以命令會在完成之前等候目標節點重新開機。

範例 2:重新開機指定的節點

PS C:\> Restart-ServiceFabricNode -NodeName "Node01" -CommandCompletionMode DoNotVerify

此命令會重新開機名為 Node01 的節點。 因為 CommandCompletionMode 參數是以 DoNotVerify 值指定,所以命令不會等待節點重新開機,然後再完成。

參數

-CommandCompletionMode

指定動作是否等候重新開機完成。 指定 [確認 ] 讓 Cmdlet 等候重新開機完成, 而 DoNotVerify 會讓 Cmdlet 傳回,而不需要等候重新開機才能完成。

Type:CompletionMode
Accepted values:Invalid, DoNotVerify, Verify
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CreateFabricDump

指出應該為指定的節點上Fabric.exe建立進程傾印。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NodeInstanceId

指定節點實例識別碼。 除非您指定 0,否則您指定的節點實例識別碼必須符合目前執行的節點。 若要取得節點實例識別碼,請針對目標節點執行 Get-ServiceFabricNode 。 例如,針對節點 N0050,此命令 Get-ServiceFabricNode -NodeName "N0050" 會傳回包含節點實例識別碼的 Node 物件。

Type:BigInteger
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-NodeName

指定 Service Fabric 節點的名稱。 Cmdlet 會重新開機您指定的節點。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PartitionId

指定 Service Fabric 服務分割區的資料分割識別碼。 Cmdlet 會重新開機裝載此分割區複本或實例的節點。

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PartitionKey

指定 Service Fabric 服務分割區的資料分割索引鍵。 Cmdlet 會識別此分割區索引鍵所對應的分割區,並重新啟動裝載該分割區之複本或實例的節點。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PartitionKindNamed

表示 PartitionKey 參數會指定使用具名資料分割配置之服務的分割區索引鍵。

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PartitionKindSingleton

表示 ServiceName 參數中指定的服務會使用 Singleton 資料分割。

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PartitionKindUniformInt64

表示 PartitionKey 參數會指定使用 UniformInt64 資料分割配置之服務的分割區索引鍵。

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ReplicaKindPrimary

指出這個 Cmdlet 會重新開機裝載指定資料分割之主要複本的節點。

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ReplicaKindRandomSecondary

指出這個 Cmdlet 會重新開機裝載指定分割區隨機次要複本的節點。

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ReplicaOrInstanceId

指定 Service Fabric 服務複本或實例識別碼。 Cmdlet 會重新開機裝載指定複本或實例的節點。

Type:Int64
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ServiceName

指定 Service Fabric 服務的名稱。 Cmdlet 會重新開機裝載此服務複本或實例的節點。

Type:Uri
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TimeoutSec

指定作業的逾時期間,以秒為單位。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

System.String

System.Nullable`1[[System.Numerics.BigInteger, System.Numerics, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

System.Guid

System.Uri

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

輸出

System.Object