Update-ServiceFabricService

Módulo:

ServiceFabric

Novedades un servicio de Service Fabric.

Syntax

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

El cmdlet Update-ServiceFabricService actualiza las propiedades de un servicio de Service Fabric en ejecución. El conjunto de propiedades que se pueden actualizar es un subconjunto de las propiedades que se especificaron en el momento de crear el servicio (mediante New-ServiceFabricService o New-ServiceFabricServiceFromTemplate). Puede obtener las propiedades actuales del servicio mediante Get-ServiceFabricServiceDescription.

Tenga en cuenta que actualizar las propiedades de un servicio en ejecución es diferente de actualizar el servicio mediante Start-ServiceFabricApplicationUpgrade. Actualizar el servicio (es decir, la aplicación) es una tarea en segundo plano de larga duración que implica mover la aplicación, de una versión a otra, un dominio de actualización a la vez. Para más información, consulte Actualización de aplicaciones de Service Fabric .

Antes de realizar cualquier operación en un clúster de Service Fabric, establezca una conexión con el clúster mediante el cmdlet Connect-ServiceFabricCluster .

Ejemplos

Ejemplo 1: Actualización de un servicio con estado

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

Este comando actualiza MinReplicaSetSize y TargetReplicaSetSize de un servicio de Fabric en ejecución a tres (3) y cinco (5).

Ejemplo 2: Actualización de un servicio sin estado

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

Este comando actualiza el recuento de instancias de un servicio de Fabric en ejecución a un valor de -1.

Ejemplo 3: Actualizar restricciones de selección de ubicación

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

Este comando actualiza las restricciones de selección de ubicación.

Ejemplo 4: Actualización de métricas de carga predeterminadas

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

El primer comando actualiza las métricas de carga predeterminadas para un servicio sin estado.

El segundo comando actualiza las métricas de carga predeterminadas de un servicio con estado.

Ejemplo 5: Actualización de la directiva de selección de ubicación

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

Este comando actualiza la directiva de selección de ubicación.

Ejemplo 6: Actualización de la correlación del servicio

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

Este comando actualiza la correlación del servicio.

Ejemplo 7: Actualización del nombre DNS del servicio

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

Este comando actualiza el nombre DNS del servicio de un servicio. Nota: Si el nombre DNS actualizado ya se ha consultado en el clúster o el servicio de actualización ya tenía un nombre DNS, se debe reiniciar el servicio DNS después de la actualización para invalidar la memoria caché.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

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

-Correlation

Especifica una matriz actualizada de restricciones de correlación para este servicio. Para más información sobre la correlación de servicios, consulte Configuración y uso de la afinidad de servicio en Service Fabric.

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

-DefaultMoveCost

Especifica el costo de traslado predeterminado actualizado que las réplicas tienen cuando se crean. Los valores permitidos para este parámetro son los siguientes:

• Cero
• Bajo
• Media
• Alto

Para más información sobre el costo de traslado, consulte Costo de movimiento del servicio para influir en las opciones de Resource Manager de clúster.

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

Permite quitar réplicas secundarias de origen antes de que las nuevas réplicas secundarias finalicen la compilación.

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

-Force

Obliga al comando a ejecutarse sin solicitar la confirmación del usuario.

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

-InstanceCloseDelayDuration

Especifica la duración en segundos, para esperar antes de que se cierre una instancia sin estado que se vea afectada por la actualización de la aplicación, para permitir que las solicitudes activas se agoten correctamente. Esta duración de espera solo es efectiva para las instancias de esos servicios sin estado que tienen un valor distinto de cero configurado para InstanceCloseDelayDuration y reemplazará el valor preconfigurado. Consulte InstanceCloseDelayDuration para obtener más información. No especifique este parámetro para los servicios con estado.

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

-InstanceCount

Especifica el número actualizado de instancias para el servicio sin estado de Service Fabric. No especifique este parámetro para los servicios con estado.

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

-InstanceLifecycleDescription

Descripción del ciclo de vida de las instancias que pertenecen a este servicio. Si no se especifica alguna configuración de esta sección, el valor predeterminado se toma del parámetro de clúster del mismo nombre (si existe).

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

-InstanceRestartWaitDuration

