Delen via


Update-ServiceFabricService

Updates een Service Fabric-service.

Syntaxis

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

De cmdlet Update-ServiceFabricService werkt eigenschappen van een actieve Service Fabric-service bij. De set eigenschappen die kunnen worden bijgewerkt, zijn een subset van de eigenschappen die zijn opgegeven op het moment van het maken van de service (met of New-ServiceFabricServiceNew-ServiceFabricServiceFromTemplate). U kunt de huidige eigenschappen van uw service ophalen met get-ServiceFabricServiceDescription.

Houd er rekening mee dat het bijwerken van de eigenschappen van een actieve service anders is dan het upgraden van uw service met behulp van Start-ServiceFabricApplicationUpgrade. Het upgraden van uw service (d.w.w.v. een toepassing) is een langlopende achtergrondtaak waarbij u uw toepassing, van de ene versie naar de andere, één upgradedomein tegelijk verplaatst. Zie Service Fabric-toepassingsupgrade voor meer informatie.

Voordat u een bewerking uitvoert op een Service Fabric-cluster, maakt u een verbinding met het cluster met behulp van de cmdlet Connect-ServiceFabricCluster .

Voorbeelden

Voorbeeld 1: Een stateful service bijwerken

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

Met deze opdracht wordt de MinReplicaSetSize en TargetReplicaSetSize van een actieve Fabric-service bijgewerkt naar drie (3) en vijf (5).

Voorbeeld 2: Een stateless service bijwerken

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

Met deze opdracht wordt het aantal exemplaren van een actieve Fabric-service bijgewerkt naar een waarde van -1.

Voorbeeld 3: Beperkingen voor plaatsing bijwerken

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

Met deze opdracht worden de plaatsingsbeperkingen bijgewerkt.

Voorbeeld 4: Metrische standaardgegevens voor belasting bijwerken

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

Met de eerste opdracht worden de standaard metrische belastingsgegevens voor een staatloze service bijgewerkt.

Met de tweede opdracht worden de standaard metrische belastinggegevens voor een stateful service bijgewerkt.

Voorbeeld 5: Plaatsingsbeleid bijwerken

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

Met deze opdracht wordt het plaatsingsbeleid bijgewerkt.

Voorbeeld 6: Correlatie van service bijwerken

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

Met deze opdracht wordt de servicecorrelatie bijgewerkt.

Voorbeeld 7: DNS-naam van service bijwerken

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

Met deze opdracht wordt de DNS-naam van de service van een service bijgewerkt. Opmerking: als de bijgewerkte DNS-naam al op het cluster is opgevraagd of als de updateservice al een DNS-naam heeft, moet de DNS-service opnieuw worden gestart nadat de update de cache ongeldig heeft gemaakt.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Correlation

Hiermee geeft u een bijgewerkte matrix van correlatiebeperkingen voor deze service. Zie Serviceaffiniteit configureren en gebruiken in Service Fabric voor meer informatie over servicecorrelatie.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultMoveCost

Hiermee geeft u de bijgewerkte standaard verplaatsingskosten op die replica's hebben wanneer ze worden gemaakt. De aanvaardbare waarden voor deze parameter zijn:

  • Nul
  • Beperkt
  • Normaal
  • Hoog

Zie serviceverplaatsingskosten voor het beïnvloeden van cluster-Resource Manager keuzes voor meer informatie over verplaatsingskosten.

Type:String
Geaccepteerde waarden:Zero, Low, Medium, High, VeryHigh
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DropSourceReplicaOnMove

Hiermee kunnen secundaire bronreplica's worden verwijderd voordat nieuwe secundaire replica's de build voltooien.

Type:Boolean
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Dwingt de opdracht uit te voeren zonder te vragen om bevestiging van de gebruiker.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InstanceCloseDelayDuration

Hiermee geeft u de duur in seconden op, om te wachten voordat een staatloze instantie die wordt beïnvloed door de upgrade van de toepassing wordt gesloten, zodat de actieve aanvragen probleemloos kunnen worden verwijderd. Deze wachttijd is alleen van kracht voor de exemplaren van die staatloze services waarvoor een niet-nulwaarde is geconfigureerd voor instanceCloseDelayDuration en overschrijft de vooraf geconfigureerde waarde. Zie InstanceCloseDelayDuration voor meer informatie. Geef deze parameter niet op voor stateful services.

Type:TimeSpan
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InstanceCount

Hiermee geeft u het bijgewerkte aantal exemplaren voor de stateless Service Fabric-service op. Geef deze parameter niet op voor stateful services.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InstanceLifecycleDescription

Beschrijving van de levenscyclus van exemplaren die tot deze service behoren. Als een bepaalde configuratie in deze sectie niet is opgegeven, wordt de standaardwaarde opgehaald uit de clusterparameter van dezelfde naam (indien aanwezig).

Type:InstanceLifecycleDescription
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InstanceRestartWaitDuration

Wanneer een staatloze instantie uitvalt, wordt deze timer gestart. Wanneer het verloopt, maakt Service Fabric een nieuw exemplaar op elk knooppunt in het cluster. Deze configuratie is om het onnodig maken van een nieuw exemplaar te verminderen in situaties waarin het exemplaar in korte tijd waarschijnlijk zal worden hersteld. Bijvoorbeeld tijdens een upgrade. De standaardwaarde is 0, wat aangeeft dat wanneer het staatloze exemplaar uitvalt, Service Fabric onmiddellijk begint met het bouwen van de vervanging.

