次の方法で共有

Remove-ServiceFabricService

  • リファレンス
モジュール:
ServiceFabric

既存の Service Fabric サービスを削除します。

構文

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
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Force

ユーザーの確認を求めずにコマンドを強制的に実行します。 PowerShell では、コマンドを実行するためのユーザーの確認は求められません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceRemove

このコマンドによって Service Fabric サービスが強制的に削除されることを示します。 これは、サービスの削除がタイムアウトしている場合にのみ使用する必要があります。たとえば、Remove-ServiceFabricService がタイムアウトし、サービスのレプリカがまだ存在する場合は、サービスが ChangeRole/Close で停止し、シャットダウン シーケンスを完了できないことを意味します。 ForceRemoveを使用することで、サービスのシャットダウン シーケンスをスキップし、サービスが正常に削除されます。 ステートフル サービスの場合、その永続的な状態は消去されません。 レプリカが存在するかどうかを確認するには、Get-ServiceFabricReplica使用します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ServiceName

Service Fabric サービスの URI (Uniform Resource Identifier) を指定します。

型:Uri
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-TimeoutSec

操作のタイムアウト期間を秒単位で指定します。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されず、永続的な変更は行われません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

System.Uri

出力

System.Object