Update-ServiceFabricApplicationUpgrade

모듈:

ServiceFabric Module

활성 애플리케이션 업그레이드에 대한 업그레이드 설명을 수정합니다.

구문

Default (기본값)

Update-ServiceFabricApplicationUpgrade
    [-ApplicationName] <Uri>
    [-ForceRestart <Boolean>]
    [-UpgradeReplicaSetCheckTimeoutSec <UInt32>]
    [-UpgradeMode <RollingUpgradeMode>]
    [-FailureAction <UpgradeFailureAction>]
    [-HealthCheckRetryTimeoutSec <UInt32>]
    [-HealthCheckWaitDurationSec <UInt32>]
    [-HealthCheckStableDurationSec <UInt32>]
    [-UpgradeDomainTimeoutSec <UInt32>]
    [-UpgradeTimeoutSec <UInt32>]
    [-ConsiderWarningAsError <Boolean>]
    [-DefaultServiceTypeHealthPolicy <String>]
    [-MaxPercentUnhealthyDeployedApplications <Byte>]
    [-ServiceTypeHealthPolicyMap <Hashtable>]
    [-Force]
    [-InstanceCloseDelayDurationSec <UInt32>]
    [-TimeoutSec <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Update-ServiceFabricApplicationUpgrade cmdlet은 업그레이드가 활성 상태인 동안 애플리케이션 업그레이드 설명의 매개 변수를 수정합니다. Service Fabric은 클러스터 매니페스트에 지정된 대로 UpgradeStatusPollInterval 값에 따라 변경 내용을 검색하고 적용합니다. 상태 평가 정책을 제외하고 이 cmdlet은 지정한 매개 변수만 업데이트합니다. 지정되지 않은 매개 변수는 영향을 받지 않습니다. 다음 상태 평가 정책을 개별적으로 업데이트하지 않고 함께 업데이트해야 합니다.

• ConsiderWarningAsError
• defaultServiceTypeHealthPolicy
• MaxPercentUnhealthyDeployedApplications
• ServiceTypeHealthPolicyMap

Service Fabric 클러스터에서 작업을 수행하기 전에 Connect-ServiceFabricCluster cmdlet을 사용하여 클러스터에 대한 연결을 설정합니다.

예제

예제 1: 애플리케이션 업그레이드에 대한 값 업데이트

PS C:\> Update-ServiceFabricApplicationUpgrade -ApplicationName fabric:/MyApplication -UpgradeReplicaSetCheckTimeoutSec 0

이 명령은 패브릭:/MyApplication에서 보류 중인 업그레이드에 대해 복제본 집합 체크 제한 시간 값을 0으로 설정합니다. 업데이트는 다른 모든 업그레이드 값만 남습니다.

매개 변수

-ApplicationName

Service Fabric 애플리케이션의 URI(Uniform Resource Identifier)를 지정합니다. cmdlet은 이 매개 변수가 지정하는 URI가 있는 애플리케이션의 업그레이드 설정을 업데이트합니다.

매개 변수 속성

형식:	Uri
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	0
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	False
와일드카드 지원:	False
DontShow:	False
별칭:	cf(cf)

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ConsiderWarningAsError

상태 평가 중에 경고 상태 보고서를 오류로 처리할지 여부를 나타냅니다.

매개 변수 속성

형식:	Boolean
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-DefaultServiceTypeHealthPolicy

서비스 유형에 대한 기본 상태 정책을 지정합니다. 상태 정책은 모니터링되는 업그레이드에 사용됩니다. 정책은 MaxPercentUnhealthyPartitionsPerService, MaxPercentUnhealthyReplicasPerPartition, MaxPercentUnhealthyServices 형식을 따릅니다. 예를 들어 5,10,15는 다음 값을 나타냅니다.

• 최대 퍼센트비정상 파티션PerService = 5
• 파티션당 최대 비정상 복제본 비율 = 10
• 최대 퍼센트비정상 서비스 = 15

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-FailureAction

모니터링되는 업그레이드가 실패할 경우 수행할 작업을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

• 롤백
• 수동

매개 변수 속성

형식:	UpgradeFailureAction
Default value:	None
허용되는 값:	Invalid, Rollback, Manual
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Force

이 cmdlet이 경고 메시지를 건너뛰고 강제로 업데이트를 수행했음을 나타냅니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ForceRestart

업그레이드가 구성 전용 변경인 경우에도 서비스 호스트가 다시 시작되는지 여부를 나타냅니다.

매개 변수 속성

형식:	Boolean
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-HealthCheckRetryTimeoutSec

서비스 패브릭이 이전 상태 검사가 실패할 경우 상태 검사를 다시 시도한 기간(초)을 지정합니다.

매개 변수 속성

형식:	UInt32
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-HealthCheckStableDurationSec

Service Fabric이 다음 업그레이드 도메인으로 계속 진행하거나 업그레이드를 완료하기 전에 애플리케이션이 안정적인지 확인하기 위해 대기하는 기간(초)을 지정합니다. 이 대기 기간은 상태 검사가 수행된 직후에 감지되지 않은 상태 변경을 방지합니다.

매개 변수 속성

형식:	UInt32
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-HealthCheckWaitDurationSec

Service Fabric이 업그레이드 도메인에서 업그레이드를 완료한 후 초기 상태 검사를 수행하기 전에 대기하는 기간(초)을 지정합니다.

매개 변수 속성

형식:	UInt32
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-InstanceCloseDelayDurationSec

애플리케이션 업그레이드의 영향을 받는 상태 비스테이션 인스턴스가 닫히기 전에 대기하는 기간(초)을 지정하여 활성 요청이 정상적으로 드레이닝되도록 합니다. 이 대기 기간은 InstanceCloseDelayDuration에 대해 0이 아닌 값이 구성된 상태 비저장 서비스의 인스턴스에만 적용되며 미리 구성된 값을 재정의합니다. 자세한 내용은 InstanceCloseDelayDuration 참조하세요.

매개 변수 속성

형식:	UInt32
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-MaxPercentUnhealthyDeployedApplications

상태 오류가 발생할 수 있는 허용된 배포된 애플리케이션의 최대 비율을 지정합니다. 클러스터의 노드에 배포된 비정상 애플리케이션 인스턴스의 백분율이 이 매개 변수가 지정하는 값을 초과하면 애플리케이션의 상태가 오류입니다.

매개 변수 속성

형식:	Byte
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ServiceTypeHealthPolicyMap

다양한 서비스 유형에 사용할 상태 정책의 맵을 지정합니다. 다음 형식으로 맵을 해시 테이블로 지정합니다. @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. 예컨대:

@{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }

매개 변수 속성

형식:	Hashtable
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-TimeoutSec

작업의 제한 시간(초)을 지정합니다.

매개 변수 속성

형식:	Int32
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-UpgradeDomainTimeoutSec

Service Fabric이 단일 업그레이드 도메인을 업그레이드하는 데 걸리는 최대 시간(초)을 지정합니다. 이 기간이 지나면 업그레이드가 실패합니다.

매개 변수 속성

형식:	UInt32
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-UpgradeMode

업그레이드에 대한 새 UpgradeMode 지정합니다.

매개 변수 속성

형식:	RollingUpgradeMode
Default value:	None
허용되는 값:	Invalid, UnmonitoredAuto, UnmonitoredManual, Monitored
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-UpgradeReplicaSetCheckTimeoutSec

Service Fabric이 업그레이드를 진행하기 전에 서비스 패브릭이 안전한 상태로 다시 구성될 때까지 대기하는 최대 시간(초)을 지정합니다.

매개 변수 속성

형식:	UInt32
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-UpgradeTimeoutSec

Service Fabric이 전체 업그레이드에 걸리는 최대 시간(초)을 지정합니다. 이 기간이 지나면 업그레이드가 실패합니다.

매개 변수 속성

형식:	UInt32
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	False
와일드카드 지원:	False
DontShow:	False
별칭:	위스콘신

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

None

출력

System.Object

관련 링크

• Connect-ServiceFabricCluster
• Get-ServiceFabricApplicationUpgrade
• Get-ServiceFabricClusterConnection
• Resume-ServiceFabricApplicationUpgrade
• Start-ServiceFabricApplicationUpgrade
• Update-ServiceFabricClusterUpgrade