Test-ServiceFabricApplicationPackage
Service Fabric アプリケーション パッケージを検証します。
構文
Test-ServiceFabricApplicationPackage
[-ApplicationPackagePath] <String>
[-ApplicationParameter <Hashtable>]
[-ImageStoreConnectionString <String>]
[<CommonParameters>]
Test-ServiceFabricApplicationPackage
[-ComposeFilePath] <String>
[-RegistryUserName <String>]
[-RegistryPassword <String>]
[-PasswordEncrypted]
[-ImageStoreConnectionString <String>]
[<CommonParameters>]
説明
Test-ServiceFabricApplicationPackage コマンドレットは、Service Fabric アプリケーション パッケージを検証して、Service Fabric パッケージの要件を満たしていることを確認します。 Service Fabric アプリケーション モデルの詳細を参照してください。
イメージ ストアの接続文字列を指定すると、クラスターにプロビジョニングされている以前のバージョンのアプリケーションに対してもパッケージが検証されます。 たとえば、コマンドレットは、同じバージョンの異なるコンテンツを持つアプリケーション パッケージがイメージ ストアに既にプロビジョニングされていることを検出できます。
パッケージを検証したら、 Copy-ServiceFabricApplicationPackage コマンドレットを使用してイメージ ストアにコピーします。
Service Fabric クラスターで操作を実行する前に、 Connect-ServiceFabricCluster コマンドレットを使用してクラスターへの接続を確立します。
例
例 1: イメージ ストアにアクセスせずにアプリケーション パッケージをローカルで検証する
PS C:\> Test-ServiceFabricApplicationPackage -ApplicationPackagePath "C:\CalculatorApp" -ApplicationParameter @{ "StatelessServiceInstanceCount"="-1"}
このコマンドは、指定したパスにあるアプリケーション パッケージを検証します。 これには、検証するアプリケーション パラメーターが含まれます。 アプリケーションがまだ開発フェーズにあるか、クラスター接続がまだ不明であるため、コマンドレットではイメージ ストア接続文字列が指定されません。
例 2: イメージ ストア内の以前のバージョンに対してローカルでアプリケーション パッケージを検証する
PS C:\> Test-ServiceFabricApplicationPackage -ApplicationPackagePath "C:\CalculatorApp" -ImageStoreConnectionString "file:C:\SfDevCluster\Data\ImageStoreShare"
このコマンドは、指定したパスにあるアプリケーション パッケージを検証します。 イメージ ストアに既に存在するアプリケーション バージョンに対するより多くの検証を行うイメージ ストア接続文字列を提供します。
パラメーター
-ApplicationPackagePath
アプリケーション パッケージへのパスを指定します。 コマンドレットは、パス内のアプリケーション パッケージが有効であることを確認します。
型: | String |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ApplicationParameter
アプリケーション パラメーターのオーバーライドをディクショナリとして指定します。次に例を示 @{"key1"="value1"; "key2"="value2"}
します。 アプリケーション パラメーターは、アプリケーション マニフェストで定義する必要があります。 それ以外の場合、スペルミスの可能性があるアプリケーション パラメーター名を指す検証が失敗します。
コマンドレットが New-ServiceFabricApplication または Start-ServiceFabricApplicationUpgrade 操作と同じ検証を実行できるように、アプリケーション パラメーターを渡す必要があります。 これは、アプリケーション パッケージとアプリケーション パラメーターが正しいことを確認するためのサニティ チェックとして役立ちます。 指定されていないパラメーターがアプリケーションにある場合、検証はスキップされます。
アプリケーション パラメーターの詳細を参照してください。
型: | Hashtable |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ComposeFilePath
Service Fabric Compose のデプロイを記述する作成ファイルへのファイル パスを指定します。
型: | String |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ImageStoreConnectionString
Service Fabric イメージ ストアの接続文字列を指定します。 イメージ ストアの接続文字列の詳細を参照してください。
このパラメーターを指定すると、このコマンドレットは、ストアに現在デプロイされている以前のバージョンに対して追加の検証を実行します。 アプリケーションがまだ開発中であるか、クラスター情報が不明な場合を除き、イメージ ストアの接続文字列を指定することをお勧めします。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PasswordEncrypted
RepositoryPassword が Invoke-ServiceFabricEncryptText によって暗号化されているかどうかを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RegistryPassword
{{Fill RegistryPassword Description}}
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RegistryUserName
{{Fill RegistryUserName Description}}
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
None
出力
System.Object