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

Update-ServiceFabricService

  • Referencia
Modul:
ServiceFabric

Service Fabric-szolgáltatás Frissítések.

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 egy futó Service Fabric-szolgáltatás tulajdonságait. A frissíthető tulajdonságok halmaza a szolgáltatás létrehozásakor megadott tulajdonságok részhalmaza (a következő használatával vagy New-ServiceFabricServiceFromTemplatehasználatávalNew-ServiceFabricService). A szolgáltatás aktuális tulajdonságait a Get-ServiceFabricServiceDescription használatával szerezheti be.

Vegye figyelembe, hogy egy futó szolgáltatás tulajdonságainak frissítése eltér a Start-ServiceFabricApplicationUpgrade szolgáltatással való frissítésétől. 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, egyszerre egy frissítési tartományt. További részletekért tekintse meg a Service Fabric alkalmazásfrissítését .

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 egy futó Fabric Service MinReplicaSetSize és TargetReplicaSetSize függvényét 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: 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 metrikáit.

5. példa: 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: Szolgáltatás DNS-nevé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 egy 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ési 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

Jóváhagyást kér a parancsmag futtatása előtt.

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

-Correlation

A szolgáltatás korrelációs kényszereinek frissített tömbje. A szolgáltatás-korrelációval kapcsolatos további információkért lásd: Szolgáltatás affinitásának konfigurálása és használata a Service Fabricben.

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

-DefaultMoveCost

Meghatározza a replikák létrehozáskor beállított alapértelmezett áthelyezési költségét. A paraméter elfogadható értékei a következők:

  • Eggyel sem
  • Alacsony
  • Közepes
  • Magas

Az áthelyezési költségekkel kapcsolatos további információkért tekintse meg a fürt Resource Manager választási lehetőségeinek befolyásolásával kapcsolatos szolgáltatási áthelyezési költségeket.

Type:String
Accepted values:Zero, Low, Medium, High, VeryHigh
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DropSourceReplicaOnMove

Engedélyezi, hogy a forrás másodlagos replikák el legyenek dobva, mielőtt az új másodlagos replikák befejezik a buildelést.

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

-Force

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

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

-InstanceCloseDelayDuration

Megadja másodpercben azt az időtartamot, amelyet az alkalmazásfrissítés által érintett állapot nélküli példány bezárása előtt kell várni, hogy az aktív kérések zökkenőmentesen ü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.

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

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

-InstanceLifecycleDescription

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

Type:InstanceLifecycleDescription
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 új példányt hoz létre 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 leállása valószínűleg rövid időn belül helyreáll. Például frissítés közben. Az alapértelmezett érték 0, ami azt jelzi, hogy amikor az állapot nélküli példány leáll, a Service Fabric azonnal megkezdi a csere összeállítását.

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

-Metric

Meghatározza a szolgáltatás által jelentésekben szereplő metrikák frissített tömbét. A metrikákkal kapcsolatos további információkért lásd: Erőforrás-használat és terhelés kezelése a Service Fabricben metrikákkal.

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

-MinInstanceCount

Meghatározza az állapot nélküli szolgáltatáspartíció példányainak frissített minimális számát. A részleteket a MinInstanceCount (in) című témakörben New-ServiceFabricServicetalálja. Ne adja meg ezt a paramétert az állapotalapú szolgáltatásokhoz.

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

-MinInstancePercentage

Egy állapot nélküli szolgáltatáspartíció InstanceCount értékének frissített minimális százalékos értékét adja meg. A részleteket a MinInstancePercentage (in New-ServiceFabricService) című témakörben találja. Ne adja meg ezt a paramétert az állapotalapú szolgáltatásokhoz.

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

-MinReplicaSetSize

Megadja a Service Fabric állapotalapú szolgáltatásának frissített minimális replikakészlet-méretét. Az értéknek kisebbnek kell lennie, mint a szolgáltatás TargetReplicaSetSize értéke. További részletekért lásd: StatefulServiceDescription.MinReplicaSetSize.

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

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

-PartitionNamesToAdd

{{Fill PartitionNamesToAdd Description}}

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

-PartitionNamesToRemove

{{Fill PartitionNamesToRemove Description}}

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

-PlacementConstraints

Megadja a szolgáltatás frissített elhelyezési kényszerét. Az elhelyezési korlátozásokról további információt az Elhelyezési kényszerek és a csomópont tulajdonságai című témakörben talál.

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

-PlacementPolicy

Egy szolgáltatás elhelyezési szabályzatainak frissített tömbje. A PlacementPolicy szolgáltatással kapcsolatos további információkért lásd a Service Fabric-szolgáltatások elhelyezési szabályzatai című témakört.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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óért írja be a következőt: Get-Help New-TimeSpan.

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

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

-ReplicaLifecycleDescription

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

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

-ReplicaRestartWaitDuration

A Service Fabric timeSpan objektumként megadott frissített időközt adja meg, amely a replika újraindítására vár, 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 a StatefulServiceDescription.ReplicaRestartWaitDuration című témakörben talál.

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

-ScalingPolicies

{{Fill ScalingPolicies Description}}

Type:System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServiceDnsName

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

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

-ServiceName

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

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

-ServicePlacementTimeLimit

Beállítja a szolgáltatás elhelyezési időkorlátját.

Type:TimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 a StatefulServiceDescription.StandByReplicaKeepDuration című témakörben talál.

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

-Stateful

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

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

-Stateless

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

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

-TagsRequiredToPlace

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

Type:System.Collections.Generic.List`1[System.String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TagsRequiredToRun

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

Type:System.Collections.Generic.List`1[System.String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TargetReplicaSetSize

A Service Fabric állapotalapú szolgáltatás frissített célreplikakészlet-méretét adja meg. További részletekért lásd: StatefulServiceDescription.TargetReplicaSetSize.

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

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

-TimeoutSec

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

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

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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

Bevitelek

System.Uri

Kimenetek

System.Object