Update-ServiceFabricService

Modul:

ServiceFabric

Aktualizace službu Service Fabric.

Syntaxe

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í.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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.

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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.

Typ:	String
Přípustné hodnoty:	Zero, Low, Medium, High, VeryHigh
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DropSourceReplicaOnMove

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

Typ:	Boolean
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Force

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

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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.

Typ:	TimeSpan
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-InstanceCount

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

Typ:	Int32
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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).

Typ:	InstanceLifecycleDescription
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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í.

Typ:	TimeSpan
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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.

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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.

Typ:	Int32
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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.

Typ:	Int32
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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.

Typ:	Int32
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-PartitionNamesToAdd

{{Fill PartitionNamesToAdd Description}}

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-PartitionNamesToRemove

{{Fill PartitionNamesToRemove Description}}

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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.

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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.

Typ:	TimeSpan
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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).

Typ:	ReplicaLifecycleDescription
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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.

Typ:	TimeSpan
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ScalingPolicies

{{Fill ScalingPolicies Description}}

Typ:	System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ServiceDnsName

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

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ServiceName

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

Typ:	Uri
Position:	1
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ServicePlacementTimeLimit

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

Typ:	TimeSpan
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-StandByReplicaKeepDuration

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

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

Typ:	TimeSpan
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Stateful

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

Typ:	SwitchParameter
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Stateless

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

Typ:	SwitchParameter
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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.

Typ:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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

Typ:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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.

Typ:	Int32
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-TimeoutSec

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

Typ:	Int32
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-WhatIf

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

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

System.Uri

Výstupy

System.Object

Související odkazy

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