Update-ServiceFabricService

Modul:

ServiceFabric

Aktualizace službu Service Fabric.

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

Rutina Update-ServiceFabricService aktualizuje vlastnosti spuštěné služby Service Fabric. Sada vlastností, které lze aktualizovat, jsou podmnožinou vlastností, které byly zadány v době vytvoření služby (pomocí New-ServiceFabricService nebo New-ServiceFabricServiceFromTemplate). Aktuální vlastnosti služby můžete získat pomocí funkce Get-ServiceFabricServiceDescription.

Upozorňujeme, že aktualizace vlastností spuštěné služby se liší od upgradu služby pomocí příkazu Start-ServiceFabricApplicationUpgrade. Upgrade služby (tj. aplikace) je dlouhotrvající úloha na pozadí, která zahrnuje přesun aplikace z jedné verze do druhé, jednu doménu upgradu najednou. Další podrobnosti najdete v tématu Upgrade aplikace Service Fabric .

Před provedením jakékoli operace v clusteru Service Fabric vytvořte připojení ke clusteru pomocí rutiny Connect-ServiceFabricCluster .

Příklady

Příklad 1: Aktualizace stavové služby

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

Tento příkaz aktualizuje MinReplicaSetSize a TargetReplicaSetSize spuštěné služby Fabric na tři (3) a pět (5).

Příklad 2: Aktualizace bezstavové služby

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

Tento příkaz aktualizuje počet instancí spuštěné služby Fabric na hodnotu -1.

Příklad 3: Aktualizace omezení umístění

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

Tento příkaz aktualizuje omezení umístění.

Příklad 4: Aktualizace výchozích metrik načítání

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

První příkaz aktualizuje výchozí metriky načítání pro bezstavovou službu.

Druhý příkaz aktualizuje výchozí metriky načítání stavové služby.

Příklad 5: Aktualizace zásad umístění

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

Tento příkaz aktualizuje zásady umístění.

Příklad 6: Aktualizace korelace služby

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

Tento příkaz aktualizuje korelaci služby.

Příklad 7: Aktualizace názvu DNS služby

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

Tento příkaz aktualizuje název DNS služby služby. Poznámka: Pokud se aktualizovaný název DNS již dotazoval na cluster nebo služba aktualizace už měla název DNS, služba DNS by se měla restartovat po aktualizaci, aby se mezipaměť zneplatila.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-Correlation

Určuje aktualizované pole omezení korelace pro tuto službu. Další informace o korelaci služeb najdete v tématu Konfigurace a používání spřažení služeb ve službě Service Fabric.

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

-DefaultMoveCost

Určuje aktualizované výchozí náklady na přesun, které mají repliky při jejich vytvoření. Tento parametr přijímá tyto hodnoty:

• Žádnou
• Nízká
• Střední
• Vysoká

Další podrobnosti o přesunu nákladů najdete v tématu Náklady na přesun služeb pro ovlivnění možností Resource Manager clusteru.

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

Umožňuje vyřazení zdrojových sekundárních replik před dokončením sestavení novými sekundárními replikami.

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

-Force

Vynutí spuštění příkazu bez žádosti o potvrzení uživatele.

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

-InstanceCloseDelayDuration

Určuje dobu trvání v sekundách, která bude čekat před bezstavovou instancí, která je ovlivněna upgradem aplikace, aby aktivní požadavky mohly řádně vyprázdnit. Tato doba čekání je platná pouze pro instance bezstavových služeb, které mají nenulovou hodnotu nakonfigurovanou pro InstanceCloseDelayDuration a přepíše předem nakonfigurovanou hodnotu. Podrobnosti najdete v tématu InstanceCloseDelayDuration . Nezadávejte tento parametr pro stavové služby.

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

-InstanceCount

Určuje aktualizovaný počet instancí pro bezstavovou službu Service Fabric. Nezadávejte tento parametr pro stavové služby.

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

-InstanceLifecycleDescription

Popis životního cyklu instancí patřících této službě. Pokud není v této části zadána nějaká konfigurace, výchozí hodnota se převezme z parametru clusteru se stejným názvem (pokud existuje).

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

-InstanceRestartWaitDuration

