Update-ServiceFabricService
Service Fabric 서비스를 업데이트.
Syntax
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 서비스의 MinReplicaSetSize 및 TargetReplicaSetSize 를 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을 실행하기 전에 확인을 요청합니다.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Correlation
이 서비스에 대한 업데이트된 상관 관계 제약 조건 배열을 지정합니다. 서비스 상관 관계에 대한 자세한 내용은 Service Fabric에서 서비스 선호도 구성 및 사용을 참조하세요.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultMoveCost
복제본을 만들 때의 업데이트된 기본 이동 비용을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.
- 0
- 낮음
- 중간
- 높음
이동 비용에 대한 자세한 내용은 클러스터 Resource Manager 선택에 영향을 주는 서비스 이동 비용을 참조하세요.
| Type: | String |
| Accepted values: | Zero, Low, Medium, High, VeryHigh |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DropSourceReplicaOnMove
새 보조 복제본이 빌드를 완료하기 전에 원본 보조 복제본을 삭제할 수 있습니다.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
사용자 확인을 요청하지 않고 명령을 강제 실행합니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InstanceCloseDelayDuration
애플리케이션 업그레이드의 영향을 받는 상태 비주성 인스턴스가 닫히기 전까지 대기하는 기간(초)을 지정하여 활성 요청이 정상적으로 드레이닝되도록 합니다. 이 대기 기간은 InstanceCloseDelayDuration에 대해 0이 아닌 값을 구성하고 미리 구성된 값을 재정의하는 상태 비저장 서비스의 인스턴스에만 적용됩니다. 자세한 내용은 InstanceCloseDelayDuration 을 참조하세요. 상태 저장 서비스에 대해 이 매개 변수를 지정하지 마세요.
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InstanceCount
Service Fabric 상태 비정상 서비스에 대한 업데이트된 인스턴스 수를 지정합니다. 상태 저장 서비스에 대해 이 매개 변수를 지정하지 마세요.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InstanceLifecycleDescription
이 서비스에 속하는 인스턴스에 대한 수명 주기 설명입니다. 이 섹션의 일부 구성을 지정하지 않으면 동일한 이름의 클러스터 매개 변수(있는 경우)에서 기본값을 가져옵니다.
| Type: | InstanceLifecycleDescription |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InstanceRestartWaitDuration
상태 비저장 인스턴스가 다운되면 이 타이머가 시작됩니다. 만료되면 Service Fabric은 클러스터의 모든 노드에 새 인스턴스를 만듭니다. 이 구성은 인스턴스가 중단되는 경우 짧은 시간 안에 복구할 가능성이 있는 경우 불필요한 새 인스턴스 생성을 줄이기 위한 것입니다. 예를 들어 업그레이드하는 동안입니다. 기본값은 0입니다. 이는 상태 비주류 인스턴스가 다운되면 Service Fabric이 즉시 교체 빌드를 시작한다는 것을 나타냅니다.
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Metric
서비스에서 보고하는 메트릭의 업데이트된 배열을 지정합니다. 메트릭에 대한 자세한 내용은 메트릭을 사용하여 Service Fabric에서 리소스 사용 및 로드 관리를 참조하세요.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MinInstanceCount
상태 비정상 서비스 파티션의 업데이트된 최소 인스턴스 수를 지정합니다. 자세한 내용은 MinInstanceCount (in New-ServiceFabricService)를 참조하세요. 상태 저장 서비스에 대해 이 매개 변수를 지정하지 마세요.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MinInstancePercentage
상태 비스테이션 서비스 파티션의 InstanceCount 의 업데이트된 최소 비율을 지정합니다. 자세한 내용은 MinInstancePercentage (in New-ServiceFabricService)를 참조하세요. 상태 저장 서비스에 대해 이 매개 변수를 지정하지 마세요.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MinReplicaSetSize
Service Fabric 상태 저장 서비스의 업데이트된 최소 복제본 집합 크기를 지정합니다. 이 값은 이 서비스의 TargetReplicaSetSize 보다 작아야 합니다. 자세한 내용은 StatefulServiceDescription.MinReplicaSetSize를 참조하세요.
상태 비정상 서비스에 대해 이 매개 변수를 지정하지 마세요.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PartitionNamesToAdd
{{Fill PartitionNamesToAdd Description}}
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PartitionNamesToRemove
{{Fill PartitionNamesToRemove description}}
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PlacementConstraints
서비스에 대한 업데이트된 배치 제약 조건을 지정합니다. 배치 제약 조건에 대한 자세한 내용은 Placement 제약 조건 및 노드 속성을 참조하세요.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PlacementPolicy
서비스에 대한 배치 정책의 업데이트된 배열을 지정합니다. PlacementPolicy에 대한 자세한 내용은 Service Fabric 서비스에 대한 배치 정책을 참조하세요.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-QuorumLossWaitDuration
서비스 패브릭이 서비스 파티션에 대한 데이터 손실을 선언하기 전에 대기하는 업데이트된 기간을 TimeSpan 개체로 지정합니다.
TimeSpan 개체를 가져오려면 New-TimeSpan cmdlet을 사용합니다.
자세한 내용을 보려면 Get-Help New-TimeSpan를 입력하십시오.
QuorumLossWaitDuration 매개 변수에 대한 자세한 내용은 StatefulServiceDescription.QuorumLossWaitDuration을 참조하세요.
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReplicaLifecycleDescription
이 서비스에 속한 복제본에 대한 수명 주기 설명입니다. 이 섹션의 일부 구성을 지정하지 않으면 동일한 이름의 클러스터 매개 변수(있는 경우)에서 기본값을 가져옵니다.
| Type: | ReplicaLifecycleDescription |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReplicaRestartWaitDuration
업데이트된 간격을 TimeSpan 개체로 지정합니다. Service Fabric은 복제본이 교체 복제본을 만들기 전에 다시 시작될 때까지 기다립니다. TimeSpan 개체를 가져오려면 New-TimeSpan cmdlet을 사용합니다.
QuorumLossWaitDuration에 대한 자세한 내용은 StatefulServiceDescription.ReplicaRestartWaitDuration을 참조하세요.
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ScalingPolicies
{{ScalingPolicies 설명 채우기}}
| Type: | System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ServiceDnsName
서비스의 업데이트된 DNS 이름을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ServiceName
속성을 업데이트해야 하는 Service Fabric 서비스의 URI를 지정합니다.
| Type: | Uri |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ServicePlacementTimeLimit
서비스 배치 시간 제한을 설정합니다.
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StandByReplicaKeepDuration
업데이트된 대기 복제본 유지 기간을 TimeSpan 개체로 지정합니다.
QuorumLossWaitDuration에 대한 자세한 내용은 StatefulServiceDescription.StandByReplicaKeepDuration을 참조하세요.
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Stateful
서비스가 Service Fabric 상태 저장 서비스임을 나타냅니다.
| Type: | SwitchParameter |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Stateless
서비스가 Service Fabric 상태 비정상 서비스임을 나타냅니다.
| Type: | SwitchParameter |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TagsRequiredToPlace
서비스 배치에 필요한 태그를 선언합니다. 서비스 배치에 동적으로 영향을 주는 데 유용합니다. 자세한 내용은 Service Fabric 동적 노드 태그를 참조하세요.
| Type: | System.Collections.Generic.List`1[System.String] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TagsRequiredToRun
서비스 배치 및 실행에 필요한 태그를 선언합니다. 서비스 배치 및 실행에 동적으로 영향을 주는 데 유용합니다. 자세한 내용은 Service Fabric 동적 노드 태그를 참조하세요.
| Type: | System.Collections.Generic.List`1[System.String] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TargetReplicaSetSize
Service Fabric 상태 저장 서비스의 업데이트된 대상 복제본 집합 크기를 지정합니다. 자세한 내용은 StatefulServiceDescription.TargetReplicaSetSize를 참조하세요.
상태 비국적 서비스에 대해 이 매개 변수를 지정하지 마세요.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TimeoutSec
작업의 제한 시간(초)을 지정합니다.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
cmdlet을 실행할 경우 발생하는 일을 표시합니다. cmdlet은 실행되지 않습니다.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
입력
System.Uri
출력
System.Object