Update-ServiceFabricService
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