Update-ServiceFabricService

Modulo:

ServiceFabric

Aggiornamenti un servizio di Service Fabric.

Sintassi

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>]

Descrizione

Il cmdlet Update-ServiceFabricService aggiorna le proprietà di un servizio di Service Fabric in esecuzione. Il set di proprietà che possono essere aggiornate è un subset delle proprietà specificate al momento della creazione del servizio (tramite New-ServiceFabricService o New-ServiceFabricServiceFromTemplate). È possibile ottenere le proprietà correnti del servizio usando Get-ServiceFabricServiceDescription.

Si noti che l'aggiornamento delle proprietà di un servizio in esecuzione è diverso dall'aggiornamento del servizio tramite Start-ServiceFabricApplicationUpgrade. L'aggiornamento del servizio (ovvero l'applicazione) è un'attività in background a esecuzione prolungata che comporta lo spostamento dell'applicazione, da una versione a un'altra, un dominio di aggiornamento alla volta. Per altri dettagli, vedere Aggiornamento dell'applicazione di Service Fabric .

Prima di eseguire qualsiasi operazione in un cluster di Service Fabric, stabilire una connessione al cluster usando il cmdlet Connect-ServiceFabricCluster .

Esempio

Esempio 1: Aggiornare un servizio con stato

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

Questo comando aggiorna MinReplicaSetSize e TargetReplicaSetSize di un servizio Fabric in esecuzione a tre (3) e cinque (5).

Esempio 2: Aggiornare un servizio senza stato

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

Questo comando aggiorna il numero di istanze di un servizio di Infrastruttura in esecuzione a un valore pari a -1.

Esempio 3: Aggiornare i vincoli di posizionamento

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

Questo comando aggiorna i vincoli di posizionamento.

Esempio 4: Aggiornare le metriche di caricamento predefinite

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

Il primo comando aggiorna le metriche di caricamento predefinite per un servizio senza stato.

Il secondo comando aggiorna le metriche di caricamento predefinite per un servizio con stato.

Esempio 5: Aggiornare i criteri di posizionamento

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

Questo comando aggiorna i criteri di posizionamento.

Esempio 6: Aggiornare la correlazione del servizio

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

Questo comando aggiorna la correlazione del servizio.

Esempio 7: Aggiornare il nome DNS del servizio

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

Questo comando aggiorna il nome DNS del servizio di un servizio. Nota: se il nome DNS aggiornato è già stato sottoposto a query nel cluster o il servizio di aggiornamento aveva già un nome DNS, il servizio DNS deve essere riavviato dopo l'aggiornamento per invalidare la cache.

Parametri

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

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

-Correlation

Specifica una matrice aggiornata di vincoli di correlazione per questo servizio. Per altre informazioni sulla correlazione del servizio, vedere Configurazione e uso dell'affinità del servizio in Service Fabric.

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

-DefaultMoveCost

Specifica il costo di spostamento predefinito aggiornato che le repliche hanno al momento della creazione. I valori validi per questo parametro sono:

• Zero
• Basso
• Medio
• Alto

Per altre informazioni sui costi di spostamento, vedere Costi di spostamento dei servizi per influenzare le scelte di Resource Manager del cluster.

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

Abilita l'eliminazione delle repliche secondarie di origine prima del completamento della compilazione delle nuove repliche secondarie.

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

-Force

Forza l'esecuzione del comando senza chiedere conferma all'utente.

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

-InstanceCloseDelayDuration

Specifica la durata, in secondi, di attesa prima della chiusura di un'istanza senza stato interessata dall'aggiornamento dell'applicazione, per consentire alle richieste attive di svuotare normalmente. Questa durata di attesa è valida solo per le istanze di tali servizi senza stato con un valore diverso da zero configurato per InstanceCloseDelayDuration e sostituirà il valore preconfigurato. Per informazioni dettagliate, vedere InstanceCloseDelayDuration . Non specificare questo parametro per i servizi con stato.

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

-InstanceCount

Specifica il numero aggiornato di istanze per il servizio senza stato di Service Fabric. Non specificare questo parametro per i servizi con stato.

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

-InstanceLifecycleDescription

Descrizione del ciclo di vita delle istanze appartenenti a questo servizio. Se in questa sezione non viene specificata una configurazione, il valore predefinito viene ricavato dal parametro del cluster con lo stesso nome (se esistente).

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

-InstanceRestartWaitDuration

