Copy-ServiceFabricApplicationPackage

リファレンス

モジュール:: ServiceFabric

Service Fabric アプリケーションパッケージをイメージストアにコピーします。

構文

Copy-ServiceFabricApplicationPackage
    [-ApplicationPackagePath] <String>
    [[-ImageStoreConnectionString] <String>]
    [[-ApplicationPackagePathInImageStore] <String>]
    [-ApplicationPackageCopyPath <String>]
    [-ShowProgress]
    [-ShowProgressIntervalMilliseconds <Int32>]
    [-CompressPackage]
    [-UncompressPackage]
    [-SkipCopy]
    [-GenerateChecksums]
    [-CertStoreLocation <StoreLocation>]
    [-TimeoutSec <Int32>]
    [<CommonParameters>]

説明

Copy-ServiceFabricApplicationPackage コマンドレットは、Service Fabric アプリケーションパッケージをイメージストアにコピーします。このコマンドレットは、Service Fabric アプリケーションパッケージを実際にイメージストアにコピーせずに圧縮および圧縮解除するためにも使用できます。

アプリケーションパッケージをコピーした後、 Register-ServiceFabricApplicationType コマンドレットを使用してアプリケーションの種類を登録します。

アプリケーションパッケージを登録した後、 Remove-ServiceFabricApplicationPackage コマンドレットを使用してアプリケーションパッケージを削除します。

Service Fabric クラスターを管理するには、[管理者として実行] オプションを使用してWindows PowerShellを開始します。 Service Fabric クラスターで操作を実行する前に、 Connect-ServiceFabricCluster コマンドレットを使用してクラスターへの接続を確立します。

例

例 1: アプリケーションパッケージをコピーする

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "C:\ApplicationPackages\PersistentToDoListService" -ImageStoreConnectionString "fabric:ImageStore"

このコマンドは、アプリケーションパッケージをクラスターのイメージストアにコピーします。 ApplicationPackagePathInImageStore パラメーターが指定されていない場合、既定ではフォルダー名が使用されます。この例では、 ApplicationPackagePathInImageStore は既定で PersistentToDoListService になります

例 2: イメージストア内の特定のディレクトリにアプリケーションパッケージをコピーする

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "C:\ApplicationPackages\PersistentToDoListService" -ImageStoreConnectionString "fabric:ImageStore" -ApplicationPackagePathInImageStore "PersistentToDoListService_v2"

このコマンドは、クラスターのイメージストアPersistentToDoListService_v2ディレクトリにアプリケーションパッケージをコピーします。

例 3: 圧縮されたアプリケーションパッケージをイメージストア内の特定のディレクトリにコピーする

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "C:\ApplicationPackages\PersistentToDoListService" -ImageStoreConnectionString "fabric:ImageStore" -ApplicationPackagePathInImageStore "PersistentToDoListService_v2" -CompressPackage

このコマンドは、サービスディレクトリの下にあるすべてのサブディレクトリを圧縮し、アプリケーションパッケージをクラスターのイメージストアPersistentToDoListService_v2ディレクトリにコピーします。

例 4: PowerShell ウィンドウでコピー操作の進行状況バーを表示する

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "C:\ApplicationPackages\PersistentToDoListService" -ImageStoreConnectionString "fabric:ImageStore" -ApplicationPackagePathInImageStore "PersistentToDoListService_v2" -ShowProgress -ShowProgressIntervalMilliseconds 500

このコマンドは、クラスターのイメージストア内のディレクトリにアプリケーションパッケージをコピーするときに、PowerShell ウィンドウに進行状況バー PersistentToDoListService_v2表示します。進行状況バーは 500 ミリ秒ごとに更新されます。

例 5: イメージストアにコピーせずにローカルコンピューター上のアプリケーションパッケージを圧縮する

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "C:\ApplicationPackages\PersistentToDoListService" -CompressPackage -SkipCopy

このコマンドは、アプリケーションパッケージを実際にクラスターのイメージストアにコピーすることなく、サービスディレクトリの下にあるすべてのサブディレクトリを圧縮します。

例 6: イメージストアにコピーせずにローカルコンピューター上のアプリケーションパッケージを圧縮解除する

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "C:\ApplicationPackages\PersistentToDoListService" -UncompressPackage -SkipCopy

このコマンドは、アプリケーションパッケージを実際にクラスターのイメージストアにコピーせずに、サービスディレクトリの下にあるすべてのサブディレクトリを圧縮解除します。

パラメーター

-ApplicationPackageCopyPath

アップロードするアプリケーションパッケージのローカルコピーを作成する宛先を指定します。 GenerateChecksums スイッチと CompressPackage スイッチが適用される前にローカルコピーが作成されるため、このスイッチは、元のソースパッケージの場所が読み取り専用の場合に便利です。

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

-ApplicationPackagePath

アプリケーションパッケージの相対パスを指定します。コマンドレットは、指定したパスからパッケージをコピーします。

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

-ApplicationPackagePathInImageStore

アプリケーションパッケージをコピーするイメージストア内の相対パスを指定します。

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

-CertStoreLocation

GenerateChecksums スイッチを使用してアプリケーションパッケージチェックサムを計算するときに使用する証明書ストアの場所を指定します。

Type:	StoreLocation
Accepted values:	CurrentUser, LocalMachine
Position:	Named
Default value:	LocalMachine
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CompressPackage

アプリケーションパッケージのルートディレクトリ (コード/構成/データパッケージ) の下にあるすべてのサブディレクトリを圧縮します。 SkipCopy が指定されていない場合、アプリケーションパッケージをイメージストアにコピーする前にフォルダーが圧縮されます。 ApplicationPackageCopyPath が指定されている場合、圧縮は元のソースディレクトリではなく、そのディレクトリで行われます。

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

-GenerateChecksums

アップロードする前に、アプリケーションパッケージのチェックサムファイルを事前に生成します。これにより、 Register-ServiceFabricApplicationType 中にクラスターによって計算される必要がないように、アプリケーションパッケージチェックサムの計算コストがフロントロードされます。

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

-ImageStoreConnectionString

Service Fabric イメージストアの接続文字列を指定します。イメージストアの接続文字列の詳細を参照してください。 Connect-ServiceFabricCluster が正常に実行された場合、このパラメーターは必要ありません。

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

-ShowProgress

アプリケーションパッケージをイメージストアにコピーするときに、PowerShell ウィンドウに進行状況バーを表示するように指定します。

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

-ShowProgressIntervalMilliseconds

アプリケーションパッケージをイメージストアにコピーするときに PowerShell ウィンドウで進行状況バーが更新される頻度を指定します。

Type:	Int32
Position:	Named
Default value:	2000
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipCopy

アプリケーションパッケージのアップロードは実行しません。これは、アプリケーションパッケージをイメージストアにコピーせずに、アプリケーションパッケージを圧縮または圧縮解除する必要がある場合に使用する必要があります。

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

-TimeoutSec

操作のタイムアウトを秒単位で指定します。既定では、最大タイムアウト値は 1800 秒に制限されています。

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

-UncompressPackage

アプリケーションパッケージのルートディレクトリ (コード/構成/データパッケージ) の下にあるすべての圧縮ファイルを圧縮解除します。これは 、SkipCopy パラメーターと共に使用して、アプリケーションパッケージをイメージストアに実際にコピーせずに、アプリケーションパッケージをローカルで圧縮解除するために使用できます。 ApplicationPackageCopyPath が指定されている場合、元のソースディレクトリではなく、そのディレクトリで圧縮解除が行われます。

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

入力

None

出力

System.Object