다음을 통해 공유


Update-ServiceFabricService

Service Fabric 서비스를 업데이트.

구문

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

Update-ServiceFabricService cmdlet은 실행 중인 Service Fabric 서비스의 속성을 업데이트합니다. 업데이트할 수 있는 속성 집합은 서비스를 만들 때 지정한 속성의 하위 집합입니다(사용 New-ServiceFabricService 또는 New-ServiceFabricServiceFromTemplate사용). Get-ServiceFabricServiceDescription을 사용하여 서비스의 현재 속성을 가져올 수 있습니다.

실행 중인 서비스의 속성을 업데이트하는 것은 Start-ServiceFabricApplicationUpgrade를 사용하여 서비스를 업그레이드하는 것과 다릅니다. 서비스 업그레이드(즉, 애플리케이션)는 애플리케이션을 한 번에 하나의 업그레이드 도메인에서 다른 버전으로 이동하는 작업을 포함하는 장기 실행 백그라운드 작업입니다. 자세한 내용은 Service Fabric 애플리케이션 업그레이드 를 참조하세요.

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

예제

예제 1: 상태 저장 서비스 업데이트

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

이 명령은 실행 중인 Fabric 서비스의 MinReplicaSetSizeTargetReplicaSetSize 를 3(3) 및 5(5)로 업데이트합니다.

예제 2: 상태 비지정 서비스 업데이트

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

이 명령은 실행 중인 Fabric 서비스의 인스턴스 수를 -1 값으로 업데이트합니다.

예제 3: 배치 제약 조건 업데이트

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

이 명령은 배치 제약 조건을 업데이트합니다.

예제 4: 기본 부하 메트릭 업데이트

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

첫 번째 명령은 상태 비주류 서비스에 대한 기본 부하 메트릭을 업데이트합니다.

두 번째 명령은 상태 저장 서비스에 대한 기본 부하 메트릭을 업데이트합니다.

예제 5: 배치 정책 업데이트

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

이 명령은 배치 정책을 업데이트합니다.

예제 6: 서비스 상관 관계 업데이트

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

이 명령은 서비스 상관 관계를 업데이트합니다.

예제 7: 서비스 DNS 이름 업데이트

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

이 명령은 서비스의 서비스 DNS 이름을 업데이트합니다. 참고: 업데이트된 DNS 이름이 클러스터에서 이미 쿼리되었거나 업데이트 서비스에 DNS 이름이 이미 있는 경우 캐시를 무효화하려면 업데이트 후 DNS 서비스를 다시 시작해야 합니다.

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인을 요청합니다.

형식:SwitchParameter
별칭:cf
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Correlation

이 서비스에 대한 업데이트된 상관 관계 제약 조건 배열을 지정합니다. 서비스 상관 관계에 대한 자세한 내용은 Service Fabric에서 서비스 선호도 구성 및 사용을 참조하세요.

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DefaultMoveCost

복제본을 만들 때의 업데이트된 기본 이동 비용을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • 0
  • 낮음
  • 중간
  • 높음

이동 비용에 대한 자세한 내용은 클러스터 Resource Manager 선택에 영향을 주는 서비스 이동 비용을 참조하세요.

형식:String
허용되는 값:Zero, Low, Medium, High, VeryHigh
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DropSourceReplicaOnMove

새 보조 복제본이 빌드를 완료하기 전에 원본 보조 복제본을 삭제할 수 있습니다.

형식:Boolean
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Force

사용자 확인을 요청하지 않고 명령을 강제 실행합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InstanceCloseDelayDuration

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

형식:TimeSpan
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InstanceCount

Service Fabric 상태 비정상 서비스에 대한 업데이트된 인스턴스 수를 지정합니다. 상태 저장 서비스에 대해 이 매개 변수를 지정하지 마세요.

형식:Int32
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InstanceLifecycleDescription

이 서비스에 속하는 인스턴스에 대한 수명 주기 설명입니다. 이 섹션의 일부 구성을 지정하지 않으면 동일한 이름의 클러스터 매개 변수(있는 경우)에서 기본값을 가져옵니다.

형식:InstanceLifecycleDescription
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InstanceRestartWaitDuration

상태 비저장 인스턴스가 다운되면 이 타이머가 시작됩니다. 만료되면 Service Fabric은 클러스터의 모든 노드에 새 인스턴스를 만듭니다. 이 구성은 인스턴스가 중단되는 경우 짧은 시간 안에 복구할 가능성이 있는 경우 불필요한 새 인스턴스 생성을 줄이기 위한 것입니다. 예를 들어 업그레이드하는 동안입니다. 기본값은 0입니다. 이는 상태 비주류 인스턴스가 다운되면 Service Fabric이 즉시 교체 빌드를 시작한다는 것을 나타냅니다.

형식:TimeSpan
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Metric

서비스에서 보고하는 메트릭의 업데이트된 배열을 지정합니다. 메트릭에 대한 자세한 내용은 메트릭을 사용하여 Service Fabric에서 리소스 사용 및 로드 관리를 참조하세요.

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-MinInstanceCount

