Start-ServiceFabricApplicationUpgrade
Service Fabric uygulamasını belirtilen ApplicationTypeVersion'a yükseltir.
Sözdizimi
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>]
Description
Start-ServiceFabricApplicationUpgrade cmdlet'i bir Service Fabric uygulamasını yükseltir. Bu cmdlet'i kullanmadan önce güncelleştirilmiş uygulama paketini görüntü deposuna kopyalamanız ve güncelleştirilmiş uygulama türünü kaydetmeniz gerekir. Uygulama paketini görüntü deposuna kopyalamak için Copy-ServiceFabricApplicationPackage kullanın. Güncelleştirilmiş uygulama türünü kaydetmek için Register-ServiceFabricApplicationType cmdlet'ini kullanın.
Bu cmdlet, kümede yükseltmeyi başlatır.
ApplicationParameters bir uygulama yükseltmesinde korunmaz. Geçerli uygulama parametrelerini korumak için, kullanıcı önce parametreleri almalı ve aşağıdaki Örnek 1'de gösterildiği gibi yükseltme API'si çağrısına geçirmelidir.
Service Fabric uygulama yükseltmeleri hakkında daha fazla bilgi için kavramsal belgelere bakın.
Service Fabric kümesinde herhangi bir işlem gerçekleştirmeden önce Connect-ServiceFabricCluster cmdlet'ini kullanarak kümeyle bağlantı kurun.
Örnekler
Örnek 1: Yükseltme çağrısına geçirmek için uygulama parametrelerini alma
$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
Örnek 2: Uygulamayı yükseltme
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
İlk komut, güncelleştirilmiş uygulama paketini görüntü deposuna kopyalamak için Copy-ServiceFabricApplicationPackage cmdlet'ini kullanır.
İkinci komut, güncelleştirilmiş uygulama türünü kaydetmek için Register-ServiceFabricApplicationType cmdlet'ini kullanır.
Üçüncü komut uygulamayı yükseltmektedir. komutu, uygulamayı barındıran sunucunun yeniden başlatılmasını içeren izlenmeyen bir el ile yükseltme gerçekleştirir.
Parametreler
-ApplicationName
Service Fabric uygulamasının Tekdüzen Kaynak Tanımlayıcısını (URI) belirtir. cmdlet'i, belirttiğiniz URI'ye sahip uygulamayı yükselter.
Tür: | Uri |
Position: | 0 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ApplicationParameter
Uygulama parametrelerinin geçersiz kılmalarını ad/değer çiftleri olarak belirtir.
Tür: | Hashtable |
Position: | 2 |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ApplicationTypeVersion
Service Fabric uygulama türünün sürümünü belirtir. cmdlet'i uygulamayı belirttiğiniz sürüme yükselter.
Tür: | String |
Position: | 1 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Tür: | SwitchParameter |
Diğer adlar: | cf |
Position: | Named |
Default value: | False |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ConsiderWarningAsError
Bir uyarı sistem durumu olayının sistem durumu değerlendirmesi sırasında bir hata olayı olarak ele alıp almayacağını gösterir.
Tür: | Boolean |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-DefaultServiceTypeHealthPolicy
İzlenen yükseltme için kullanılacak varsayılan hizmet türünün sistem durumu ilkesini MaxPercentUnhealthyPartitionsPerService, MaxPercentUnhealthyReplicasPerPartition, MaxPercentUnhealthyServices biçiminde belirtir. Örneğin, 5,10,15 aşağıdaki değerleri gösterir:
- MaxPercentUnhealthyPartitionsPerService = 5
- MaxPercentUnhealthyReplicasPerPartition = 10
- MaxPercentUnhealthyServices = 15
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-FailureAction
İzlenen yükseltme başarısız olursa gerçekleştirilecek eylemi belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:
- Geri alma
- El ile
Tür: | UpgradeFailureAction |
Kabul edilen değerler: | Invalid, Rollback, Manual |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Force
Bu cmdlet'in uyarı iletisini atlayıp yükseltmeye zorlandığını gösterir.
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ForceRestart
Yükseltme yalnızca yapılandırma değişikliği olsa bile hizmet ana bilgisayarının yeniden başlatıldığını gösterir.
Tür: | SwitchParameter |
Position: | 3 |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-HealthCheckRetryTimeoutSec
Önceki sistem durumu denetimi başarısız olursa Service Fabric'in sistem durumu denetimini yeniden deneme süresini saniye cinsinden belirtir.
Tür: | UInt32 |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-HealthCheckStableDurationSec
Service Fabric'in bir sonraki yükseltme etki alanına geçmeden veya yükseltmeyi tamamlamadan önce uygulamanın kararlı olduğunu doğrulamak için bekleyeceği süreyi saniye cinsinden belirtir. Bu bekleme süresi, sistem durumu denetimi gerçekleştirildikten hemen sonra algılanmayan sistem durumu değişikliklerini engeller.
Tür: | UInt32 |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-HealthCheckWaitDurationSec
Service Fabric'in yükseltme etki alanındaki yükseltmeyi tamamladıktan sonra ilk sistem durumu denetimini gerçekleştirmeden önce bekleyeceği süreyi saniye cinsinden belirtir.
Tür: | UInt32 |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-InstanceCloseDelayDurationSec
Etkin isteklerin düzgün bir şekilde boşaltılabilmesi için, uygulama yükseltmeden etkilenen durum bilgisi olmayan bir örneğin kapatılması için beklenme süresini saniye cinsinden belirtir. Bu bekleme süresi yalnızca InstanceCloseDelayDuration için sıfır olmayan bir değer yapılandırılmış olan ve önceden yapılandırılmış değeri geçersiz kılacak durum bilgisi olmayan hizmetlerin örnekleri için geçerlidir. Ayrıntılar için bkz. InstanceCloseDelayDuration (içinde New-ServiceFabricService
).
Tür: | UInt32 |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-MaxPercentUnhealthyDeployedApplications
Kümenin uygulama sistem durumu hata olmadan önce sistem durumu hata olan kümedeki düğümlere dağıtılan uygulama örneklerinin en yüksek yüzdesini belirtir.
Tür: | Byte |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Monitored
Yükseltme modunun izlendiğini gösterir. Cmdlet bir yükseltme etki alanı için yükseltmeyi tamamladıktan sonra, yükseltme etki alanının ve kümenin sistem durumu tanımladığınız sistem durumu ilkelerini karşılıyorsa, Service Fabric bir sonraki yükseltme etki alanını yükseltir. Yükseltme etki alanı veya küme sistem durumu ilkelerini karşılayamazsa, yükseltme başarısız olur ve Service Fabric yükseltme etki alanı için yükseltmeyi geri alır veya belirtilen ilkeye göre el ile moda geri döner. Bu, üretim ortamında uygulama yükseltmeleri için önerilen moddur.
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ReplicaQuorumTimeoutSec
Çoğaltma kümesinin çekirdek olup olmadığını denetlemek için zaman aşımı süresini saniye cinsinden belirtir. Zaman aşımı süresinden sonra yükseltme devam eder.
Bu parametre kullanım dışı bırakıldı. Bunun yerine UpgradeReplicaSetCheckTimeoutSec parametresini belirtin.
Tür: | UInt32 |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-RestartProcess
Hizmet ana bilgisayarının yükseltmenin bir parçası olarak yeniden başlatıldığını gösterir.
Bu parametre kullanım dışı bırakıldı. Bunun yerine ForceRestart parametresini belirtin.
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ServiceTypeHealthPolicyMap
Farklı hizmet türleri için kullanılacak sistem durumu ilkesinin eşlemesini şu biçimde karma tablo olarak belirtir: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Örnek:
@{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }
Tür: | Hashtable |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-SortOrder
Bir yükseltmenin küme üzerinden devam etme sırasını tanımlar.
Olası değerler şunlardır:
-
Invalid
- Bu sıralama düzeninin geçerli olmadığını gösterir. Tüm Service Fabric sabit listeleri geçersiz türe sahiptir. -
Default
- Varsayılan sıralama düzeninin (küme bildiriminde belirtildiği gibi) kullanılacağını gösterir. -
Numeric
- İletme sayısal sıralama düzeninin (sayı olarak sıralanmış UD adları) kullanılacağını gösterir. -
Lexicographical
- İleri sözcük temelli sıralama düzeninin (dize olarak sıralanmış UD adları) kullanılacağını gösterir. -
ReverseNumeric
- Ters sayısal sıralama düzeninin (sayı olarak sıralanmış UD adları) kullanılacağını gösterir. -
ReverseLexicographical
- Ters sözcük temelli sıralama düzeninin (dize olarak sıralanmış UD adları) kullanılacağını gösterir.
Tür: | UpgradeSortOrder |
Kabul edilen değerler: | Invalid, Default, Numeric, Lexicographical, ReverseNumeric, ReverseLexicographical |
Position: | 5 |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-TimeoutSec
İşlem için zaman aşımı süresini saniye cinsinden belirtir.
Tür: | Int32 |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-UnmonitoredAuto
Yükseltme modunun izlenmeyen otomatik olduğunu gösterir. Service Fabric bir yükseltme etki alanını yükseltdikten sonra, uygulama durumu ne olursa olun Service Fabric bir sonraki yükseltme etki alanını yükseltir. Bu mod üretim için önerilmez ve yalnızca bir uygulamanın geliştirilmesi sırasında kullanışlıdır.
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-UnmonitoredManual
Yükseltme modunun izlenmeyen el ile olduğunu gösterir. Service Fabric bir yükseltme etki alanını yükselttikte, Resume-ServiceFabricApplicationUpgrade cmdlet'ini kullanarak bir sonraki yükseltme etki alanını yükseltmenizi bekler.
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-UpgradeDomainTimeoutSec
Service Fabric'in tek bir yükseltme etki alanını yükseltmesi için gereken en uzun süreyi saniye cinsinden belirtir. Bu sürenin sonunda yükseltme başarısız olur.
Tür: | UInt32 |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-UpgradeReplicaSetCheckTimeoutSec
Service Fabric'in, service Fabric'in yükseltmeye devam etmeden önce güvenli durumda değilse, hizmetin güvenli bir duruma yeniden yapılandırılmasını bekleyeceği en uzun süreyi belirtir.
Tür: | UInt32 |
Position: | 4 |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-UpgradeTimeoutSec
Service Fabric'in tüm yükseltme için gereken en uzun süreyi saniye olarak belirtir. Bu sürenin sonunda yükseltme başarısız olur.
Tür: | UInt32 |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-WhatIf
Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
Tür: | SwitchParameter |
Diğer adlar: | wi |
Position: | Named |
Default value: | False |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
Girişler
None
Çıkışlar
System.Object