Dela via


Update-ServiceFabricService

Uppdaterar en Service Fabric-tjänst.

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

Cmdleten Update-ServiceFabricService uppdaterar egenskaperna för en Service Fabric-tjänst som körs. Den uppsättning egenskaper som kan uppdateras är en delmängd av de egenskaper som angavs när tjänsten skapades (med hjälp av New-ServiceFabricService eller New-ServiceFabricServiceFromTemplate). Du kan hämta aktuella egenskaper för din tjänst med hjälp av Get-ServiceFabricServiceDescription.

Observera att uppdatering av egenskaperna för en tjänst som körs skiljer sig från att uppgradera tjänsten med hjälp av Start-ServiceFabricApplicationUpgrade. Att uppgradera tjänsten (t.ex. programmet) är en tidskrävande bakgrundsaktivitet som innebär att du flyttar ditt program, från en version till en annan, en uppgraderingsdomän i taget. Mer information finns i Service Fabric-programuppgradering.

Innan du utför någon åtgärd i ett Service Fabric-kluster upprättar du en anslutning till klustret med hjälp av cmdleten Connect-ServiceFabricCluster.

Exempel

Exempel 1: Uppdatera en tillståndskänslig tjänst

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

Det här kommandot uppdaterar MinReplicaSetSize och TargetReplicaSetSize för en infrastrukturtjänst som körs till tre (3) och fem (5).

Exempel 2: Uppdatera en tillståndslös tjänst

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

Det här kommandot uppdaterar instansantalet för en infrastrukturtjänst som körs till värdet -1.

Exempel 3: Uppdatera placeringsbegränsningar

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

Det här kommandot uppdaterar placeringsbegränsningarna.

Exempel 4: Uppdatera standardinläsningsmått

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

Det första kommandot uppdaterar standardinläsningsmåtten för en tillståndslös tjänst.

Det andra kommandot uppdaterar standardinläsningsmåtten för en tillståndskänslig tjänst.

Exempel 5: Uppdatera placeringsprincip

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

Det här kommandot uppdaterar placeringsprincipen.

Exempel 6: Uppdatera tjänstkorrelation

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

Det här kommandot uppdaterar tjänstkorrelationen.

Exempel 7: Uppdatera tjänstens DNS-namn

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

Det här kommandot uppdaterar tjänstens DNS-namn för en tjänst. Obs! Om det uppdaterade DNS-namnet redan har frågats i klustret eller om uppdateringstjänsten redan har ett DNS-namn, bör DNS-tjänsten startas om efter uppdateringen för att göra cachen ogiltig.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Correlation

Anger en uppdaterad matris med korrelationsbegränsningar för den här tjänsten. Mer information om tjänstkorrelation finns i Konfigurera och använda tjänsttillhörighet i Service Fabric.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultMoveCost

Anger den uppdaterade standardkostnaden för flytt som repliker har när de skapas. De godtagbara värdena för den här parametern är:

  • Noll
  • Låg
  • Medium
  • Hög

Mer information om flyttkostnader finns i Service movement cost for influencing Cluster Resource Manager choices.

Typ:String
Godkända värden:Zero, Low, Medium, High, VeryHigh
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DropSourceReplicaOnMove

Gör att sekundära källrepliker kan tas bort innan nya sekundära repliker slutför bygget.

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

Tvingar kommandot att köras utan att be om användarbekräftelse.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InstanceCloseDelayDuration

Anger varaktigheten i sekunder, att vänta innan en tillståndslös instans som påverkas av programuppgradering stängs, så att aktiva begäranden kan tömmas korrekt. Den här väntetiden gäller endast för instanser av de tillståndslösa tjänster som har ett värde som inte är noll och som har konfigurerats för InstanceCloseDelayDuration och som åsidosätter det förkonfigurerade värdet. Mer information finns i InstanceCloseDelayDuration. Ange inte den här parametern för tillståndskänsliga tjänster.

Typ:TimeSpan
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InstanceCount

Anger det uppdaterade antalet instanser för den tillståndslösa Service Fabric-tjänsten. Ange inte den här parametern för tillståndskänsliga tjänster.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InstanceLifecycleDescription

Livscykelbeskrivning av instanser som tillhör den här tjänsten. Om någon konfiguration i det här avsnittet inte anges hämtas standardvärdet från klusterparametern med samma namn (om det finns).

Typ:InstanceLifecycleDescription
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InstanceRestartWaitDuration

När en tillståndslös instans slutar fungera startar den här timern. När service fabric upphör att gälla skapas en ny instans på valfri nod i klustret. Den här konfigurationen är att minska onödiga skapande av en ny instans i situationer där instansen kommer att återställas på kort tid. Till exempel under en uppgradering. Standardvärdet är 0, vilket indikerar att service fabric omedelbart börjar bygga sin ersättning när den tillståndslösa instansen slutar fungera.

