Start-ServiceFabricApplicationUpgrade

Başvuru

Modül:: ServiceFabric

Service Fabric uygulamasını belirtilen ApplicationTypeVersion'a yükseltir.

Syntax

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.

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

-ApplicationParameter

Uygulama parametrelerinin geçersiz kılmalarını ad/değer çiftleri olarak belirtir.

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

-ApplicationTypeVersion

Service Fabric uygulama türünün sürümünü belirtir. cmdlet'i uygulamayı belirttiğiniz sürüme yükselter.

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

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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

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

-Force

Bu cmdlet'in uyarı iletisini atlayıp yükseltmeye zorlandığını gösterir.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-HealthCheckRetryTimeoutSec

Önceki sistem durumu denetimi başarısız olursa Service Fabric'in sistem durumu denetimini yeniden deneme süresini saniye cinsinden belirtir.

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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).

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Byte
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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" }

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

İşlem için zaman aşımı süresini saniye cinsinden belirtir.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	UInt32
Position:	4
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

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

Girişler

None

Çıkışlar

System.Object

Share via

Start-ServiceFabricApplicationUpgrade

Syntax

Description

Örnekler

Örnek 1: Yükseltme çağrısına geçirmek için uygulama parametrelerini alma

Örnek 2: Uygulamayı yükseltme

Parametreler

-ApplicationName

-ApplicationParameter

-ApplicationTypeVersion

-Confirm

-ConsiderWarningAsError

-DefaultServiceTypeHealthPolicy

-FailureAction

-Force

-ForceRestart

-HealthCheckRetryTimeoutSec

-HealthCheckStableDurationSec

-HealthCheckWaitDurationSec

-InstanceCloseDelayDurationSec

-MaxPercentUnhealthyDeployedApplications

-Monitored

-ReplicaQuorumTimeoutSec

-RestartProcess

-ServiceTypeHealthPolicyMap

-SortOrder

-TimeoutSec

-UnmonitoredAuto

-UnmonitoredManual

-UpgradeDomainTimeoutSec

-UpgradeReplicaSetCheckTimeoutSec

-UpgradeTimeoutSec

-WhatIf

Girişler

Çıkışlar

Ek kaynaklar

Share via

Start-ServiceFabricApplicationUpgrade

Syntax

Description

Örnekler

Örnek 1: Yükseltme çağrısına geçirmek için uygulama parametrelerini alma

Örnek 2: Uygulamayı yükseltme

Parametreler

-ApplicationName

-ApplicationParameter

-ApplicationTypeVersion

-Confirm

-ConsiderWarningAsError

-DefaultServiceTypeHealthPolicy

-FailureAction

-Force

-ForceRestart

-HealthCheckRetryTimeoutSec

-HealthCheckStableDurationSec

-HealthCheckWaitDurationSec

-InstanceCloseDelayDurationSec

-MaxPercentUnhealthyDeployedApplications

-Monitored

-ReplicaQuorumTimeoutSec

-RestartProcess

-ServiceTypeHealthPolicyMap

-SortOrder

-TimeoutSec

-UnmonitoredAuto

-UnmonitoredManual

-UpgradeDomainTimeoutSec

-UpgradeReplicaSetCheckTimeoutSec

-UpgradeTimeoutSec

-WhatIf

Girişler

Çıkışlar

İlişkili Bağlantılar

Ek kaynaklar