Update-ServiceFabricService

  • Riferimento
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.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:String
Valori accettati:Zero, Low, Medium, High, VeryHigh
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DropSourceReplicaOnMove

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

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:TimeSpan
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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).

Tipo:InstanceLifecycleDescription
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:TimeSpan
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PartitionNamesToAdd

{{Fill PartitionNamesToAdd Description}}

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PartitionNamesToRemove

{{Fill PartitionNamesToRemove Description}}

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:TimeSpan
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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).

Tipo:ReplicaLifecycleDescription
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:TimeSpan
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ScalingPolicies

{{Fill ScalingPolicies Description}}

Tipo:System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ServiceDnsName

Specifica il nome DNS aggiornato di un servizio.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ServiceName

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

Tipo:Uri
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ServicePlacementTimeLimit

Imposta il limite di tempo di posizionamento del servizio.

Tipo:TimeSpan
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-StandByReplicaKeepDuration

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

Per altre informazioni su QuorumLossWaitDuration, vedere StatefulServiceDescription.StandByReplicaKeepDuration.

Tipo:TimeSpan
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Stateful

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

Tipo:SwitchParameter
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Stateless

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

Tipo:SwitchParameter
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:System.Collections.Generic.List`1[System.String]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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

Tipo:System.Collections.Generic.List`1[System.String]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TimeoutSec

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

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

System.Uri

Output

System.Object