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

コマンドレットの実行前に確認を求めるメッセージが表示されます。

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

-Force

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

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

-ForceRemove

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

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

-ServiceName

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

Type:	Uri
Position:	0
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

-WhatIf

コマンドレットの実行時に発生する内容を示します。コマンドレットは実行されず、永続的な変更は行われません。

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

入力

System.Uri

出力

System.Object