New-ServiceFabricApplication

Membuat aplikasi Service Fabric.

Sintaks

New-ServiceFabricApplication
   [-ApplicationName] <Uri>
   [-ApplicationTypeName] <String>
   [-ApplicationTypeVersion] <String>
   [-ApplicationParameter <Hashtable>]
   [-MaximumNodes <Int64>]
   [-MinimumNodes <Int64>]
   [-Metrics <String[]>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Deskripsi

Cmdlet New-ServiceFabricApplication membuat aplikasi Service Fabric dari jenis aplikasi terdaftar. Gunakan cmdlet Register-ServiceFabricApplicationType untuk mendaftarkan jenis aplikasi.

Sebelum Anda melakukan operasi apa pun pada kluster Service Fabric, buat koneksi ke kluster dengan menggunakan cmdlet Connect-ServiceFabricCluster .

Contoh

Contoh 1: Membuat aplikasi

PS C:\> New-ServiceFabricApplication -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeName "PersistentToDoListApp" -ApplicationTypeVersion "1.0"

Perintah ini membuat aplikasi dari jenis PersistentToDoListApp. Aplikasi ini adalah versi 1.0. Jenis dan versi aplikasi berasal dari manifes aplikasi dalam paket aplikasi yang digunakan saat mendaftarkan aplikasi menggunakan cmdlet Register-ServiceFabricApplicationType .

Contoh 2: Membuat aplikasi dengan mengambil alih nilai parameter default dalam manifes aplikasi

PS C:\> New-ServiceFabricApplication -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeName "PersistentToDoListApp" -ApplicationTypeVersion "1.0" -ApplicationParameter @{CustomParameter1='MyValue'; CustomParameter2='MyValue'}

Perintah ini membuat aplikasi jenis PersistentToDoListApp dan versi 1.0 dengan nilai yang ditimpa untuk parameter CustomParameter1 dan CustomParameter2. Nama parameter ini harus ada dalam manifes aplikasi dari paket aplikasi yang digunakan saat mendaftarkan aplikasi menggunakan cmdlet Register-ServiceFabricApplicationType .

Parameter

-ApplicationName

Menentukan Pengidentifikasi Sumber Daya Seragam (URI) dari aplikasi Service Fabric. Cmdlet membuat aplikasi Service Fabric dengan nama yang Anda tentukan.

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

-ApplicationParameter

Menentukan penimpaan untuk parameter aplikasi yang ditentukan dalam manifes aplikasi sebagai pasangan kunci/nilai. Cmdlet membuat aplikasi Service Fabric dari jenis aplikasi dan menggunakan nilai yang ditimpa untuk parameter ini. Parameter yang sedang ditimpa di sini harus ada dalam manifes aplikasi.

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

-ApplicationTypeName

Menentukan nama jenis aplikasi Service Fabric. Cmdlet membuat aplikasi Service Fabric dari jenis aplikasi yang Anda tentukan.

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

-ApplicationTypeVersion

Menentukan versi jenis aplikasi Service Fabric. Cmdlet membuat aplikasi yang memiliki versi yang Anda tentukan.

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

-MaximumNodes

Menentukan jumlah maksimum simpul untuk menempatkan aplikasi. Nilai parameter ini harus berupa bilangan bulat non-negatif. Nilai default adalah 0, yang menunjukkan aplikasi dapat ditempatkan pada sejumlah simpul dalam kluster.

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

-Metrics

Menentukan array metrik. Metrik ini digunakan oleh Service Fabric Cluster Resource Manager untuk mengelola sumber daya dalam kluster. Untuk informasi selengkapnya tentang metrik dan manajemen sumber daya di Service Fabric, lihat Pengenalan Resource Manager Kluster Service Fabric. Setiap metrik dapat mengikuti pola MetricName, NodeReservationCapacity, MaximumNodeCapacity, TotalApplicationCapacity, atau dapat menentukan MetricName dan menggunakan nama parameter NodeReservationCapacity, MaximumNodeCapacity, atau TotalApplicationCapacity diikuti oleh nilai parameter, dan dipisahkan dengan titik dua. Setiap nama parameter:pasangan nilai dapat muncul paling banyak sekali.

  • MetricName. Menentukan nama metrik.
  • NodeReservationCapacity. Menentukan jumlah beban metrik yang dicadangkan pada simpul yang memiliki instans aplikasi ini. Jika MinimumNodes ditentukan, produk dari nilai-nilai ini adalah kapasitas yang dicadangkan dalam kluster untuk aplikasi.
  • MaximumNodeCapacity. Menentukan beban maksimum untuk instans aplikasi ini pada satu simpul. Bahkan jika kapasitas node lebih besar dari nilai ini, Service Fabric membatasi beban total replika anak aplikasi ke nilai ini.
  • TotalApplicationCapacity. Menentukan total kapasitas untuk aplikasi dalam kluster. Service Fabric mencoba membatasi jumlah beban replika anak aplikasi ke nilai ini.

Saat membuat aplikasi, Service Fabric melakukan validasi berikut dan akan gagal perintah jika tidak lulus:

  • NodeReservationCapacity tidak boleh lebih dari MaximumNodeCapacity.

  • Jika parameter MinimumNodes dan metrik NodeReservationCapacity ditentukan, maka produk MinimumNodes dan NodeReservationCapacity tidak boleh lebih dari TotalApplicationCapacity. Untuk informasi selengkapnya, lihat Metrik, Beban, dan Kapasitas Aplikasi

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

-MinimumNodes

Menentukan jumlah minimum node di mana Service Fabric akan memesan kapasitas untuk aplikasi ini, ini tidak berarti bahwa aplikasi dijamin memiliki replika pada semua node tersebut. Nilai parameter ini harus berupa bilangan bulat non-negatif. Nilai default untuk ini adalah nol, yang berarti tidak ada kapasitas yang dicadangkan untuk aplikasi.

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

-TimeoutSec

Menentukan periode waktu habis, dalam detik, untuk operasi.

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

Input

None

Output

System.Object