Megosztás a következőn keresztül:

Update-ServiceFabricService

  • Referencia
Modul:
ServiceFabric

Egy Service Fabric-szolgáltatás frissítése.

Syntax

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

Az Update-ServiceFabricService parancsmag frissíti a futó Service Fabric-szolgáltatás tulajdonságait. A frissíthető tulajdonságok készlete a szolgáltatás létrehozásakor (New-ServiceFabricService vagy New-ServiceFabricServiceFromTemplate) megadott tulajdonságok részhalmaza. A szolgáltatás aktuális tulajdonságait Get-ServiceFabricServiceDescriptionhasználatával szerezheti be.

Vegye figyelembe, hogy egy futó szolgáltatás tulajdonságainak frissítése eltér a szolgáltatás frissítésétől Start-ServiceFabricApplicationUpgradehasználatával. A szolgáltatás (azaz az alkalmazás) frissítése egy hosszú ideig futó háttérfeladat, amely magában foglalja az alkalmazás egyik verzióról a másikra való áthelyezését, és egyszerre egy frissítési tartományt. További részletekért lásd Service Fabric-alkalmazásfrissítési.

Mielőtt bármilyen műveletet végrehajt egy Service Fabric-fürtön, hozzon létre kapcsolatot a fürttel a Connect-ServiceFabricCluster parancsmag használatával.

Példák

1. példa: Állapotalapú szolgáltatás frissítése

PS C:\> Update-ServiceFabricService -Stateful fabric:/myapp/test -MinReplicaSetSize 3 -TargetReplicaSetSize 5

Ez a parancs frissíti a MinReplicaSetSize és Futó Hálószolgáltatás TargetReplicaSetSize három (3) és öt (5) értékre.

2. példa: Állapot nélküli szolgáltatás frissítése

PS C:\> Update-ServiceFabricService -Stateless fabric:/myapp/test -InstanceCount -1

Ez a parancs egy futó Hálószolgáltatás példányszámát -1 értékre frissíti.

3. példa: Az elhelyezési korlátozások frissítése

PS C:\> Update-ServiceabricService -Stateless -ServiceName fabric:/myapp/test -PlacementConstraints "NodeName!=NodeBar"

Ez a parancs frissíti az elhelyezési korlátozásokat.

4. példa: Alapértelmezett terhelési metrikák frissítése

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")

Az első parancs frissíti az állapot nélküli szolgáltatások alapértelmezett terhelési metrikáit.

A második parancs frissíti az állapotalapú szolgáltatás alapértelmezett terhelési mérőszámait.

5. példa: Az elhelyezési szabályzat frissítése

PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -PlacementPolicy @("InvalidDomain,fd:/dc2/rack2")

Ez a parancs frissíti az elhelyezési szabályzatot.

6. példa: Szolgáltatás-korreláció frissítése

PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -Correlation @("fabric:/app/test2,AlignedAffinity")

Ez a parancs frissíti a szolgáltatás korrelációt.

7. példa: A szolgáltatás DNS-ének frissítése

PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -ServiceDnsName stateful.dns
PS C:\> Update-ServiceFabricService -Stateless -ServiceName fabric:/myapp/test -ServiceDnsName stateless.dns

Ez a parancs frissíti a szolgáltatás DNS-nevét. Megjegyzés: Ha a frissített DNS-nevet már lekérdezték a fürtön, vagy a frissítő szolgáltatás már rendelkezik DNS-névvel, a DNS-szolgáltatást a frissítés után újra kell indítani a gyorsítótár érvénytelenítéséhez.

Paraméterek

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Típus:SwitchParameter
Aliasok:cf
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Correlation

A szolgáltatásra vonatkozó korrelációs korlátozások frissített tömbjének megadása. A szolgáltatás korrelációjáról további információt Szolgáltatás affinitásának konfigurálása és használata a Service Fabric.

Típus:String[]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-DefaultMoveCost

Megadja a replikák létrehozásának alapértelmezett áthelyezési költségét. A paraméter elfogadható értékei a következők:

  • Nulla
  • Alacsony
  • Közepes
  • Magas

