Restart-ServiceFabricNode
重新開機 Service Fabric 節點以模擬叢集節點失敗。
語法
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 資料分割,而且未指定 PartitionId 和 PartitionKey 參數,則 Cmdlet 會隨機挑選分割區。
- 如果服務是具狀態服務,而且未指定 Primary、 RandomSecondary 和 ReplicaOrInstanceId 參數,則 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 傳回,而不需要等候重新開機才能完成。
類型: | CompletionMode |
接受的值: | Invalid, DoNotVerify, Verify |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-CreateFabricDump
指出應該為指定的節點上Fabric.exe建立進程傾印。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-NodeInstanceId
指定節點實例識別碼。
除非您指定 0,否則您指定的節點實例識別碼必須符合目前執行的節點。
若要取得節點實例識別碼,請針對目標節點執行 Get-ServiceFabricNode 。
例如,針對節點 N0050,此命令 Get-ServiceFabricNode -NodeName "N0050"
會傳回包含節點實例識別碼的 Node 物件。
類型: | BigInteger |
Position: | 1 |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-NodeName
指定 Service Fabric 節點的名稱。 Cmdlet 會重新開機您指定的節點。
類型: | String |
Position: | 0 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-PartitionId
指定 Service Fabric 服務分割區的資料分割識別碼。 Cmdlet 會重新開機裝載此分割區複本或實例的節點。
類型: | Guid |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-PartitionKey
指定 Service Fabric 服務分割區的資料分割索引鍵。 Cmdlet 會識別此分割區索引鍵所對應的分割區,並重新啟動裝載該分割區之複本或實例的節點。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-PartitionKindNamed
表示 PartitionKey 參數會指定使用具名資料分割配置之服務的分割區索引鍵。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-PartitionKindSingleton
表示 ServiceName 參數中指定的服務會使用 Singleton 資料分割。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-PartitionKindUniformInt64
表示 PartitionKey 參數會指定使用 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 服務複本或實例識別碼。 Cmdlet 會重新開機裝載指定複本或實例的節點。
類型: | Int64 |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-ServiceName
指定 Service Fabric 服務的名稱。 Cmdlet 會重新開機裝載此服務複本或實例的節點。
類型: | Uri |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-TimeoutSec
指定作業的逾時期間,以秒為單位。
類型: | Int32 |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | 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