New-ServiceFabricApplication
Service Fabric 애플리케이션을 만듭니다.
구문
New-ServiceFabricApplication
[-ApplicationName] <Uri>
[-ApplicationTypeName] <String>
[-ApplicationTypeVersion] <String>
[-ApplicationParameter <Hashtable>]
[-MaximumNodes <Int64>]
[-MinimumNodes <Int64>]
[-Metrics <String[]>]
[-TimeoutSec <Int32>]
[<CommonParameters>] Description
New-ServiceFabricApplication cmdlet은 등록된 애플리케이션 유형의 Service Fabric 애플리케이션을 만듭니다. Register-ServiceFabricApplicationType cmdlet을 사용하여 애플리케이션 유형을 등록합니다.
Service Fabric 클러스터에서 작업을 수행하기 전에 Connect-ServiceFabricCluster cmdlet을 사용하여 클러스터에 대한 연결을 설정합니다.
예제
예제 1: 애플리케이션 만들기
PS C:\> New-ServiceFabricApplication -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeName "PersistentToDoListApp" -ApplicationTypeVersion "1.0"이 명령은 PersistentToDoListApp 형식의 애플리케이션을 만듭니다. 애플리케이션은 버전 1.0입니다. 애플리케이션 유형 및 버전은 Register-ServiceFabricApplicationType cmdlet을 사용하여 애플리케이션을 등록할 때 사용된 애플리케이션 패키지의 애플리케이션 매니페스트에서 제공됩니다.
예제 2: 애플리케이션 매니페스트에서 기본 매개 변수 값을 재정의하여 애플리케이션 만들기
PS C:\> New-ServiceFabricApplication -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeName "PersistentToDoListApp" -ApplicationTypeVersion "1.0" -ApplicationParameter @{CustomParameter1='MyValue'; CustomParameter2='MyValue'}이 명령은 CustomParameter1 및 CustomParameter2 매개 변수에 대해 재정의된 값을 사용하여 PersistentToDoListApp 및 버전 1.0 형식의 애플리케이션을 만듭니다. 이러한 매개 변수 이름은 Register-ServiceFabricApplicationType cmdlet을 사용하여 애플리케이션을 등록할 때 사용된 애플리케이션 패키지의 애플리케이션 매니페스트에 있어야 합니다.
매개 변수
-ApplicationName
Service Fabric 애플리케이션의 URI(Uniform Resource Identifier)를 지정합니다. cmdlet은 지정한 이름으로 Service Fabric 애플리케이션을 만듭니다.
| 형식: | Uri |
| Position: | 0 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ApplicationParameter
애플리케이션 매니페스트에 정의된 애플리케이션 매개 변수에 대한 재정의를 키/값 쌍으로 지정합니다. cmdlet은 애플리케이션 유형의 Service Fabric 애플리케이션을 만들고 이러한 매개 변수에 대해 재정의된 값을 사용합니다. 여기서 재정의되는 매개 변수는 애플리케이션 매니페스트에 있어야 합니다.
| 형식: | Hashtable |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ApplicationTypeName
Service Fabric 애플리케이션 유형의 이름을 지정합니다. cmdlet은 지정한 애플리케이션 유형의 Service Fabric 애플리케이션을 만듭니다.
| 형식: | String |
| Position: | 1 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ApplicationTypeVersion
Service Fabric 애플리케이션 유형의 버전을 지정합니다. cmdlet은 지정한 버전이 있는 애플리케이션을 만듭니다.
| 형식: | String |
| Position: | 2 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-MaximumNodes
애플리케이션을 배치할 최대 노드 수를 지정합니다. 이 매개 변수의 값은 음수가 아닌 정수여야 합니다. 기본값은 0으로, 클러스터의 노드 수에 애플리케이션을 배치할 수 있음을 나타냅니다.
| 형식: | Int64 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Metrics
메트릭 배열을 지정합니다. 이러한 메트릭은 Service Fabric 클러스터 리소스 관리자에서 클러스터의 리소스를 관리하는 데 사용됩니다. Service Fabric의 메트릭 및 리소스 관리에 대한 자세한 내용은 Service Fabric Cluster Resource Manager 소개참조하세요.
각 메트릭은 MetricName, NodeReservationCapacity, MaximumNodeCapacity, TotalApplicationCapacity 패턴을 따르거나 MetricName을 지정하고 NodeReservationCapacity,
- MetricName. 메트릭의 이름을 지정합니다.
- NodeReservationCapacity. 이 애플리케이션의 인스턴스가 있는 노드에서 예약된 메트릭 로드의 양을 지정합니다. MinimumNodes 지정된 경우 이러한 값의 곱은 애플리케이션용 클러스터에서 예약된 용량입니다.
- MaximumNodeCapacity. 단일 노드에서 이 애플리케이션의 인스턴스에 대한 최대 부하를 지정합니다. 노드 용량이 이 값보다 크더라도 Service Fabric은 애플리케이션의 자식 복제본의 총 부하를 이 값으로 제한합니다.
- TotalApplicationCapacity. 클러스터의 애플리케이션에 대한 총 용량을 지정합니다. Service Fabric은 애플리케이션의 자식 복제본 로드 합계를 이 값으로 제한하려고 시도합니다.
애플리케이션을 만드는 동안 Service Fabric은 다음 유효성 검사를 수행하고 전달하지 않으면 명령이 실패합니다.
NodeReservationCapacity는 MaximumNodeCapacity를 초과하면 안 됩니다.
MinimumNodes 매개 변수와 NodeReservationCapacity 메트릭이 모두 지정된 경우 MinimumNodes NodeReservationCapacity의 곱은 TotalApplicationCapacity를 초과하지 않아야 합니다. 자세한 내용은 애플리케이션 메트릭, 로드 및 용량 참조하세요.
| 형식: | String[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-MinimumNodes
Service Fabric이 이 애플리케이션에 대한 용량을 예약하는 노드의 최소 수를 지정합니다. 그렇다고 해서 애플리케이션이 모든 노드에 복제본을 보유하도록 보장되는 것은 아닙니다. 이 매개 변수의 값은 음수가 아닌 정수여야 합니다. 기본값은 0입니다. 즉, 애플리케이션에 예약된 용량이 없습니다.
| 형식: | Int64 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-TimeoutSec
작업의 제한 시간(초)을 지정합니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
입력
None
출력
System.Object