Update-ServiceFabricService
Updates een Service Fabric-service.
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
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-ServiceFabricService
New-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 |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Accepted values: | Zero, Low, Medium, High, VeryHigh |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DropSourceReplicaOnMove
Hiermee kunnen secundaire bronreplica's worden verwijderd voordat nieuwe secundaire replica's de build voltooien.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Dwingt de opdracht uit te voeren zonder te vragen om bevestiging van de gebruiker.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PartitionNamesToAdd
{{Fill PartitionNamesToAdd Description}}
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PartitionNamesToRemove
{{Fill PartitionNamesToRemove Description}}
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | TimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScalingPolicies
{{Fill ScalingPolicies Description}}
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
Hiermee geeft u de bijgewerkte DNS-naam van een service.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServicePlacementTimeLimit
Hiermee stelt u de tijdslimiet voor de plaatsing van de service in.
Type: | TimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Stateful
Geeft aan dat de service een stateful Service Fabric-service is.
Type: | SwitchParameter |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Stateless
Geeft aan dat de service een stateless Service Fabric-service is.
Type: | SwitchParameter |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeoutSec
Hiermee geeft u de time-outperiode, in seconden, voor de bewerking op.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Invoerwaarden
System.Uri
Uitvoerwaarden
System.Object