Type:TimeSpan
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Metric

Hiermee geeft u de bijgewerkte matrix met metrische gegevens op die de service rapporteert. Zie Resourceverbruik beheren en laden in Service Fabric met metrische gegevens voor meer informatie over metrische gegevens.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MinInstanceCount

Hiermee geeft u het bijgewerkte minimum aantal exemplaren van de stateless servicepartitie. Zie MinInstanceCount (in New-ServiceFabricService) voor meer informatie. Geef deze parameter niet op voor stateful services.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MinInstancePercentage

Hiermee geeft u het bijgewerkte minimumpercentage van InstanceCount van een stateless servicepartitie. Zie MinInstancePercentage (in New-ServiceFabricService) voor meer informatie. Geef deze parameter niet op voor stateful services.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MinReplicaSetSize

Hiermee geeft u de bijgewerkte minimale grootte van de replicaset voor de Stateful Service Fabric-service. De waarde moet kleiner zijn dan de TargetReplicaSetSize van deze service. Zie StatefulServiceDescription.MinReplicaSetSize voor meer informatie.

Geef deze parameter niet op voor stateless services.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PartitionNamesToAdd

{{Fill PartitionNamesToAdd Description}}

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PartitionNamesToRemove

{{Fill PartitionNamesToRemove Description}}

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PlacementConstraints

Hiermee geeft u de bijgewerkte plaatsingsbeperking voor de service. Zie Plaatsingsbeperkingen en knooppunteigenschappen voor meer informatie over plaatsingsbeperkingen.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PlacementPolicy

Hiermee geeft u een bijgewerkte matrix van plaatsingsbeleid voor een service. Zie Plaatsingsbeleid voor service fabric-services voor meer informatie over PlacementPolicy.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-QuorumLossWaitDuration

Hiermee geeft u de bijgewerkte duur, als een TimeSpan-object , dat Service Fabric wacht voordat het gegevensverlies voor een servicepartitie declareert.

Gebruik de cmdlet New-TimeSpan om een TimeSpan-object te verkrijgen. Typ Get-Help New-TimeSpan voor meer informatie.

Zie StatefulServiceDescription.QuorumLossWaitDuration voor meer informatie over de parameter QuorumLossWaitDuration.

Type:TimeSpan
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ReplicaLifecycleDescription

Beschrijving van de levenscyclus van replica's die tot deze service behoren. Als een bepaalde configuratie in deze sectie niet is opgegeven, wordt de standaardwaarde opgehaald uit de clusterparameter van dezelfde naam (indien aanwezig).

Type:ReplicaLifecycleDescription
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ReplicaRestartWaitDuration

Hiermee geeft u het bijgewerkte interval op, als een TimeSpan-object , dat Service Fabric wacht tot de replica opnieuw is opgestart voordat er een vervangende replica wordt gemaakt. Gebruik de cmdlet New-TimeSpan om een TimeSpan-object te verkrijgen.

Zie StatefulServiceDescription.ReplicaRestartWaitDuration voor meer informatie over QuorumLossWaitDuration.

Type:TimeSpan
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ScalingPolicies

{{Fill ScalingPolicies Description}}

Type:System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ServiceDnsName

Hiermee geeft u de bijgewerkte DNS-naam van een service.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ServiceName

Hiermee geeft u de URI van een Service Fabric-service waarvan de eigenschappen moeten worden bijgewerkt.

Type:Uri
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ServicePlacementTimeLimit

Hiermee stelt u de tijdslimiet voor de plaatsing van de service in.

Type:TimeSpan
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-StandByReplicaKeepDuration

Hiermee geeft u de bijgewerkte stand-by replica duur als een TimeSpan-object .

Zie StatefulServiceDescription.StandByReplicaKeepDuration voor meer informatie over QuorumLossWaitDuration.

Type:TimeSpan
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Stateful

Geeft aan dat de service een stateful Service Fabric-service is.

Type:SwitchParameter
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Stateless

Geeft aan dat de service een stateless Service Fabric-service is.

Type:SwitchParameter
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TagsRequiredToPlace

Declareert tags die vereist zijn voor de plaatsing van een service. Handig voor het dynamisch beïnvloeden van serviceplaatsing. Zie Service Fabric Dynamic Node Tags voor meer informatie.

Type:System.Collections.Generic.List`1[System.String]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TagsRequiredToRun

Declareert tags die vereist zijn voor plaatsing en uitvoering van een service. Handig voor het dynamisch beïnvloeden van serviceplaatsing en uitvoering. Zie Service Fabric Dynamic Node Tags voor meer informatie

Type:System.Collections.Generic.List`1[System.String]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TargetReplicaSetSize

Hiermee geeft u de bijgewerkte grootte van de doelreplicaset op voor een Stateful Service Fabric-service. Zie StatefulServiceDescription.TargetReplicaSetSize voor meer informatie.

Geef deze parameter niet op voor een staatloze service.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TimeoutSec

Hiermee geeft u de time-outperiode, in seconden, voor de bewerking op.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

System.Uri

Uitvoerwaarden

System.Object