Update-ServiceFabricService

Módulo:

ServiceFabric

Novedades un servicio de Service Fabric.

Sintaxis

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.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	String
Valores aceptados:	Zero, Low, Medium, High, VeryHigh
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DropSourceReplicaOnMove

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

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Force

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

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	TimeSpan
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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).

Tipo:	InstanceLifecycleDescription
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	TimeSpan
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-PartitionNamesToAdd

{{Fill PartitionNamesToAdd Description}}

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-PartitionNamesToRemove

{{Fill PartitionNamesToRemove Description}}

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	TimeSpan
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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).

Tipo:	ReplicaLifecycleDescription
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	TimeSpan
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ScalingPolicies

{{Fill ScalingPolicies Description}}

Tipo:	System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ServiceDnsName

Especifica el nombre DNS actualizado de un servicio.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ServiceName

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

Tipo:	Uri
Posición:	1
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-ServicePlacementTimeLimit

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

Tipo:	TimeSpan
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	TimeSpan
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Stateful

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

Tipo:	SwitchParameter
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Stateless

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

Tipo:	SwitchParameter
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	System.Collections.Generic.List`1[System.String]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	System.Collections.Generic.List`1[System.String]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-TimeoutSec

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

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WhatIf

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

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

System.Uri

Salidas

System.Object

Vínculos relacionados

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