Když dojde k výpadku bezstavové instance, spustí se tento časovač. Po vypršení platnosti Service Fabric vytvoří novou instanci na libovolném uzlu v clusteru. Tato konfigurace snižuje zbytečné vytváření nové instance v situacích, kdy se instance pravděpodobně v krátké době zotaví. Například během upgradu. Výchozí hodnota je 0, což znamená, že když dojde k výpadku bezstavové instance, Service Fabric okamžitě začne vytvářet jeho nahrazení.

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

-Metric

Určuje aktualizované pole metrik, které služba hlásí. Další informace o metrikách najdete v tématu Správa spotřeby prostředků a načítání v Service Fabric s využitím metrik.

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

-MinInstanceCount

Určuje aktualizovaný minimální počet instancí bezstavového oddílu služby. Podrobnosti najdete v tématu MinInstanceCount (v New-ServiceFabricServicečásti ). Nezadávejte tento parametr pro stavové služby.

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

-MinInstancePercentage

Určuje aktualizované minimální procento instanceCount bezstavového oddílu služby. Podrobnosti najdete v tématu MinInstancePercentage (in New-ServiceFabricService). Nezadávejte tento parametr pro stavové služby.

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

-MinReplicaSetSize

Určuje aktualizovanou minimální velikost sady replik pro stavovou službu Service Fabric. Hodnota musí být menší než TargetReplicaSetSize této služby. Další podrobnosti naleznete v tématu StatefulServiceDescription.MinReplicaSetSize.

Nezadávejte tento parametr pro bezstavové služby.

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

Určuje aktualizované omezení umístění pro službu. Další informace o omezeních umístění najdete v tématu Omezení umístění a vlastnosti uzlu.

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

-PlacementPolicy

Určuje aktualizované pole zásad umístění pro službu. Další informace o UmístěníPolicy najdete v tématu Zásady umístění pro služby Service Fabric.

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

-QuorumLossWaitDuration

Určuje aktualizovanou dobu trvání jako objekt TimeSpan , který Service Fabric čeká, než deklaruje ztrátu dat pro oddíl služby.

K získání objektu TimeSpan použijte rutinu New-TimeSpan . Další informace zobrazíte zadáním Get-Help New-TimeSpan.

Další informace o parametru QuorumLossWaitDuration najdete v tématu StatefulServiceDescription.QuorumLossWaitDuration.

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

-ReplicaLifecycleDescription

Popis životního cyklu replik patřících této službě. Pokud není v této části zadána nějaká konfigurace, výchozí hodnota se převezme z parametru clusteru se stejným názvem (pokud existuje).

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

-ReplicaRestartWaitDuration

Určuje aktualizovaný interval jako objekt TimeSpan , který Service Fabric čeká na restartování repliky před tím, než vytvoří náhradní repliku. K získání objektu TimeSpan použijte rutinu New-TimeSpan .

Další informace o kvoruLossWaitDuration najdete v tématu StatefulServiceDescription.ReplicaRestartWaitDuration.

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

Určuje aktualizovaný název DNS služby.

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

-ServiceName

Určuje identifikátor URI služby Service Fabric, jejíž vlastnosti je potřeba aktualizovat.

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

-ServicePlacementTimeLimit

Nastaví časový limit umístění služby.

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

-StandByReplicaKeepDuration

Určuje aktualizovanou samostatnou repliku zachovat dobu trvání jako objekt TimeSpan .

Další informace o kvoruLossWaitDuration najdete v tématu StatefulServiceDescription.StandByReplicaKeepDuration.

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

-Stateful

Označuje, že služba je stavová služba Service Fabric.

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

-Stateless

Označuje, že služba je bezstavová služba Service Fabric.

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

-TagsRequiredToPlace

Deklaruje značky požadované pro umístění služby. Užitečné pro dynamické ovlivnění umístění služby. Další informace najdete v tématu Značky dynamických uzlů 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

Deklaruje značky požadované pro umístění a spuštění služby. Užitečné pro dynamické ovlivnění umístění a spuštění služby. Další informace naleznete v tématu Service Fabric Dynamic Node Tags

Type:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TargetReplicaSetSize

Určuje aktualizovanou velikost sady cílových replik pro stavovou službu Service Fabric. Další podrobnosti naleznete v tématu StatefulServiceDescription.TargetReplicaSetSize.

Nezadávejte tento parametr pro bezstavovou službu.

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

-TimeoutSec

Určuje časový limit operace v sekundách.

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

Vstupy

System.Uri

Výstupy

System.Object

Související odkazy

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