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