상태 비정상 서비스 파티션의 업데이트된 최소 인스턴스 수를 지정합니다. 자세한 내용은 MinInstanceCount (in New-ServiceFabricService)를 참조하세요. 상태 저장 서비스에 대해 이 매개 변수를 지정하지 마세요.

형식:Int32
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-MinInstancePercentage

상태 비스테이션 서비스 파티션의 InstanceCount 의 업데이트된 최소 비율을 지정합니다. 자세한 내용은 MinInstancePercentage (in New-ServiceFabricService)를 참조하세요. 상태 저장 서비스에 대해 이 매개 변수를 지정하지 마세요.

형식:Int32
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-MinReplicaSetSize

Service Fabric 상태 저장 서비스의 업데이트된 최소 복제본 집합 크기를 지정합니다. 이 값은 이 서비스의 TargetReplicaSetSize 보다 작아야 합니다. 자세한 내용은 StatefulServiceDescription.MinReplicaSetSize를 참조하세요.

상태 비정상 서비스에 대해 이 매개 변수를 지정하지 마세요.

형식:Int32
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PartitionNamesToAdd

{{Fill PartitionNamesToAdd Description}}

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PartitionNamesToRemove

{{Fill PartitionNamesToRemove description}}

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PlacementConstraints

서비스에 대한 업데이트된 배치 제약 조건을 지정합니다. 배치 제약 조건에 대한 자세한 내용은 Placement 제약 조건 및 노드 속성을 참조하세요.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PlacementPolicy

서비스에 대한 배치 정책의 업데이트된 배열을 지정합니다. PlacementPolicy에 대한 자세한 내용은 Service Fabric 서비스에 대한 배치 정책을 참조하세요.

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-QuorumLossWaitDuration

서비스 패브릭이 서비스 파티션에 대한 데이터 손실을 선언하기 전에 대기하는 업데이트된 기간을 TimeSpan 개체로 지정합니다.

TimeSpan 개체를 가져오려면 New-TimeSpan cmdlet을 사용합니다. 자세한 내용을 보려면 Get-Help New-TimeSpan를 입력하십시오.

QuorumLossWaitDuration 매개 변수에 대한 자세한 내용은 StatefulServiceDescription.QuorumLossWaitDuration을 참조하세요.

형식:TimeSpan
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ReplicaLifecycleDescription

이 서비스에 속한 복제본에 대한 수명 주기 설명입니다. 이 섹션의 일부 구성을 지정하지 않으면 동일한 이름의 클러스터 매개 변수(있는 경우)에서 기본값을 가져옵니다.

형식:ReplicaLifecycleDescription
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ReplicaRestartWaitDuration

업데이트된 간격을 TimeSpan 개체로 지정합니다. Service Fabric은 복제본이 교체 복제본을 만들기 전에 다시 시작될 때까지 기다립니다. TimeSpan 개체를 가져오려면 New-TimeSpan cmdlet을 사용합니다.

QuorumLossWaitDuration에 대한 자세한 내용은 StatefulServiceDescription.ReplicaRestartWaitDuration을 참조하세요.

형식:TimeSpan
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ScalingPolicies

{{ScalingPolicies 설명 채우기}}

형식:System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ServiceDnsName

서비스의 업데이트된 DNS 이름을 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ServiceName

속성을 업데이트해야 하는 Service Fabric 서비스의 URI를 지정합니다.

형식:Uri
Position:1
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ServicePlacementTimeLimit

서비스 배치 시간 제한을 설정합니다.

형식:TimeSpan
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-StandByReplicaKeepDuration

업데이트된 대기 복제본 유지 기간을 TimeSpan 개체로 지정합니다.

QuorumLossWaitDuration에 대한 자세한 내용은 StatefulServiceDescription.StandByReplicaKeepDuration을 참조하세요.

형식:TimeSpan
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Stateful

서비스가 Service Fabric 상태 저장 서비스임을 나타냅니다.

형식:SwitchParameter
Position:0
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Stateless

서비스가 Service Fabric 상태 비정상 서비스임을 나타냅니다.

형식:SwitchParameter
Position:0
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-TagsRequiredToPlace

서비스 배치에 필요한 태그를 선언합니다. 서비스 배치에 동적으로 영향을 주는 데 유용합니다. 자세한 내용은 Service Fabric 동적 노드 태그를 참조하세요.

형식:System.Collections.Generic.List`1[System.String]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-TagsRequiredToRun

서비스 배치 및 실행에 필요한 태그를 선언합니다. 서비스 배치 및 실행에 동적으로 영향을 주는 데 유용합니다. 자세한 내용은 Service Fabric 동적 노드 태그를 참조하세요.

형식:System.Collections.Generic.List`1[System.String]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-TargetReplicaSetSize

Service Fabric 상태 저장 서비스의 업데이트된 대상 복제본 집합 크기를 지정합니다. 자세한 내용은 StatefulServiceDescription.TargetReplicaSetSize를 참조하세요.

상태 비국적 서비스에 대해 이 매개 변수를 지정하지 마세요.

형식:Int32
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-TimeoutSec

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

형식:Int32
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WhatIf

cmdlet을 실행할 경우 발생하는 일을 표시합니다. cmdlet은 실행되지 않습니다.

형식:SwitchParameter
별칭:wi
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

System.Uri

출력

System.Object