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

アプリケーション パッケージへのパスを指定します。 コマンドレットは、パス内のアプリケーション パッケージが有効であることを確認します。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationParameter

アプリケーション パラメーターのオーバーライドをディクショナリとして指定します。次に例を示 @{"key1"="value1"; "key2"="value2"}します。 アプリケーション パラメーターは、アプリケーション マニフェストで定義する必要があります。 それ以外の場合、スペルミスの可能性があるアプリケーション パラメーター名を指す検証が失敗します。

コマンドレットが New-ServiceFabricApplication または Start-ServiceFabricApplicationUpgrade 操作と同じ検証を実行できるように、アプリケーション パラメーターを渡す必要があります。 これは、アプリケーション パッケージとアプリケーション パラメーターが正しいことを確認するためのサニティ チェックとして役立ちます。 指定されていないパラメーターがアプリケーションにある場合、検証はスキップされます。

アプリケーション パラメーターの詳細を参照してください。

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

-ComposeFilePath

Service Fabric Compose のデプロイを記述する作成ファイルへのファイル パスを指定します。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ImageStoreConnectionString

Service Fabric イメージ ストアの接続文字列を指定します。 イメージ ストアの接続文字列の詳細を参照してください。

このパラメーターを指定すると、このコマンドレットは、ストアに現在デプロイされている以前のバージョンに対して追加の検証を実行します。 アプリケーションがまだ開発中であるか、クラスター情報が不明な場合を除き、イメージ ストアの接続文字列を指定することをお勧めします。

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

-PasswordEncrypted

RepositoryPasswordInvoke-ServiceFabricEncryptText によって暗号化されているかどうかを示します。

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

-RegistryPassword

{{Fill RegistryPassword Description}}

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

-RegistryUserName

{{Fill RegistryUserName Description}}

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

入力

None

出力

System.Object