Update-ServiceFabricService

Modul:

ServiceFabric

Uppdateringar 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 New-ServiceFabricService av 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 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 Uppgradering av Service Fabric-program .

Innan du utför en åtgärd på 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.

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

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

-DefaultMoveCost

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

• Noll
• Låg
• Medel
• Högt

Mer information om flyttkostnader finns i Kostnader för flytt av tjänster för att påverka alternativ för kluster Resource Manager.

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

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

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

-Force

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

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

-InstanceCloseDelayDuration

Anger varaktigheten i sekunder, att vänta innan en tillståndslös instans som påverkas av programuppgraderingen stängs, så att de aktiva begärandena kan tömmas korrekt. Den här väntetiden gäller endast för instanser av tillståndslösa tjänster som har ett värde som inte är noll konfigurerat för InstanceCloseDelayDuration och å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.

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

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

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

-InstanceRestartWaitDuration

När en tillståndslös instans kraschar 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 till för att minska onödigt skapande av en ny instans i situationer där den nedfallna instansen sannolikt kommer att återställas på kort tid. Till exempel under en uppgradering. Standardvärdet är 0, vilket indikerar att när den tillståndslösa instansen slutar fungera börjar Service Fabric omedelbart att bygga sin ersättning.

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

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

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

-MinInstancePercentage

Anger den uppdaterade minsta procentandelen 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.

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

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

-PartitionNamesToAdd

{{Fyll PartitionNamesToAdd Description}}

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

-PartitionNamesToRemove

{{Fyll i PartitionNamesToRemove-beskrivning}}

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

-PlacementConstraints

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

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

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

-QuorumLossWaitDuration

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

Om du vill hämta ett TimeSpan-objekt använder du cmdleten New-TimeSpan . För mer information ange Get-Help New-TimeSpan.

Mer information om parametern QuorumLossWaitDuration finns i StatefulServiceDescription.QuorumLossWaitDuration.

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

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

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

-ScalingPolicies

{{Fyll i beskrivning av scalingPolicies}}

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

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

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

-ServiceName

Anger URI:n för en Service Fabric-tjänst vars egenskaper behöver uppdateras.

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

-ServicePlacementTimeLimit

Anger tidsgränsen för tjänstplacering.

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

-StandByReplicaKeepDuration

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

Mer information om QuorumLossWaitDuration finns i StatefulServiceDescription.StandByReplicaKeepDuration.

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

-Stateful

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

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

-Stateless

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

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

-TagsRequiredToPlace

Deklarerar taggar som krävs för placering av en tjänst. Användbart för dynamisk påverkan på tjänstplacering. Mer information finns i Service Fabric Dynamic Node Tags (Dynamiska nodtaggar för Service Fabric).

Type:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 Service Fabric Dynamic Node Tags (Dynamiska nodtaggar för Service Fabric)

Type:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-TimeoutSec

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

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

-WhatIf

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

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

Indata

System.Uri

Utdata

System.Object

Relaterade länkar

• Connect-ServiceFabricCluster
• Get-ServiceFabricClusterConnection
• Get-ServiceFabricService
• New-ServiceFabricService
• Remove-ServiceFabricService
• Resolve-ServiceFabricService