Update-ServiceFabricService

Módulo:

ServiceFabric Module

Actualiza un servicio de Service Fabric.

Sintaxis

Stateless (valor predeterminado)

Update-ServiceFabricService
    [-ServiceName] <Uri>
    [-Stateless]
    [-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>]

Stateful

Update-ServiceFabricService
    [-ServiceName] <Uri>
    [-Stateful]
    [-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 a actualizar el servicio mediante Start-ServiceFabricApplicationUpgrade. La actualización del 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. Consulte Actualización de aplicaciones de Service Fabric para obtener más información.

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 tejido 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 tejido en ejecución a un valor de -1.

Ejemplo 3: Actualizar restricciones de ubicación

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

Este comando actualiza las restricciones 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 para un servicio con estado.

Ejemplo 5: Actualizar la directiva de ubicación

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

Este comando actualiza la directiva de colocació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 de servicios.

Ejemplo 7: Actualizar el 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, el servicio DNS debe reiniciarse después de la actualización para invalidar la caché.

Parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	False
Admite caracteres comodín:	False
DontShow:	False
Alias:	cf

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Correlation

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

Propiedades de parámetro

Tipo:	String[]
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-DefaultMoveCost

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

• Cero
• Bajo nivel
• Mediana
• Alto

Para obtener más información sobre el costo de movimiento, consulte Costo de movimiento de servicio para influir en las opciones de Cluster Resource Manager.

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Valores aceptados:	Zero, Low, Medium, High, VeryHigh
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-DropSourceReplicaOnMove

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

Propiedades de parámetro

Tipo:	Boolean
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

Stateful

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Force

Obliga a que el comando se ejecute sin pedir confirmación del usuario.

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-InstanceCloseDelayDuration

Especifica la duración en segundos, para esperar antes de que se cierre una instancia sin estado que se ve afectada por la actualización de la aplicación, para permitir que las solicitudes activas se drenen 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 anulará el valor preconfigurado. Consulte InstanceCloseDelayDuration para obtener más información. No especifique este parámetro para los servicios con estado.

Propiedades de parámetro

Tipo:	TimeSpan
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

Stateless

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	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.

Propiedades de parámetro

Tipo:	Int32
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

Stateless

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	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 cluster del mismo nombre (si existe).

Propiedades de parámetro

Tipo:	InstanceLifecycleDescription
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

Stateless

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	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 es para reducir la creación innecesaria de una nueva instancia en situaciones en las que es probable que la instancia que deja de funcionar 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 compilar su reemplazo.

Propiedades de parámetro

Tipo:	TimeSpan
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

Stateless

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Metric

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

Propiedades de parámetro

Tipo:	String[]
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-MinInstanceCount

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

Propiedades de parámetro

Tipo:	Int32
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

Stateless

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	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.

Propiedades de parámetro

Tipo:	Int32
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

Stateless

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	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, consulte StatefulServiceDescription.MinReplicaSetSize.

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

Propiedades de parámetro

Tipo:	Int32
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

Stateful

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-PartitionNamesToAdd

{{Rellenar PartitionNamesToAdd Description}}

Propiedades de parámetro

Tipo:	String[]
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-PartitionNamesToRemove

{{Rellenar PartitionNamesToRemove Descripción}}

Propiedades de parámetro

Tipo:	String[]
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-PlacementConstraints

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

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-PlacementPolicy

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

Propiedades de parámetro

Tipo:	String[]
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	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.

Propiedades de parámetro

Tipo:	TimeSpan
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

Stateful

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	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 cluster del mismo nombre (si existe).

Propiedades de parámetro

Tipo:	ReplicaLifecycleDescription
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

Stateful

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	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, consulte StatefulServiceDescription.ReplicaRestartWaitDuration.

Propiedades de parámetro

Tipo:	TimeSpan
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

Stateful

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-ScalingPolicies

{{Rellenar descripción de ScalingPolicies}}

Propiedades de parámetro

Tipo:	System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-ServiceDnsName

Especifica el nombre DNS actualizado de un servicio.

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-ServiceName

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

Propiedades de parámetro

Tipo:	Uri
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	1
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-ServicePlacementTimeLimit

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

Propiedades de parámetro

Tipo:	TimeSpan
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

Stateful

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-StandByReplicaKeepDuration

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

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

Propiedades de parámetro

Tipo:	TimeSpan
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

Stateful

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Stateful

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

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

Stateful

Posición:	0
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Stateless

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

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

Stateless

Posición:	0
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-TagsRequiredToPlace

Declara las etiquetas necesarias para la colocación de un servicio. Útil para influir dinámicamente en la colocación de servicios. Para obtener más información, consulte Etiquetas de nodo dinámico de Service Fabric.

Propiedades de parámetro

Tipo:	System.Collections.Generic.List`1[System.String]
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-TagsRequiredToRun

Declara las etiquetas necesarias para la colocación y ejecución de un servicio. Útil para influir dinámicamente en la ubicación y ejecución del servicio. Para obtener más información, consulte Etiquetas de nodo dinámico de Service Fabric

Propiedades de parámetro

Tipo:	System.Collections.Generic.List`1[System.String]
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	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, consulte StatefulServiceDescription.TargetReplicaSetSize.

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

Propiedades de parámetro

Tipo:	Int32
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

Stateful

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-TimeoutSec

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

Propiedades de parámetro

Tipo:	Int32
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-WhatIf

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

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	False
Admite caracteres comodín:	False
DontShow:	False
Alias:	Wi

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

System.Uri

Salidas

System.Object

Vínculos relacionados

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