Update-ServiceFabricService
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