Az áthelyezési költségekkel kapcsolatos további információkért tekintse meg szolgáltatásáthelyezési költségeket a Fürterőforrás-kezelő választási lehetőségeinek befolyásolása.

Típus:String
Elfogadott értékek:Zero, Low, Medium, High, VeryHigh
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-DropSourceReplicaOnMove

Engedélyezi a másodlagos forrásreplikák elvetét, mielőtt az új másodlagos replikák befejezik a buildet.

Típus:Boolean
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Force

Kényszeríti a parancs futtatását anélkül, hogy felhasználói megerősítést kérne.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-InstanceCloseDelayDuration

Az alkalmazásfrissítés által érintett állapot nélküli példány bezárásának időtartamát adja meg másodpercben, hogy az aktív kérések kecsesen üríthessenek. Ez a várakozási időtartam csak azon állapot nélküli szolgáltatások példányai esetében érvényes, amelyek nem nulla értékűek az InstanceCloseDelayDuration szolgáltatáshoz konfigurálva, és felülbírálják az előre konfigurált értéket. Részletekért lásd InstanceCloseDelayDuration. Ne adja meg ezt a paramétert az állapotalapú szolgáltatásokhoz.

Típus:TimeSpan
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-InstanceCount

A Service Fabric állapot nélküli szolgáltatás példányainak frissített számát adja meg. Ne adja meg ezt a paramétert az állapotalapú szolgáltatásokhoz.

Típus:Int32
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-InstanceLifecycleDescription

A szolgáltatáshoz tartozó példányok életciklus-leírása. Ha ebben a szakaszban nincs megadva konfiguráció, a rendszer az alapértelmezett értéket az azonos nevű fürtparaméterből veszi (ha van).

Típus:InstanceLifecycleDescription
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-InstanceRestartWaitDuration

Ha egy állapot nélküli példány leáll, ez az időzítő elindul. Ha lejár, a Service Fabric létrehoz egy új példányt a fürt bármely csomópontján. Ez a konfiguráció csökkenti az új példány szükségtelen létrehozását olyan helyzetekben, amikor a példány valószínűleg rövid időn belül helyreáll. Például egy frissítés során. Az alapértelmezett érték 0, ami azt jelzi, hogy az állapot nélküli példány leállásakor a Service Fabric azonnal megkezdi a csere kiépítését.

Típus:TimeSpan
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Metric

A szolgáltatás által jelentésekben szereplő metrikák frissített tömbjének megadása. A metrikákkal kapcsolatos további információkért lásd Az erőforrás-felhasználás és -terhelés kezelése a Service Fabricben metrikákkal.

Típus:String[]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-MinInstanceCount

Az állapot nélküli szolgáltatáspartíció példányainak frissített minimális számát adja meg. Részletekért lásd MinInstanceCount (New-ServiceFabricService) című cikket. Ne adja meg ezt a paramétert az állapotalapú szolgáltatásokhoz.

Típus:Int32
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-MinInstancePercentage

Az állapot nélküli szolgáltatáspartíciók InstanceCount frissített minimális százalékos arányát adja meg. Részletekért lásd MinInstancePercentage (New-ServiceFabricService) című cikket. Ne adja meg ezt a paramétert az állapotalapú szolgáltatásokhoz.

Típus:Int32
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-MinReplicaSetSize

Megadja a Service Fabric állapotalapú szolgáltatás minimális replikakészletének frissített méretét. Az értéknek kisebbnek kell lennie, mint a szolgáltatás TargetReplicaSetSize. További információ: StatefulServiceDescription.MinReplicaSetSize.

Ne adja meg ezt a paramétert állapot nélküli szolgáltatásokhoz.

Típus:Int32
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-PartitionNamesToAdd

{{Fill PartitionNamesToAdd Description}}

Típus:String[]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-PartitionNamesToRemove

{{Fill PartitionNamesToRemove Description}}

Típus:String[]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-PlacementConstraints

