Update-ServiceFabricService

Modul:

ServiceFabric

Aktualizuje 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í zadaných při vytváření služby (pomocí New-ServiceFabricService nebo New-ServiceFabricServiceFromTemplate). Aktuální vlastnosti služby můžete získat pomocí Get-ServiceFabricServiceDescription.

Upozorňujeme, že aktualizace vlastností spuštěné služby se liší od upgradu služby pomocí 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 upgradu 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í bezstavové služby.

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 již aktualizovaný název DNS byl dotazován v clusteru nebo služba aktualizace již měla název DNS, služba DNS by se měla restartovat po aktualizaci, aby se mezipaměť zneplatněla.

Parametry

-Confirm

Před spuštěním rutiny vás vyzve 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 vService 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í. Přijatelné hodnoty pro tento parametr jsou:

• Nula
• Nízký
• Středně
• Vysoko

Další podrobnosti o nákladech na přesun najdete v tématu Náklady na přesun služby pro ovlivnění možností Cluster Resource Manageru.

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 výzvy k 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á má čekat, než se zavře bezstavová instance, která má vliv na upgrade aplikace, aby aktivní žádosti 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í zadána nějaká konfigurace v této části, 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 dojde k výpadku instance pravděpodobně za krátkou dobu. 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 její 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 zatížení 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). 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 (v 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 najdete 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, že 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 potřebujete 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í zadána nějaká konfigurace v této části, 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, že Service Fabric čeká na restartování repliky, než vytvoří náhradní repliku. K získání objektu TimeSpan použijte rutinu New-TimeSpan.

Další informace o kvorumLossWaitDuration 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 stand-by repliku zachovat dobu trvání jako TimeSpan objektu.

Další informace o kvorumLossWaitDuration 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 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

-TargetReplicaSetSize

Určuje aktualizovanou velikost sady cílových replik pro stavovou službu Service Fabric. Další podrobnosti najdete 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

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

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