Typ:TimeSpan
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Metric

Anger den uppdaterade matrisen med mått som tjänsten rapporterar. Mer information om mått finns i Hantera resursförbrukning och belastning i Service Fabric med mått.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MinInstanceCount

Anger det uppdaterade minsta antalet instanser av den tillståndslösa tjänstpartitionen. Mer information finns i MinInstanceCount (i New-ServiceFabricService). Ange inte den här parametern för tillståndskänsliga tjänster.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MinInstancePercentage

Anger den uppdaterade lägsta procentandelen av InstanceCount för en tillståndslös tjänstpartition. Mer information finns i MinInstancePercentage (i New-ServiceFabricService). Ange inte den här parametern för tillståndskänsliga tjänster.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MinReplicaSetSize

Anger den uppdaterade minsta replikuppsättningsstorleken för den tillståndskänsliga Service Fabric-tjänsten. Värdet måste vara mindre än TargetReplicaSetSize- för den här tjänsten. Mer information finns i StatefulServiceDescription.MinReplicaSetSize.

Ange inte den här parametern för tillståndslösa tjänster.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PartitionNamesToAdd

{{Fyll PartitionNamesToAdd-beskrivning}}

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PartitionNamesToRemove

{{Fyll PartitionNamesToRemove-beskrivning}}

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PlacementConstraints

Anger den uppdaterade placeringsbegränsningen för tjänsten. Mer information om placeringsbegränsningar finns i Placeringsbegränsningar och nodegenskaper.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PlacementPolicy

Anger en uppdaterad matris med placeringsprinciper för en tjänst. Mer information om PlacementPolicy finns i Placeringsprinciper för Service Fabric-tjänster.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-QuorumLossWaitDuration

Anger den uppdaterade varaktigheten, som ett TimeSpan- objekt, som Service Fabric väntar innan dataförlust deklareras för en tjänstpartition.

Om du vill hämta ett TimeSpan--objekt använder du cmdleten New-TimeSpan. Om du vill ha mer information skriver du Get-Help New-TimeSpan.

Mer information om parametern QuorumLossWaitDuration finns i StatefulServiceDescription.QuorumLossWaitDuration.

Typ:TimeSpan
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ReplicaLifecycleDescription

Livscykelbeskrivning av repliker som tillhör den här tjänsten. Om någon konfiguration i det här avsnittet inte anges hämtas standardvärdet från klusterparametern med samma namn (om det finns).

Typ:ReplicaLifecycleDescription
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ReplicaRestartWaitDuration

Anger det uppdaterade intervallet, som ett TimeSpan- objekt, som Service Fabric väntar på att repliken ska startas om innan den skapar en ersättningsreplik. Om du vill hämta ett TimeSpan--objekt använder du cmdleten New-TimeSpan.

Mer information om QuorumLossWaitDuration finns i StatefulServiceDescription.ReplicaRestartWaitDuration.

Typ:TimeSpan
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ScalingPolicies

{{Beskrivning av fyllningsskalningPrinciper}}

Typ:System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ServiceDnsName

Anger det uppdaterade DNS-namnet på en tjänst.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ServiceName

Anger URI:n för en Service Fabric-tjänst vars egenskaper måste uppdateras.

Typ:Uri
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ServicePlacementTimeLimit

Anger tidsgränsen för tjänstplacering.

Typ:TimeSpan
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-StandByReplicaKeepDuration

Anger den uppdaterade stand-by-replikens varaktighet som ett TimeSpan- objekt.

Mer information om QuorumLossWaitDuration finns i StatefulServiceDescription.StandByReplicaKeepDuration.

Typ:TimeSpan
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Stateful

Anger att tjänsten är en tillståndskänslig Service Fabric-tjänst.

Typ:SwitchParameter
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Stateless

Anger att tjänsten är en tillståndslös Service Fabric-tjänst.

Typ:SwitchParameter
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TagsRequiredToPlace

Deklarerar taggar som krävs för placering av en tjänst. Användbart för att dynamiskt påverka tjänstplacering. Mer information finns i Service Fabric Dynamic Node Tags.

Typ:System.Collections.Generic.List`1[System.String]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TagsRequiredToRun

Deklarerar taggar som krävs för placering och körning av en tjänst. Användbart för att dynamiskt påverka tjänstplacering och körning. Mer information finns i Dynamiska nodtaggar för Service Fabric

Typ:System.Collections.Generic.List`1[System.String]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TargetReplicaSetSize

Anger den uppdaterade målreplikuppsättningsstorleken för en tillståndskänslig Service Fabric-tjänst. Mer information finns i StatefulServiceDescription.TargetReplicaSetSize.

Ange inte den här parametern för en tillståndslös tjänst.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TimeoutSec

Anger tidsgränsen i sekunder för åtgärden.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

System.Uri

Utdata

System.Object