Megadja a szolgáltatás frissített elhelyezési korlátozását. Az elhelyezési korlátozásokról további információt Elhelyezési korlátozások és csomóponttulajdonságokcímű témakörben talál.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-PlacementPolicy

Egy szolgáltatás elhelyezési szabályzatainak frissített tömbje. A PlacementPolicy-ról további információt Service Fabric-szolgáltatások elhelyezési szabályzatai.

Típus:String[]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-QuorumLossWaitDuration

A Service Fabric TimeSpan objektumként megadott frissített időtartamot adja meg, mielőtt adatvesztést deklarál egy szolgáltatáspartícióhoz.

TimeSpan objektum beszerzéséhez használja a New-TimeSpan parancsmagot. További információ: Get-Help New-TimeSpan.

A QuorumLossWaitDuration paraméterről további információt StatefulServiceDescription.QuorumLossWaitDurationcímű témakörben talál.

Típus:TimeSpan
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ReplicaLifecycleDescription

A szolgáltatáshoz tartozó replikák életciklus-leírása. Ha ebben a szakaszban nincs megadva konfiguráció, a rendszer az alapértelmezett értéket az azonos nevű fürtparaméterből veszi (ha van).

Típus:ReplicaLifecycleDescription
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ReplicaRestartWaitDuration

Azt a frissített időközt adja meg TimeSpan objektumként, amelyet a Service Fabric megvár, amíg a replika újraindul, mielőtt helyettesítő replikát hoz létre. TimeSpan objektum beszerzéséhez használja a New-TimeSpan parancsmagot.

A QuorumLossWaitDuration szolgáltatásról további információt StatefulServiceDescription.ReplicaRestartWaitDurationcímű témakörben talál.

Típus:TimeSpan
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ScalingPolicies

{{Fill ScalingPolicies Description}}

Típus:System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ServiceDnsName

A szolgáltatás frissített DNS-nevét adja meg.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ServiceName

Annak a Service Fabric-szolgáltatásnak az URI-ját adja meg, amelynek tulajdonságait frissíteni kell.

Típus:Uri
Position:1
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-ServicePlacementTimeLimit

Beállítja a szolgáltatáselhelyezési időkorlátot.

Típus:TimeSpan
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-StandByReplicaKeepDuration

A frissített készenléti replika időtartamát adja meg TimeSpan objektumként.

A QuorumLossWaitDuration szolgáltatásról további információt StatefulServiceDescription.StandByReplicaKeepDurationcímű témakörben talál.

Típus:TimeSpan
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Stateful

Azt jelzi, hogy a szolgáltatás egy Service Fabric állapotalapú szolgáltatás.

Típus:SwitchParameter
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Stateless

Azt jelzi, hogy a szolgáltatás egy Service Fabric állapot nélküli szolgáltatás.

Típus:SwitchParameter
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-TagsRequiredToPlace

Deklarálja a szolgáltatás elhelyezéséhez szükséges címkéket. Hasznos a szolgáltatáselhelyezés dinamikus befolyásolására. További információ: Service Fabric dinamikus csomópontcímkék.

Típus:System.Collections.Generic.List`1[System.String]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-TagsRequiredToRun

Deklarálja a szolgáltatás elhelyezéséhez és futtatásához szükséges címkéket. A szolgáltatás elhelyezésének és futtatásának dinamikus befolyásolására használható. További információ: Service Fabric dinamikus csomópontcímkék

Típus:System.Collections.Generic.List`1[System.String]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-TargetReplicaSetSize

A Service Fabric állapotalapú szolgáltatás frissített célreplikakészlet-méretét adja meg. További információ: StatefulServiceDescription.TargetReplicaSetSize.

Ne adja meg ezt a paramétert állapot nélküli szolgáltatáshoz.

Típus:Int32
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-TimeoutSec

A művelet időtúllépési időtartamát adja meg másodpercben.

Típus:Int32
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.

Típus:SwitchParameter
Aliasok:wi
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

Bevitelek

System.Uri

Kimenetek

System.Object