다음을 통해 공유

Update-AzServiceFabricApplication

  • 참조
모듈:
Az.ServiceFabric

서비스 패브릭 애플리케이션을 업데이트합니다. 이렇게 하면 애플리케이션 매개 변수를 업데이트하거나 애플리케이션 업그레이드를 트리거하는 애플리케이션 유형 버전을 업그레이드할 수 있습니다. ARM 배포 애플리케이션만 지원합니다.

Syntax

Update-AzServiceFabricApplication
      [-ResourceGroupName] <String>
      [-ClusterName] <String>
      [-Name] <String>
      [[-ApplicationTypeVersion] <String>]
      [-ApplicationParameter <Hashtable>]
      [-MinimumNodeCount <Int64>]
      [-MaximumNodeCount <Int64>]
      [-ForceRestart]
      [-UpgradeReplicaSetCheckTimeoutSec <Int32>]
      [-FailureAction <FailureAction>]
      [-HealthCheckRetryTimeoutSec <Int32>]
      [-HealthCheckWaitDurationSec <Int32>]
      [-HealthCheckStableDurationSec <Int32>]
      [-UpgradeDomainTimeoutSec <Int32>]
      [-UpgradeTimeoutSec <Int32>]
      [-ConsiderWarningAsError]
      [-DefaultServiceTypeMaxPercentUnhealthyPartitionsPerService <Int32>]
      [-DefaultServiceTypeMaxPercentUnhealthyReplicasPerPartition <Int32>]
      [-DefaultServiceTypeUnhealthyServicesMaxPercent <Int32>]
      [-UnhealthyDeployedApplicationsMaxPercent <Int32>]
      [-ServiceTypeHealthPolicyMap <Hashtable>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzServiceFabricApplication
      [[-ApplicationTypeVersion] <String>]
      [-ApplicationParameter <Hashtable>]
      [-MinimumNodeCount <Int64>]
      [-MaximumNodeCount <Int64>]
      [-ForceRestart]
      [-UpgradeReplicaSetCheckTimeoutSec <Int32>]
      [-FailureAction <FailureAction>]
      [-HealthCheckRetryTimeoutSec <Int32>]
      [-HealthCheckWaitDurationSec <Int32>]
      [-HealthCheckStableDurationSec <Int32>]
      [-UpgradeDomainTimeoutSec <Int32>]
      [-UpgradeTimeoutSec <Int32>]
      [-ConsiderWarningAsError]
      [-DefaultServiceTypeMaxPercentUnhealthyPartitionsPerService <Int32>]
      [-DefaultServiceTypeMaxPercentUnhealthyReplicasPerPartition <Int32>]
      [-DefaultServiceTypeUnhealthyServicesMaxPercent <Int32>]
      [-UnhealthyDeployedApplicationsMaxPercent <Int32>]
      [-ServiceTypeHealthPolicyMap <Hashtable>]
      [-ResourceId] <String>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzServiceFabricApplication
      -InputObject <PSApplication>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

이 cmdlet은 애플리케이션 매개 변수를 업데이트하고 애플리케이션 유형 버전을 업그레이드하는 데 사용할 수 있습니다. 매개 변수를 업데이트하면 ARM 쪽에서만 모델이 변경되며, 새 형식 버전을 사용하는 경우에만 명령이 애플리케이션 업그레이드를 트리거합니다. 지정된 형식 버전은 New-AzServiceFabricApplicationTypeVersion을 사용하여 클러스터에 이미 만들어져야 합니다.

예제

예 1

$resourceGroupName = "testRG"
$clusterName = "testCluster"
$appName = "testApp"
$version = "v2"
$packageUrl = "https://sftestapp.blob.core.windows.net/sftestapp/testAppType_v2.sfpkg"
New-AzServiceFabricApplicationTypeVersion -ResourceGroupName $resourceGroupName -ClusterName $clusterName -Name $appName -Version $version -PackageUrl $packageUrl -Verbose
Update-AzServiceFabricApplication -ResourceGroupName $resourceGroupName -ClusterName $clusterName -ApplicationTypeVersion $version -Name $appName -ApplicationParameter @{key0="value0";key1=$null;key2="value2"}

이 예제에서는 New-AzServiceFabricApplicationTypeVersion을 사용하여 만든 형식 버전을 "v2"로 업데이트하는 애플리케이션 업그레이드를 시작합니다. 사용되는 애플리케이션 매개 변수는 애플리케이션 매니페스트에 정의되어야 합니다.

예제 2

$resourceGroupName = "testRG"
$clusterName = "testCluster"
$appName = "testApp"
Update-AzServiceFabricApplication -ResourceGroupName $resourceGroupName -ClusterName $clusterName -Name $appName -MinimumNodeCount 1 -MaximumNodeCount 4 -Verbose

이 예제에서는 애플리케이션에 대한 최소 및 최대 노드 수 제한을 업데이트합니다.

예 3

$resourceGroupName = "testRG"
$clusterName = "testCluster"
$appName = "testApp"
$version = "v2"
$packageUrl = "https://sftestapp.blob.core.windows.net/sftestapp/testAppType_v2.sfpkg"
New-AzServiceFabricApplicationTypeVersion -ResourceGroupName $resourceGroupName -ClusterName $clusterName -Name $appName -Version $version -PackageUrl $packageUrl -Verbose
Update-AzServiceFabricApplication -ResourceGroupName $resourceGroupName -ClusterName $clusterName -ApplicationTypeVersion $version -Name $appName -ApplicationParameter @{key0="value0";key1=$null;key2="value2"} -HealthCheckStableDurationSec 0 -HealthCheckWaitDurationSec 0 -HealthCheckRetryTimeoutSec 0 -UpgradeDomainTimeoutSec 5000 -UpgradeTimeoutSec 7000 -FailureAction Rollback -UpgradeReplicaSetCheckTimeoutSec 300 -ForceRestart

이 예제에서는 애플리케이션 업그레이드를 시작하여 형식 버전을 "v2"로 업데이트하고 현재 업그레이드에서 적용되는 일부 업그레이드 정책 매개 변수도 설정합니다.

예시 4

Update-AzServiceFabricApplication -ResourceGroupName $resourceGroupName -ClusterName $clusterName -Name $appName -ApplicationParameter @{key0="value0";key1=$null;key2="value2"}

이 예제에서는 애플리케이션 매개 변수를 업데이트하지만 이러한 변경 내용은 다음 버전이 애플리케이션으로 업그레이드될 때까지만 적용됩니다.

매개 변수

-ApplicationParameter

애플리케이션 매개 변수를 키/값 쌍으로 지정합니다. 이러한 매개 변수는 애플리케이션 매니페스트에 있어야 합니다.

형식:Hashtable
Position:Named
기본값:None
필수:False
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationTypeVersion

애플리케이션 유형 버전 지정

형식:String
Position:3
기본값:None
필수:False
Accept pipeline input:False
Accept wildcard characters:False

-ClusterName

클러스터의 이름을 지정합니다.

형식:String
Position:1
기본값:None
필수:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

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

형식:SwitchParameter
Aliases:cf
Position:Named
기본값:None
필수:False
Accept pipeline input:False
Accept wildcard characters:False

-ConsiderWarningAsError

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

형식:SwitchParameter
Position:Named
기본값:None
필수:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
기본값:None
필수:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultServiceTypeMaxPercentUnhealthyPartitionsPerService

모니터링되는 업그레이드에 사용할 기본 서비스 유형에 대한 상태 정책에서 허용하는 서비스당 지원되지 않는 파티션의 최대 백분율을 지정합니다.

형식:Int32
Position:Named
기본값:None
필수:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultServiceTypeMaxPercentUnhealthyReplicasPerPartition

모니터링되는 업그레이드에 사용할 기본 서비스 유형에 대한 상태 정책에서 허용하는 서비스당 도움이 되지 않는 복제본(replica) 최대 백분율을 지정합니다.

형식:Int32
Position:Named
기본값:None
필수:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultServiceTypeUnhealthyServicesMaxPercent

모니터링되는 업그레이드에 사용할 기본 서비스 유형에 대한 상태 정책에서 허용하는 지원되지 않는 서비스의 최대 비율을 지정합니다.

형식:Int32
Position:Named
기본값:None
필수:False
Accept pipeline input:False
Accept wildcard characters:False

-FailureAction

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

형식:FailureAction
허용되는 값:Rollback, Manual
Position:Named
기본값:None
필수:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceRestart

업그레이드가 구성 전용 변경인 경우에도 서비스 호스트가 다시 시작되었음을 나타냅니다.

형식:SwitchParameter
Position:Named
기본값:None
필수:False
Accept pipeline input:False
Accept wildcard characters:False

-HealthCheckRetryTimeoutSec

이전 상태 검사 실패할 경우 Service Fabric이 상태 검사 다시 시도한 기간(초)을 지정합니다.

형식:Int32
Position:Named
기본값:None
필수:False
Accept pipeline input:False
Accept wildcard characters:False

-HealthCheckStableDurationSec

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

형식:Int32
Position:Named
기본값:None
필수:False
Accept pipeline input:False
Accept wildcard characters:False

-HealthCheckWaitDurationSec

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

형식:Int32
Position:Named
기본값:None
필수:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

애플리케이션 리소스입니다.

형식:PSApplication
Position:Named
기본값:None
필수:True
Accept pipeline input:True
Accept wildcard characters:False

-MaximumNodeCount

애플리케이션을 배치할 최대 노드 수를 지정합니다.

형식:Int64
Position:Named
기본값:None
필수:False
Accept pipeline input:False
Accept wildcard characters:False

-MinimumNodeCount

Service Fabric이 이 애플리케이션에 대한 용량을 예약할 노드의 최소 수를 지정합니다.

형식:Int64
Position:Named
기본값:None
필수:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

애플리케이션의 이름 지정

형식:String
Aliases:ApplicationName
Position:2
기본값:None
필수:True
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

리소스 그룹의 이름을 지정합니다.

형식:String
Position:0
기본값:None
필수:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceId

애플리케이션의 Arm ResourceId입니다.

형식:String
Position:0
기본값:None
필수:True
Accept pipeline input:True
Accept wildcard characters:False

-ServiceTypeHealthPolicyMap

다른 서비스 유형에 사용할 상태 정책의 맵을 해시 테이블로 지정합니다. @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. 예: @{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }

형식:Hashtable
Position:Named
기본값:None
필수:False
Accept pipeline input:False
Accept wildcard characters:False

-UnhealthyDeployedApplicationsMaxPercent

클러스터의 애플리케이션 상태가 오류로 표시되기 전에 상태 오류가 있는 클러스터의 노드에 배포된 애플리케이션 인스턴스의 최대 비율을 지정합니다.

형식:Int32
Position:Named
기본값:None
필수:False
Accept pipeline input:False
Accept wildcard characters:False

-UpgradeDomainTimeoutSec

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

형식:Int32
Position:Named
기본값:None
필수:False
Accept pipeline input:False
Accept wildcard characters:False

-UpgradeReplicaSetCheckTimeoutSec

Service Fabric이 업그레이드를 진행하기 전에 서비스가 안전한 상태로 다시 구성되기를 기다리는 최대 시간을 지정합니다(아직 안전한 상태가 아닌 경우).

형식:Int32
Position:Named
기본값:None
필수:False
Accept pipeline input:False
Accept wildcard characters:False

-UpgradeTimeoutSec

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

형식:Int32
Position:Named
기본값:None
필수:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

형식:SwitchParameter
Aliases:wi
Position:Named
기본값:None
필수:False
Accept pipeline input:False
Accept wildcard characters:False

입력

String

PSApplication

출력

PSApplication