Start-ServiceFabricApplicationUpgrade

Modul:

ServiceFabric

Meningkatkan aplikasi Service Fabric ke ApplicationTypeVersion tertentu.

Sintaks

Start-ServiceFabricApplicationUpgrade
     [-ApplicationName] <Uri>
     [-ApplicationTypeVersion] <String>
     [[-ApplicationParameter] <Hashtable>]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredAuto]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-ServiceFabricApplicationUpgrade
     [-ApplicationName] <Uri>
     [-ApplicationTypeVersion] <String>
     [[-ApplicationParameter] <Hashtable>]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredManual]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-ServiceFabricApplicationUpgrade
     [-ApplicationName] <Uri>
     [-ApplicationTypeVersion] <String>
     [[-ApplicationParameter] <Hashtable>]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-Monitored]
     -FailureAction <UpgradeFailureAction>
     [-HealthCheckRetryTimeoutSec <UInt32>]
     [-HealthCheckWaitDurationSec <UInt32>]
     [-HealthCheckStableDurationSec <UInt32>]
     [-UpgradeDomainTimeoutSec <UInt32>]
     [-UpgradeTimeoutSec <UInt32>]
     [-ConsiderWarningAsError <Boolean>]
     [-DefaultServiceTypeHealthPolicy <String>]
     [-MaxPercentUnhealthyDeployedApplications <Byte>]
     [-ServiceTypeHealthPolicyMap <Hashtable>]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Deskripsi

Cmdlet Start-ServiceFabricApplicationUpgrade meningkatkan aplikasi Service Fabric. Sebelum menggunakan cmdlet ini, Anda perlu menyalin paket aplikasi yang diperbarui ke penyimpanan gambar dan mendaftarkan jenis aplikasi yang diperbarui. Gunakan Copy-ServiceFabricApplicationPackage untuk menyalin paket aplikasi ke penyimpanan gambar. Gunakan cmdlet Register-ServiceFabricApplicationType untuk mendaftarkan jenis aplikasi yang diperbarui.

Cmdlet ini memulai peningkatan pada kluster.

ApplicationParameters tidak dipertahankan di seluruh peningkatan aplikasi. Untuk mempertahankan parameter aplikasi saat ini, pengguna harus mendapatkan parameter terlebih dahulu dan meneruskannya ke panggilan API peningkatan, seperti yang ditunjukkan pada Contoh 1 di bawah ini.

Untuk informasi selengkapnya tentang peningkatan aplikasi Service Fabric, lihat dokumentasi konseptual.

Sebelum Anda melakukan operasi apa pun pada kluster Service Fabric, buat koneksi ke kluster dengan menggunakan cmdlet Connect-ServiceFabricCluster .

Contoh

Contoh 1: Dapatkan parameter aplikasi untuk diteruskan ke panggilan peningkatan

$myApplication = Get-ServiceFabricApplication -ApplicationName fabric:/myApplication
$appParamCollection = $myApplication.ApplicationParameters
$applicationParameterMap = @{}

foreach ($pair in $appParamCollection)
{ $applicationParameterMap.Add($pair.Name, $pair.Value); }

Start-ServiceFabricApplicationUpgrade -ApplicationName fabric:/myApplication -ApplicationTypeVersion 2.0.0 -ApplicationParameter $applicationParameterMap -Monitored -FailureAction Rollback

Contoh 2: Meningkatkan aplikasi

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "C:\PersistentToDoListServiceV2" -ImageStoreConnectionString "file:C:\ProgramData\ServiceFabric\ImageStore"
PS C:\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore "PersistentToDoListServiceV2"
PS C:\> Start-ServiceFabricApplicationUpgrade -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeVersion "2.0" -ForceRestart -UnMonitoredManual

Perintah pertama menggunakan cmdlet Copy-ServiceFabricApplicationPackage untuk menyalin paket aplikasi yang diperbarui ke penyimpanan citra.

Perintah kedua menggunakan cmdlet Register-ServiceFabricApplicationType untuk mendaftarkan jenis aplikasi yang diperbarui.

Perintah ketiga meningkatkan aplikasi. Perintah melakukan peningkatan manual yang tidak dipantau, yang mencakup mulai ulang server yang menghosting aplikasi.

