New-ServiceFabricApplication
Membuat aplikasi Service Fabric.
Sintaks
Default (Default)
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 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 penggantian 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.
Properti parameter
| Jenis: | Uri |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | 0 |
| Wajib: | True |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | 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.
Properti parameter
| Jenis: | Hashtable |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-ApplicationTypeName
Menentukan nama jenis aplikasi Service Fabric. Cmdlet membuat aplikasi Service Fabric dari jenis aplikasi yang Anda tentukan.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | 1 |
| Wajib: | True |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-ApplicationTypeVersion
Menentukan versi jenis aplikasi Service Fabric. Cmdlet membuat aplikasi yang memiliki versi yang Anda tentukan.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | 2 |
| Wajib: | True |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | 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.
Properti parameter
| Jenis: | Int64 |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | 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 parameter pasangan nama: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 Aplikasi, Beban, dan Kapasitas
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-MinimumNodes
Menentukan jumlah minimum simpul 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.
Properti parameter
| Jenis: | Int64 |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-TimeoutSec
Menentukan periode waktu habis, dalam detik, untuk operasi.
Properti parameter
| Jenis: | Int32 |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
CommonParameters
Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.