Remove-ServiceFabricService
既存の Service Fabric サービスを削除します。
構文
Default (既定)
Remove-ServiceFabricService
[-ServiceName] <Uri>
[-Force]
[-ForceRemove]
[-TimeoutSec <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Remove-ServiceFabricService コマンドレットは、既存の Service Fabric サービスを削除します。 サービスを削除する前に、サービスが実行されている必要があります。
Service Fabric クラスターで操作を実行する前に、Connect-ServiceFabricCluster コマンドレットを使用してクラスターへの接続を確立します。
例
例 1: Service Fabric を削除する
PS C:\> Remove-ServiceFabricService -ServiceName fabric:/myapp/persistenttodolist/svc1 -Force
このコマンドは、指定された Service Fabric サービスを削除します。 コマンドには Force パラメーターが含まれているため、確認を求めるメッセージは表示されません。
例 2: 確認を使用して Service Fabric サービスを ForceRemove する
PS C:\> Remove-ServiceFabricService -ServiceName fabric:/myapp/persistenttodolist/svc1 -Confirm -ForceRemove
このコマンドは、指定された Service Fabric サービスを強制的に削除します。
コマンドには Confirm パラメーターが含まれているため、操作を実行する目的のサービス名であるかどうかを確認するように求められます。 確認後、ForceRemove パラメーターが
例 3: タイムアウトを使用して Service Fabric サービスを ForceRemove する
PS C:\> Remove-ServiceFabricService -ServiceName fabric:/myapp/persistenttodolist/svc1 -TimeoutSec 10 -ForceRemove
このコマンドは、指定された Service Fabric サービスを強制的に削除します。 コマンドには Timeout パラメーターが含まれているため、指定した時間内に操作を完了できない場合、操作はタイムアウトします。
パラメーター
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Force
ユーザーの確認を求めずにコマンドを強制的に実行します。 PowerShell では、コマンドを実行するためのユーザーの確認は求められません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ForceRemove
このコマンドによって Service Fabric サービスが強制的に削除されることを示します。 これは、サービスの削除がタイムアウトしている場合にのみ使用する必要があります。たとえば、Remove-ServiceFabricService がタイムアウトし、サービスのレプリカがまだ存在する場合は、サービスが ChangeRole/Close で停止し、シャットダウン シーケンスを完了できないことを意味します。
ForceRemoveを使用することで、サービスのシャットダウン シーケンスをスキップし、サービスが正常に削除されます。 ステートフル サービスの場合、その永続的な状態は消去されません。 レプリカが存在するかどうかを確認するには、Get-ServiceFabricReplica
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ServiceName
Service Fabric サービスの URI (Uniform Resource Identifier) を指定します。
パラメーターのプロパティ
| 型: | Uri |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-TimeoutSec
操作のタイムアウト期間を秒単位で指定します。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されず、永続的な変更は行われません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。