Parameter

-ApplicationName

Menentukan Pengidentifikasi Sumber Daya Seragam (URI) dari aplikasi Service Fabric. Cmdlet meningkatkan aplikasi yang memiliki URI yang Anda tentukan.

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

-ApplicationParameter

Menentukan penimpaan untuk parameter aplikasi sebagai pasangan nama/nilai.

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

-ApplicationTypeVersion

Menentukan versi jenis aplikasi Service Fabric. Cmdlet meningkatkan aplikasi ke versi yang Anda tentukan.

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

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

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

-ConsiderWarningAsError

Menunjukkan apakah akan memperlakukan peristiwa kesehatan peringatan sebagai peristiwa kesalahan selama evaluasi kesehatan.

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

-DefaultServiceTypeHealthPolicy

Menentukan kebijakan kesehatan untuk jenis layanan default yang digunakan untuk peningkatan yang dipantau dalam format MaxPercentUnhealthyPartitionsPerService, MaxPercentUnhealthyReplicasPerPartition, MaxPercentUnhealthyServices. Misalnya, 5,10,15 menunjukkan nilai berikut:

• MaxPercentUnhealthyPartitionsPerService = 5
• MaxPercentUnhealthyReplicasPerPartition = 10
• MaxPercentUnhealthyServices = 15

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

-FailureAction

Menentukan tindakan yang akan diambil jika peningkatan yang dipantau gagal. Nilai yang dapat diterima untuk parameter ini adalah:

• Putar kembali
• Manual

Type:	UpgradeFailureAction
Accepted values:	Invalid, Rollback, Manual
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Menunjukkan bahwa cmdlet ini melewati pesan peringatan dan memaksa peningkatan.

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

-ForceRestart

Menunjukkan bahwa host layanan dimulai ulang meskipun peningkatan adalah perubahan khusus konfigurasi.

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

-HealthCheckRetryTimeoutSec

Menentukan durasi, dalam detik, setelah itu Service Fabric mencoba kembali pemeriksaan kesehatan jika pemeriksaan kesehatan sebelumnya gagal.

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

-HealthCheckStableDurationSec

Menentukan durasi, dalam detik, bahwa Service Fabric menunggu untuk memverifikasi bahwa aplikasi stabil sebelum pindah ke domain peningkatan berikutnya atau menyelesaikan peningkatan. Durasi tunggu ini mencegah perubahan kesehatan yang tidak terdeteksi tepat setelah pemeriksaan kesehatan dilakukan.

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

-HealthCheckWaitDurationSec

Menentukan durasi, dalam hitungan detik, bahwa Service Fabric menunggu sebelum melakukan pemeriksaan kesehatan awal setelah menyelesaikan peningkatan pada domain peningkatan.

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

-InstanceCloseDelayDurationSec

Menentukan durasi dalam hitungan detik, untuk menunggu sebelum instans stateless yang terpengaruh oleh peningkatan aplikasi ditutup, untuk memungkinkan permintaan aktif menguras dengan anggun. Durasi tunggu ini hanya efektif untuk instans layanan stateless yang memiliki nilai non-nol yang dikonfigurasi untuk InstanceCloseDelayDuration, dan akan menggantikan nilai yang telah dikonfigurasi sebelumnya. Lihat InstanceCloseDelayDuration (dalam New-ServiceFabricService) untuk detailnya.

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

-MaxPercentUnhealthyDeployedApplications

Menentukan persentase maksimum instans aplikasi yang disebarkan pada simpul dalam kluster yang memiliki status kesehatan kesalahan sebelum status kesehatan aplikasi untuk kluster adalah kesalahan.

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

-Monitored

Menunjukkan bahwa mode peningkatan dipantau. Setelah cmdlet menyelesaikan peningkatan untuk domain peingkatan, jika kesehatan domain peningkatan dan klaster memenuhi kebijakan kesehatan yang Anda tentukan, Service Fabric meningkatkan domain peningkatan berikutnya. Jika domain atau klaster peningkatan gagal memenuhi kebijakan kesehatan, peningkatan gagal dan Service Fabric mengembalikan peningkatan untuk domain peningkatan atau kembali ke mode manual sesuai kebijakan yang ditentukan. Ini adalah mode yang direkomendasikan untuk peningkatan aplikasi di lingkungan produksi.

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