Quando un'istanza senza stato diventa inattiva, viene avviato questo timer. Quando scade Service Fabric creerà una nuova istanza in qualsiasi nodo del cluster. Questa configurazione consente di ridurre la creazione non necessaria di una nuova istanza in situazioni in cui è probabile che l'istanza inattiva venga ripristinata in breve tempo. Ad esempio, durante un aggiornamento. Il valore predefinito è 0, che indica che quando l'istanza senza stato diventa inattiva, Service Fabric avvierà immediatamente la compilazione della sostituzione.

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

-Metric

Specifica la matrice aggiornata di metriche che il servizio segnala. Per altre informazioni sulle metriche, vedere Gestione del consumo e del carico delle risorse in Service Fabric con le metriche.

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

-MinInstanceCount

Specifica il numero minimo aggiornato di istanze della partizione del servizio senza stato. Per informazioni dettagliate, vedere MinInstanceCount (in New-ServiceFabricService). Non specificare questo parametro per i servizi con stato.

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

-MinInstancePercentage

Specifica la percentuale minima aggiornata di InstanceCount di una partizione del servizio senza stato. Per informazioni dettagliate, vedere MinInstancePercentage (in New-ServiceFabricService). Non specificare questo parametro per i servizi con stato.

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

-MinReplicaSetSize

Specifica le dimensioni minime del set di repliche aggiornate per il servizio con stato di Service Fabric. Il valore deve essere minore di TargetReplicaSetSize di questo servizio. Per altre informazioni, vedere StatefulServiceDescription.MinReplicaSetSize.

Non specificare questo parametro per i servizi senza stato.

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

Specifica il vincolo di posizionamento aggiornato per il servizio. Per altre informazioni sui vincoli di posizionamento, vedere Vincoli di posizionamento e proprietà dei nodi.

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

-PlacementPolicy

Specifica una matrice aggiornata di criteri di posizionamento per un servizio. Per altre informazioni su PlacementPolicy, vedere Criteri di posizionamento per i servizi di Service Fabric.

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

-QuorumLossWaitDuration

Specifica la durata aggiornata, come oggetto TimeSpan , che Service Fabric attende prima di dichiarare la perdita di dati per una partizione del servizio.

Per ottenere un oggetto TimeSpan , utilizzare il cmdlet New-TimeSpan . Per ulteriori informazioni, digitare Get-Help New-TimeSpan.

Per altre informazioni sul parametro QuorumLossWaitDuration, vedere StatefulServiceDescription.QuorumLossWaitDuration.

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

-ReplicaLifecycleDescription

Descrizione del ciclo di vita delle repliche appartenenti a questo servizio. Se in questa sezione non viene specificata una configurazione, il valore predefinito viene ricavato dal parametro del cluster con lo stesso nome (se esistente).

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

-ReplicaRestartWaitDuration

Specifica l'intervallo aggiornato, come oggetto TimeSpan , che Service Fabric attende il riavvio della replica prima di creare una replica sostitutiva. Per ottenere un oggetto TimeSpan , utilizzare il cmdlet New-TimeSpan .

Per altre informazioni su QuorumLossWaitDuration, vedere 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

Specifica il nome DNS aggiornato di un servizio.

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

-ServiceName

Specifica l'URI di un servizio di Service Fabric le cui proprietà devono essere aggiornate.

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

-ServicePlacementTimeLimit

Imposta il limite di tempo di posizionamento del servizio.

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

-StandByReplicaKeepDuration

Specifica la durata della replica stand-by aggiornata come oggetto TimeSpan .

Per altre informazioni su QuorumLossWaitDuration, vedere StatefulServiceDescription.StandByReplicaKeepDuration.

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

-Stateful

Indica che il servizio è un servizio con stato di Service Fabric.

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

-Stateless

Indica che il servizio è un servizio senza stato di Service Fabric.

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

-TagsRequiredToPlace

Dichiara i tag necessari per il posizionamento di un servizio. Utile per influenzare dinamicamente il posizionamento dei servizi. Per altre informazioni, vedere Tag dei nodi dinamici di 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

Dichiara i tag necessari per il posizionamento e l'esecuzione di un servizio. Utile per influenzare dinamicamente il posizionamento e l'esecuzione del servizio. Per altre informazioni, vedere Tag dei nodi dinamici di 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

-TargetReplicaSetSize

Specifica le dimensioni del set di repliche di destinazione aggiornato per un servizio con stato di Service Fabric. Per altre informazioni, vedere StatefulServiceDescription.TargetReplicaSetSize.

Non specificare questo parametro per un servizio senza stato.

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

-TimeoutSec

Specifica il periodo di timeout, espresso in secondi, per l'operazione.

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

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Input

System.Uri

Output

System.Object

Collegamenti correlati

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