Update-ServiceFabricService
Service Fabric hizmetini Güncelleştirmeler.
Sözdizimi
Update-ServiceFabricService
[-Stateless]
[-ServiceName] <Uri>
[-InstanceCount <Int32>]
[-MinInstanceCount <Int32>]
[-MinInstancePercentage <Int32>]
[-InstanceLifecycleDescription <InstanceLifecycleDescription>]
[-Force]
[-PlacementConstraints <String>]
[-Metric <String[]>]
[-Correlation <String[]>]
[-PlacementPolicy <String[]>]
[-DefaultMoveCost <String>]
[-PartitionNamesToAdd <String[]>]
[-PartitionNamesToRemove <String[]>]
[-ScalingPolicies <System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]>]
[-InstanceCloseDelayDuration <TimeSpan>]
[-InstanceRestartWaitDuration <TimeSpan>]
[-ServiceDnsName <String>]
[-TagsRequiredToPlace <System.Collections.Generic.List`1[System.String]>]
[-TagsRequiredToRun <System.Collections.Generic.List`1[System.String]>]
[-TimeoutSec <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Update-ServiceFabricService
[-Stateful]
[-ServiceName] <Uri>
[-TargetReplicaSetSize <Int32>]
[-MinReplicaSetSize <Int32>]
[-ReplicaRestartWaitDuration <TimeSpan>]
[-QuorumLossWaitDuration <TimeSpan>]
[-StandByReplicaKeepDuration <TimeSpan>]
[-ServicePlacementTimeLimit <TimeSpan>]
[-DropSourceReplicaOnMove <Boolean>]
[-ReplicaLifecycleDescription <ReplicaLifecycleDescription>]
[-Force]
[-PlacementConstraints <String>]
[-Metric <String[]>]
[-Correlation <String[]>]
[-PlacementPolicy <String[]>]
[-DefaultMoveCost <String>]
[-PartitionNamesToAdd <String[]>]
[-PartitionNamesToRemove <String[]>]
[-ScalingPolicies <System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]>]
[-ServiceDnsName <String>]
[-TagsRequiredToPlace <System.Collections.Generic.List`1[System.String]>]
[-TagsRequiredToRun <System.Collections.Generic.List`1[System.String]>]
[-TimeoutSec <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Update-ServiceFabricService cmdlet'i, çalışan bir Service Fabric hizmetinin özelliklerini güncelleştirir. Güncelleştirilebilecek özellikler kümesi, hizmeti oluştururken belirtilen özelliklerin bir alt kümesidir (veya New-ServiceFabricServiceFromTemplate
kullanılarakNew-ServiceFabricService
).
Get-ServiceFabricServiceDescription komutunu kullanarak hizmetinizin geçerli özelliklerini alabilirsiniz.
Çalışan bir hizmetin özelliklerini güncelleştirmenin Start-ServiceFabricApplicationUpgrade kullanarak hizmetinizi yükseltmekten farklı olduğunu lütfen unutmayın. Hizmetinizi (örneğin, uygulamanızı) yükseltmek, uygulamanızı bir sürümden diğerine, bir kerede bir yükseltme etki alanına taşımayı içeren uzun süre çalışan bir arka plan görevidir. Daha fazla ayrıntı için lütfen bkz. Service Fabric Uygulama Yükseltmesi .
Service Fabric kümesinde herhangi bir işlem yapmadan önce Connect-ServiceFabricCluster cmdlet'ini kullanarak kümeyle bağlantı kurun.
Örnekler
Örnek 1: Durum bilgisi olan bir hizmeti güncelleştirme
PS C:\> Update-ServiceFabricService -Stateful fabric:/myapp/test -MinReplicaSetSize 3 -TargetReplicaSetSize 5
Bu komut, çalışan bir Doku Hizmetinin MinReplicaSetSize ve TargetReplicaSetSize değerlerini üç (3) ve beş (5) olarak güncelleştirir.
Örnek 2: Durum bilgisi olmayan bir hizmeti güncelleştirme
PS C:\> Update-ServiceFabricService -Stateless fabric:/myapp/test -InstanceCount -1
Bu komut, çalışan bir Doku Hizmeti'nin örnek sayısını -1 değerine güncelleştirir.
Örnek 3: Yerleştirme kısıtlamalarını güncelleştirme
PS C:\> Update-ServiceabricService -Stateless -ServiceName fabric:/myapp/test -PlacementConstraints "NodeName!=NodeBar"
Bu komut yerleştirme kısıtlamalarını güncelleştirir.
Örnek 4: Varsayılan yük ölçümlerini güncelleştirme
PS C:\> Update-ServiceFabricService -Stateless -ServiceName fabric:/myapp/test -Metric @("CPU,High,10")
PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -Metric @("CPU,High,10,1")
İlk komut, durum bilgisi olmayan bir hizmet için varsayılan yük ölçümlerini güncelleştirir.
İkinci komut, durum bilgisi olan bir hizmet için varsayılan yük ölçümlerini güncelleştirir.
Örnek 5: Güncelleştirme yerleştirme ilkesi
PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -PlacementPolicy @("InvalidDomain,fd:/dc2/rack2")
Bu komut yerleştirme ilkesini güncelleştirir.
Örnek 6: Hizmet bağıntısını güncelleştirme
PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -Correlation @("fabric:/app/test2,AlignedAffinity")
Bu komut hizmet bağıntısını güncelleştirir.
Örnek 7: Güncelleştirme hizmeti DNS adı
PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -ServiceDnsName stateful.dns
PS C:\> Update-ServiceFabricService -Stateless -ServiceName fabric:/myapp/test -ServiceDnsName stateless.dns
Bu komut, hizmetin DNS adını güncelleştirir. Not: Güncelleştirilmiş DNS adı kümede zaten sorgulandıysa veya güncelleştirme hizmetinin zaten bir DNS adı varsa, önbelleği geçersiz kılmaya yönelik güncelleştirmeden sonra DNS hizmeti yeniden başlatılmalıdır.
Parametreler
-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 |
-Correlation
Bu hizmet için güncelleştirilmiş bir bağıntı kısıtlaması dizisini belirtir. Hizmet bağıntısı hakkında daha fazla bilgi edinmek için bkz. Service Fabric'te hizmet benzini yapılandırma ve kullanma.
Tür: | String[] |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-DefaultMoveCost
Çoğaltmaların oluşturulduğunda sahip olduğu güncelleştirilmiş varsayılan taşıma maliyetini belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:
- Sıfır
- Düşük
- Orta
- Yüksek
Taşıma maliyeti hakkında daha fazla ayrıntı için bkz. Kümeyi etkilemeye yönelik hizmet taşıma maliyeti Resource Manager seçenekleri.
Tür: | String |
Kabul edilen değerler: | Zero, Low, Medium, High, VeryHigh |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-DropSourceReplicaOnMove
Yeni İkincil çoğaltmalar derlemeyi bitirmeden önce kaynak İkincil çoğaltmaların bırakılmasına olanak tanır.
Tür: | Boolean |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Force
Komutu, kullanıcı onayı istemeden çalışmaya zorlar.
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-InstanceCloseDelayDuration
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ılan durum bilgisi olmayan hizmetlerin örnekleri için geçerlidir. Ayrıntılar için bkz . InstanceCloseDelayDuration . Durum bilgisi olan hizmetler için bu parametreyi belirtmeyin.
Tür: | TimeSpan |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-InstanceCount
Service Fabric durum bilgisi olmayan hizmeti için güncelleştirilmiş örnek sayısını belirtir. Durum bilgisi olan hizmetler için bu parametreyi belirtmeyin.
Tür: | Int32 |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-InstanceLifecycleDescription
Bu hizmete ait örneklerin yaşam döngüsü açıklaması. Bu bölümdeki bir yapılandırma belirtilmezse, varsayılan değer aynı ada sahip küme parametresinden (varsa) alınır.
Tür: | InstanceLifecycleDescription |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-InstanceRestartWaitDuration
Durum bilgisi olmayan bir örnek devre dışı bırakıldığında bu zamanlayıcı başlatılır. Süresi dolduğunda Service Fabric, kümedeki herhangi bir düğümde yeni bir örnek oluşturur. Bu yapılandırma, örneğin kısa sürede kurtarılması olası durumlarda yeni bir örneğin gereksiz oluşturulmasını azaltmaya yöneliktir. Örneğin, yükseltme sırasında. Varsayılan değer 0'dır ve durum bilgisi olmayan örnek devre dışı bırakıldığında Service Fabric hemen yerini almaya başlar.
Tür: | TimeSpan |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Metric
Hizmetin rapor verdiği güncelleştirilmiş ölçüm dizisini belirtir. Ölçümler hakkında daha fazla bilgi edinmek için bkz. Service Fabric'te kaynak tüketimini ve yükünü ölçümlerle yönetme.
Tür: | String[] |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-MinInstanceCount
Durum bilgisi olmayan hizmet bölümünün güncelleştirilmiş en az örnek sayısını belirtir. Ayrıntılar için bkz. MinInstanceCount (içinde New-ServiceFabricService
). Durum bilgisi olan hizmetler için bu parametreyi belirtmeyin.
Tür: | Int32 |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-MinInstancePercentage
Durum bilgisi olmayan bir hizmet bölümünün güncelleştirilmiş en düşük InstanceCount yüzdesini belirtir. Ayrıntılar için bkz. MinInstancePercentage (içinde New-ServiceFabricService
). Durum bilgisi olan hizmetler için bu parametreyi belirtmeyin.
Tür: | Int32 |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-MinReplicaSetSize
Service Fabric durum bilgisi olan hizmet için güncelleştirilmiş en düşük çoğaltma kümesi boyutunu belirtir. Değer, bu hizmetin TargetReplicaSetSize değerinden küçük olmalıdır. Diğer ayrıntılar için bkz. StatefulServiceDescription.MinReplicaSetSize.
Durum bilgisi olmayan hizmetler için bu parametreyi belirtmeyin.
Tür: | Int32 |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-PartitionNamesToAdd
{{Fill PartitionNamesToAdd Description}}
Tür: | String[] |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-PartitionNamesToRemove
{{Fill PartitionNamesToRemove Description}}
Tür: | String[] |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-PlacementConstraints
Hizmet için güncelleştirilmiş yerleştirme kısıtlamasını belirtir. Yerleştirme kısıtlamaları hakkında daha fazla bilgi edinmek için bkz . Yerleştirme kısıtlamaları ve düğüm özellikleri.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-PlacementPolicy
Bir hizmet için güncelleştirilmiş yerleştirme ilkeleri dizisini belirtir. PlacementPolicy hakkında daha fazla bilgi edinmek için bkz . Service Fabric hizmetleri için yerleştirme ilkeleri.
Tür: | String[] |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-QuorumLossWaitDuration
Service Fabric'in bir hizmet bölümü için veri kaybı bildirmeden önce bekleyeceği güncelleştirilmiş süreyi Bir TimeSpan nesnesi olarak belirtir.
TimeSpan nesnesi almak için New-TimeSpan cmdlet'ini kullanın.
Daha fazla bilgi için Get-Help New-TimeSpan
yazın.
QuorumLossWaitDuration parametresi hakkında daha fazla bilgi edinmek için bkz. StatefulServiceDescription.QuorumLossWaitDuration.
Tür: | TimeSpan |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ReplicaLifecycleDescription
Bu hizmete ait çoğaltmaların yaşam döngüsü açıklaması. Bu bölümdeki bir yapılandırma belirtilmezse, varsayılan değer aynı ada sahip küme parametresinden (varsa) alınır.
Tür: | ReplicaLifecycleDescription |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ReplicaRestartWaitDuration
Service Fabric'in yeni bir çoğaltma oluşturmadan önce çoğaltmanın yeniden başlatılmasını beklediği güncelleştirilmiş aralığı bir TimeSpan nesnesi olarak belirtir. TimeSpan nesnesi almak için New-TimeSpan cmdlet'ini kullanın.
QuorumLossWaitDuration hakkında daha fazla bilgi edinmek için bkz. StatefulServiceDescription.ReplicaRestartWaitDuration.
Tür: | TimeSpan |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ScalingPolicies
{{Fill ScalingPolicies Description}}
Tür: | System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription] |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ServiceDnsName
Bir hizmetin güncelleştirilmiş DNS adını belirtir.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ServiceName
Özelliklerinin güncelleştirilmiş olması gereken service Fabric hizmetinin URI'sini belirtir.
Tür: | Uri |
Position: | 1 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-ServicePlacementTimeLimit
Hizmet yerleştirme zaman sınırını ayarlar.
Tür: | TimeSpan |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-StandByReplicaKeepDuration
Güncelleştirilmiş hazır bekleyen çoğaltma saklama süresini Bir TimeSpan nesnesi olarak belirtir.
QuorumLossWaitDuration hakkında daha fazla bilgi edinmek için bkz. StatefulServiceDescription.StandByReplicaKeepDuration.
Tür: | TimeSpan |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Stateful
Hizmetin durum bilgisi olan bir Service Fabric hizmeti olduğunu gösterir.
Tür: | SwitchParameter |
Position: | 0 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Stateless
Hizmetin durum bilgisi olmayan bir Service Fabric hizmeti olduğunu gösterir.
Tür: | SwitchParameter |
Position: | 0 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-TagsRequiredToPlace
Bir hizmetin yerleştirilmesi için gereken etiketleri bildirir. Hizmet yerleşimini dinamik olarak etkilemek için kullanışlıdır. Daha fazla bilgi için bkz. Service Fabric Dinamik Düğüm Etiketleri.
Tür: | System.Collections.Generic.List`1[System.String] |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-TagsRequiredToRun
Bir hizmetin yerleştirilmesi ve çalıştırılması için gereken etiketleri bildirir. Hizmet yerleşimini dinamik olarak etkilemek ve çalıştırmak için kullanışlıdır. Daha fazla bilgi için bkz. Service Fabric Dinamik Düğüm Etiketleri
Tür: | System.Collections.Generic.List`1[System.String] |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-TargetReplicaSetSize
Service Fabric durum bilgisi olan bir hizmet için güncelleştirilmiş hedef çoğaltma kümesi boyutunu belirtir. Diğer ayrıntılar için bkz. StatefulServiceDescription.TargetReplicaSetSize.
Durum bilgisi olmayan bir hizmet için bu parametreyi belirtmeyin.
Tür: | Int32 |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-TimeoutSec
İşlemin 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 |
-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
System.Uri
Çıkışlar
System.Object