Cuando una instancia sin estado deja de funcionar, se inicia este temporizador. Cuando expire Service Fabric creará una nueva instancia en cualquier nodo del clúster. Esta configuración consiste en reducir la creación innecesaria de una nueva instancia en situaciones en las que es probable que la instancia se recupere en poco tiempo. Por ejemplo, durante una actualización. El valor predeterminado es 0, lo que indica que cuando la instancia sin estado deja de funcionar, Service Fabric comenzará inmediatamente a crear su reemplazo.

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

-Metric

Especifica la matriz actualizada de métricas que notifica el servicio. Para más información sobre las métricas, consulte Administración del consumo y carga de recursos en Service Fabric con métricas.

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

-MinInstanceCount

Especifica el número mínimo actualizado de instancias de la partición de servicio sin estado. Consulte MinInstanceCount (en New-ServiceFabricService) para obtener más información. No especifique este parámetro para los servicios con estado.

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

-MinInstancePercentage

Especifica el porcentaje mínimo actualizado de InstanceCount de una partición de servicio sin estado. Consulte MinInstancePercentage (en New-ServiceFabricService) para obtener más información. No especifique este parámetro para los servicios con estado.

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

-MinReplicaSetSize

Especifica el tamaño mínimo actualizado del conjunto de réplicas para el servicio con estado de Service Fabric. El valor debe ser menor que TargetReplicaSetSize de este servicio. Para obtener más información, vea StatefulServiceDescription.MinReplicaSetSize.

No especifique este parámetro para los servicios sin estado.

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

Especifica la restricción de selección de ubicación actualizada para el servicio. Para más información sobre las restricciones de selección de ubicación, consulte Restricciones de ubicación y propiedades del nodo.

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

-PlacementPolicy

Especifica una matriz actualizada de directivas de selección de ubicación para un servicio. Para más información sobre PlacementPolicy, consulte Directivas de selección de ubicación para los servicios de Service Fabric.

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

-QuorumLossWaitDuration

Especifica la duración actualizada, como un objeto TimeSpan , que Service Fabric espera antes de declarar la pérdida de datos para una partición de servicio.

Para obtener un objeto TimeSpan , use el cmdlet New-TimeSpan . Para obtener más información, escriba Get-Help New-TimeSpan.

Para obtener más información sobre el parámetro QuorumLossWaitDuration, consulte StatefulServiceDescription.QuorumLossWaitDuration.

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

-ReplicaLifecycleDescription

Descripción del ciclo de vida de las réplicas que pertenecen a este servicio. Si no se especifica alguna configuración de esta sección, el valor predeterminado se toma del parámetro de clúster del mismo nombre (si existe).

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

-ReplicaRestartWaitDuration

Especifica el intervalo actualizado, como un objeto TimeSpan , que Service Fabric espera a que se reinicie la réplica antes de crear una réplica de reemplazo. Para obtener un objeto TimeSpan , use el cmdlet New-TimeSpan .

Para obtener más información sobre QuorumLossWaitDuration, vea 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

Especifica el nombre DNS actualizado de un servicio.

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

-ServiceName

Especifica el URI de un servicio de Service Fabric cuyas propiedades deben actualizarse.

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

-ServicePlacementTimeLimit

Establece el límite de tiempo de selección de ubicación del servicio.

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

-StandByReplicaKeepDuration

Especifica la duración de mantenimiento de la réplica independiente actualizada como un objeto TimeSpan .

Para obtener más información sobre QuorumLossWaitDuration, consulte StatefulServiceDescription.StandByReplicaKeepDuration.

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

-Stateful

Indica que el servicio es un servicio con estado de Service Fabric.

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

-Stateless

Indica que el servicio es un servicio sin estado de Service Fabric.

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

-TagsRequiredToPlace

Declara las etiquetas necesarias para la selección de ubicación de un servicio. Resulta útil para influir dinámicamente en la selección de ubicación del servicio. Para más información, consulte Etiquetas de nodo dinámico de 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

Declara las etiquetas necesarias para la selección de ubicación y ejecución de un servicio. Resulta útil para influir dinámicamente en la selección de ubicación y ejecución del servicio. Para más información, consulte Etiquetas de nodo dinámico de 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

Especifica el tamaño del conjunto de réplicas de destino actualizado para un servicio con estado de Service Fabric. Para obtener más información, vea StatefulServiceDescription.TargetReplicaSetSize.

No especifique este parámetro para un servicio sin estado.

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

-TimeoutSec

Especifica el período de tiempo de espera, en segundos, para la operación.

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

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

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

Entradas

System.Uri

Salidas

System.Object

Vínculos relacionados

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