Unregister-ServiceFabricApplicationType
Service Fabric アプリケーションの種類を登録解除します。
構文
Unregister-ServiceFabricApplicationType
[-ApplicationTypeName] <String>
[-ApplicationTypeVersion] <String>
[-Async]
[-Force]
[-TimeoutSec <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Unregister-ServiceFabricApplicationType コマンドレットは、Service Fabric アプリケーションの種類の登録を解除します。 アプリケーションの種類は、以前に Register-ServiceFabricApplicationType に登録されている必要があります。
アプリケーションの種類の登録を解除する前に、 Remove-ServiceFabricService コマンドレットを使用して、アプリケーションに基づくサービスを削除する必要があります。 Remove-ServiceFabricApplication コマンドレットを使用して、アプリケーションの種類のインスタンスを削除します。 アプリケーションの種類の登録を解除すると、アプリケーション パッケージがイメージ ストアから削除されます。
Service Fabric クラスターを管理するには、[管理者として実行] オプションを使用してWindows PowerShellを開始します。 Service Fabric クラスターで操作を実行する前に、 Connect-ServiceFabricCluster コマンドレットを使用してクラスターへの接続を確立します。
例
例 1: アプリケーションの種類の登録を解除する
PS C:\> Unregister-ServiceFabricApplicationType -ApplicationTypeName "CalcServiceApp" -ApplicationTypeVersion "1.0" -Force
このコマンドは、アプリケーションの種類 CalcServiceApp をバージョン 1.0 で登録解除します。 コマンドが成功を返すと、アプリケーションの種類は正常に登録解除されました。 このコマンドには Force パラメーターが含まれているため、コマンドレットは確認を求めるメッセージを表示しません。
例 2: アプリケーションの種類の非同期の登録を解除する
PS C:\> Unregister-ServiceFabricApplicationType -ApplicationTypeName "CalcServiceApp" -ApplicationTypeVersion "1.0" -Async
PS C:\> Get-ServiceFabricApplicationType -ApplicationTypeName "CalcServiceApp" -ApplicationTypeVersion "1.0"
Unregister-ServiceFabricApplicationType は、バージョン 1.0 でアプリケーションの種類 CalcServiceApp のプロビジョニング解除を開始します。 非同期スイッチが提供されているため、クラスターが要求を受信するとすぐにコマンドが返されます。 Get-ServiceFabricApplicationType は、指定したフィルターを使用してクラスターに登録されているアプリケーションの種類を取得します。 返されるアプリケーションの種類 (存在する場合) には、登録状態が含まれます。 このコマンドレットを使用して、プロビジョニング解除の進行状況を確認できます。 指定したバージョンのアプリケーションの種類が正常に登録解除されると、 Get-ServiceFabricApplicationType 出力には表示されません。
パラメーター
-ApplicationTypeName
Service Fabric アプリケーションの種類の名前を指定します。 コマンドレットは、指定した型の登録を解除します。
型: | String |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ApplicationTypeVersion
Service Fabric アプリケーションの種類のバージョンを指定します。 コマンドレットは、指定したバージョンを持つ型の登録を解除します。
型: | String |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Async
このコマンドは、登録解除要求がクラスターによって受け入れられるとすぐに返されます。 Get-ServiceFabricApplicationType コマンドを使用して、要求の状態を照会します。 非同期スイッチを渡すときに、大規模なアプリケーション パッケージの -TimeoutSec を増やす必要はありません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Force
ユーザーに確認せずに、直ちにコマンドを実行します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-TimeoutSec
操作のタイムアウト期間を秒単位で指定します。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
System.String
出力
System.Object