New-ServiceFabricApplication

  • 참조
모듈:
ServiceFabric

Service Fabric 애플리케이션을 만듭니다.

Syntax

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 애플리케이션을 만듭니다.

Type:Uri
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationParameter

애플리케이션 매니페스트에 키/값 쌍으로 정의된 애플리케이션 매개 변수에 대한 재정의를 지정합니다. cmdlet은 애플리케이션 유형의 Service Fabric 애플리케이션을 만들고 이러한 매개 변수에 대해 재정의된 값을 사용합니다. 여기서 재정의되는 매개 변수는 애플리케이션 매니페스트에 있어야 합니다.

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationTypeName

Service Fabric 애플리케이션 유형의 이름을 지정합니다. cmdlet은 지정한 애플리케이션 유형의 Service Fabric 애플리케이션을 만듭니다.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationTypeVersion

Service Fabric 애플리케이션 유형의 버전을 지정합니다. cmdlet은 지정한 버전이 있는 애플리케이션을 만듭니다.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MaximumNodes

애플리케이션을 배치할 최대 노드 수를 지정합니다. 이 매개 변수의 값은 음수가 아닌 정수여야 합니다. 기본값은 0으로, 클러스터의 노드 수에 애플리케이션을 배치할 수 있음을 나타냅니다.

Type:Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Metrics

메트릭 배열을 지정합니다. 이러한 메트릭은 Service Fabric 클러스터 Resource Manager 사용하여 클러스터의 리소스를 관리합니다. Service Fabric의 메트릭 및 리소스 관리에 대한 자세한 내용은 Service Fabric 클러스터 Resource Manager 소개를 참조하세요. 각 메트릭은 MetricName, NodeReservationCapacity, MaximumNodeCapacity, TotalApplicationCapacity 패턴을 따르거나 MetricName을 지정하고 매개 변수 이름 NodeReservationCapacity, MaximumNodeCapacity 또는 TotalApplicationCapacity 뒤에 매개 변수 값을 사용하고 콜론으로 구분할 수 있습니다. 각 매개 변수 이름:값 쌍은 한 번에 나타날 수 있습니다.

  • MetricName. 메트릭의 이름을 지정합니다.
  • NodeReservationCapacity. 이 애플리케이션의 인스턴스가 있는 노드에서 예약된 메트릭 로드의 양을 지정합니다. MinimumNodes가 지정된 경우 이러한 값의 곱은 애플리케이션에 대해 클러스터에 예약된 용량입니다.
  • MaximumNodeCapacity. 단일 노드에서 이 애플리케이션의 인스턴스에 대한 최대 부하를 지정합니다. 노드의 용량이 이 값보다 크더라도 Service Fabric은 애플리케이션의 자식 복제본의 총 부하를 이 값으로 제한합니다.
  • TotalApplicationCapacity. 클러스터의 애플리케이션에 대한 총 용량을 지정합니다. Service Fabric은 애플리케이션의 자식 복제본 로드 합계를 이 값으로 제한하려고 시도합니다.

애플리케이션을 만드는 동안 Service Fabric은 다음 유효성 검사를 수행하고 통과하지 못하면 명령이 실패합니다.

  • NodeReservationCapacity는 MaximumNodeCapacity를 초과하면 안 됩니다.

  • MinimumNodes 매개 변수와 NodeReservationCapacity 메트릭이 모두 지정된 경우 MinimumNodes 및 NodeReservationCapacity의 곱은 TotalApplicationCapacity를 초과하면 안 됩니다. 자세한 내용은 애플리케이션 메트릭, 로드 및 용량을 참조하세요.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MinimumNodes

Service Fabric이 이 애플리케이션에 대한 용량을 예약하는 최소 노드 수를 지정합니다. 그렇다고 해서 애플리케이션이 모든 노드에 복제본을 보유하도록 보장되는 것은 아닙니다. 이 매개 변수의 값은 음수가 아닌 정수여야 합니다. 기본값은 0입니다. 즉, 애플리케이션에 예약된 용량이 없습니다.

Type:Int64
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

입력

None

출력

System.Object