-ReplicaQuorumTimeoutSec

Menentukan periode waktu habis, dalam detik, untuk memeriksa apakah kumpulan replika memiliki kuorum. Setelah periode waktu habis, peningkatan berlanjut.

Parameter ini tidak digunakan lagi. Tentukan parameter UpgradeReplicaSetCheckTimeoutSec sebagai gantinya.

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

-RestartProcess

Menunjukkan bahwa host layanan dimulai ulang sebagai bagian dari peningkatan.

Parameter ini tidak digunakan lagi. Tentukan parameter ForceRestart sebagai gantinya.

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

-ServiceTypeHealthPolicyMap

Menentukan peta kebijakan kesehatan yang akan digunakan untuk jenis layanan yang berbeda sebagai tabel hash dalam format berikut: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Contohnya:

@{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }

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

-SortOrder

Menentukan urutan peningkatan dilanjutkan melalui kluster.

Potensi nilai:

• Invalid - Menunjukkan bahwa urutan sortir ini tidak valid. Semua enumerasi Service Fabric memiliki jenis yang tidak valid.
• Default - Menunjukkan bahwa urutan sortir default (seperti yang ditentukan dalam manifes kluster) akan digunakan.
• Numeric - Menunjukkan bahwa urutan pengurutan numerik maju (nama UD yang diurutkan sebagai angka) akan digunakan.
• Lexicographical - Menunjukkan bahwa urutan pengurutan leksikografis ke depan (nama UD yang diurutkan sebagai string) akan digunakan.
• ReverseNumeric - Menunjukkan bahwa urutan pengurutan numerik terbalik (nama UD yang diurutkan sebagai angka) akan digunakan.
• ReverseLexicographical- Menunjukkan bahwa urutan pengurutan leksikografis terbalik (nama UD yang diurutkan sebagai string) akan digunakan.

Type:	UpgradeSortOrder
Accepted values:	Invalid, Default, Numeric, Lexicographical, ReverseNumeric, ReverseLexicographical
Position:	5
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TimeoutSec

Menentukan periode waktu habis, dalam detik, untuk operasi.

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

-UnmonitoredAuto

Menunjukkan bahwa mode peningkatan tidak dipantau secara otomatis. Setelah Service Fabric meningkatkan domain peningkatan, Service Fabric meningkatkan domain peningkatan berikutnya terlepas dari status kesehatan aplikasi. Mode ini tidak direkomendasikan untuk produksi, dan hanya berguna selama pengembangan aplikasi.

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

-UnmonitoredManual

Menunjukkan bahwa mode peningkatan tidak dipantau manual. Setelah Service Fabric meningkatkan domain peningkatan, ia menunggu Anda untuk meningkatkan domain peningkatan berikutnya dengan menggunakan cmdlet Resume-ServiceFabricApplicationUpgrade.

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

-UpgradeDomainTimeoutSec

Menentukan waktu maksimum, dalam detik, yang dibutuhkan Service Fabric untuk meningkatkan satu domain peningkatan. Setelah periode ini, peningkatan gagal.

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

-UpgradeReplicaSetCheckTimeoutSec

Menentukan waktu maksimum Service Fabric menunggu layanan dikonfigurasi ulang ke dalam keadaan aman, jika belum dalam keadaan aman, sebelum Service Fabric melanjutkan peningkatan.

Type:	UInt32
Position:	4
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UpgradeTimeoutSec

Menentukan waktu maksimum, dalam detik, yang dibutuhkan Service Fabric untuk seluruh peningkatan. Setelah periode ini, peningkatan gagal.

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

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

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

Input

None

Output

System.Object

Link Terkait

• Connect-ServiceFabricCluster
• Get-ServiceFabricClusterConnection
• Dapatkan-ServiceFabricApplicationUpgrade
• Resume-ServiceFabricApplicationUpgrade
• Salin-ServiceFabricApplicationPackage
• Dapatkan-ServiceFabricApplicationType