Get-ServiceFabricApplication

Modul:

ServiceFabric

Mendapatkan aplikasi pada kluster Service Fabric.

Sintaks

Get-ServiceFabricApplication
   [[-ApplicationName] <Uri>]
   [-ApplicationTypeName <String>]
   [-ExcludeApplicationParameters]
   [-ContinuationToken <String>]
   [-ApplicationDefinitionKindFilter <ApplicationDefinitionKindFilter>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Get-ServiceFabricApplication
   [[-ApplicationName] <Uri>]
   [-ApplicationTypeName <String>]
   [-ExcludeApplicationParameters]
   [-GetSinglePage]
   [-ContinuationToken <String>]
   [-MaxResults <Int64>]
   [-ApplicationDefinitionKindFilter <ApplicationDefinitionKindFilter>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Deskripsi

Cmdlet Get-ServiceFabricApplication mendapatkan aplikasi pada kluster Service Fabric. Secara default, tidak ada batasan jumlah hasil kueri yang dapat dikembalikan oleh kueri ini, terlepas dari konfigurasi ukuran pesan maksimum; meskipun ini adalah kueri halaman, tidak seperti panggilan setara REST atau C#, perilaku default kueri ini adalah mengulangi semua halaman yang dikembalikan secara transparan. Opsi GetSinglePage mengonfigurasi kueri ini untuk mengembalikan satu halaman.

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

Contoh

Contoh 1: Dapatkan semua aplikasi

PS C:\> Get-ServiceFabricApplication

ApplicationName           : fabric:/samples/CalculatorApp
ApplicationTypeName       : CalculatorApp
ApplicationTypeVersion    : 1.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

ApplicationName           : fabric:/samples/CalculatorAppWithAppParameters
ApplicationTypeName       : CalculatorApp
ApplicationTypeVersion    : 2.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : { "ServiceInstanceCount" = "4" }

ApplicationName           : fabric:/samples/PQueueApp1
ApplicationTypeName       : PersistentQueueApp
ApplicationTypeVersion    : 1.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

ApplicationName           : fabric:/VQueueApp1
ApplicationTypeName       : Compose_0
ApplicationTypeVersion    : v0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : Compose
ApplicationParameters     : {}

Perintah ini mendapatkan semua aplikasi dalam kluster.

Contoh 2: Dapatkan aplikasi berdasarkan nama

PS C:\> Get-ServiceFabricApplication -ApplicationName fabric:/samples/PQueueApp1

ApplicationName           : fabric:/samples/PQueueApp1
ApplicationTypeName       : PersistentQueueApp
ApplicationTypeVersion    : 1.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

Perintah ini mendapatkan aplikasi tertentu dengan nama fabric:/samples/PQueueApp1.

Contoh 3: Dapatkan aplikasi berdasarkan nama jenis

PS C:\>Get-ServiceFabricApplication -ApplicationTypeName PersistentQueueApp

ApplicationName           : fabric:/samples/PQueueApp1
ApplicationTypeName       : PersistentQueueApp
ApplicationTypeVersion    : 1.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

Perintah ini mendapatkan aplikasi Service Fabric yang nama jenisnya adalah PersistentQueueApp.

Contoh 4: Dapatkan aplikasi berdasarkan jenis definisi

PS C:\>Get-ServiceFabricApplication -ApplicationDefinitionKindFilter Compose

ApplicationName           : fabric:/VQueueApp1
ApplicationTypeName       : Compose_0
ApplicationTypeVersion    : v0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : Compose
ApplicationParameters     : {}

Perintah ini mendapatkan aplikasi Service Fabric yang ditentukan oleh deskripsi aplikasi Service Fabric.

Contoh 5: Dapatkan aplikasi dengan hasil maksimal

PS C:\>Get-ServiceFabricApplication -MaxResults 2 -GetSinglePage -Verbose

ApplicationName           : fabric:/samples/CalculatorApp
ApplicationTypeName       : CalculatorApp
ApplicationTypeVersion    : 1.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

ApplicationName           : fabric:/samples/CalculatorAppWithAppParameters
ApplicationTypeName       : CalculatorApp
ApplicationTypeVersion    : 2.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : "ServiceInstanceCount" = "4"
                            

VERBOSE: Continuation Token: fabric:/samples/CalculatorAppWithAppParameters

Perintah ini mendapatkan semua aplikasi Service Fabric dalam kluster yang sesuai dengan halaman. Meskipun ada lebih banyak aplikasi dalam kluster, hanya dua hasil yang dikembalikan seperti yang dikonfigurasi oleh parameter MaxResults. Karena ada hasil yang tidak sesuai dengan halaman, nilai token kelanjutan dikembalikan, menunjukkan adanya halaman berikutnya.

Contoh 6: Dapatkan aplikasi dengan token kelanjutan

PS C:\>Get-ServiceFabricApplication -ContinuationToken fabric:/samples/CalculatorAppWithAppParameters -GetSinglePage -Verbose

ApplicationName           : fabric:/samples/PQueueApp1
ApplicationTypeName       : PersistentQueueApp
ApplicationTypeVersion    : 1.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

ApplicationName           : fabric:/VQueueApp1
ApplicationTypeName       : Compose_0
ApplicationTypeVersion    : v0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : Compose
ApplicationParameters     : {}

VERBOSE: Continuation Token:

Perintah ini mendapatkan aplikasi Service Fabric yang menghormati token kelanjutan yang disediakan yang sesuai dengan satu halaman. Token kelanjutan yang disediakan untuk kueri ini adalah token yang sama yang dikembalikan dari contoh di atas. Opsi "Verbose" tidak menunjukkan token kelanjutan, yang melambangkan bahwa tidak ada lagi halaman yang tersedia.

Contoh 7: Dapatkan aplikasi berdasarkan nama sambil mengecualikan parameter aplikasi

PS C:\>Get-ServiceFabricApplication -ApplicationName fabric:/samples/CalculatorAppWithAppParameters -ExcludeApplicationParameters

ApplicationName           : fabric:/samples/CalculatorAppWithAppParameters
ApplicationTypeName       : CalculatorApp
ApplicationTypeVersion    : 2.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

Perintah ini mendapatkan aplikasi Service Fabric yang cocok dengan nama aplikasi yang disediakan. Seperti yang terlihat dari contoh 5, aplikasi ini memiliki parameter aplikasi, tetapi dikecualikan dari hasil yang dikembalikan karena bendera "ExcludeApplicationParameters"

Parameter

-ApplicationDefinitionKindFilter

Menentukan filter untuk ApplicationDefinitionKindFilter berdasarkan bagaimana aplikasi ditentukan. Nilai dapat diperoleh dari anggota atau operasi bitwise pada anggota ApplicationDefinitionKindFilter. Hanya partisi yang cocok dengan filter yang dikembalikan. Paling banyak salah satu ApplicationName, ApplicationTypeName, atau ApplicationDefinitionKindFilter dapat ditentukan. Jika tidak ada filter yang ditentukan, semua aplikasi dikembalikan.

Type:	ApplicationDefinitionKindFilter
Accepted values:	Default, ServiceFabricApplicationDescription, Compose, MeshApplicationDescription, All
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationName

Menentukan Pengidentifikasi Sumber Daya Seragam (URI) dari aplikasi Service Fabric. Cmdlet mendapatkan aplikasi yang memiliki URI yang ditentukan. Paling banyak salah satu ApplicationName, ApplicationTypeName, atau ApplicationDefinitionKindFilter dapat ditentukan. Jika tidak ada filter yang ditentukan, semua aplikasi dikembalikan.

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

-ApplicationTypeName

Menentukan nama jenis aplikasi yang digunakan untuk memfilter aplikasi yang akan dikueri. Paling banyak salah satu ApplicationName, ApplicationTypeName, atau ApplicationDefinitionKindFilter dapat ditentukan. Jika tidak ada filter yang ditentukan, semua aplikasi dikembalikan.

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

-ContinuationToken

Menentukan token kelanjutan yang dapat digunakan untuk mengambil halaman hasil kueri berikutnya.

Jika terlalu banyak hasil menghormati filter yang disediakan, hasil tersebut mungkin tidak sesuai dengan satu pesan. Halaman digunakan untuk mempertangungjawabkan hal ini dengan memisahkan kumpulan hasil yang dikembalikan menjadi halaman terpisah. Token kelanjutan digunakan untuk mengetahui di mana halaman sebelumnya ditinggalkan, hanya membawa signifikansi ke kueri itu sendiri. Nilai ini harus dihasilkan dari menjalankan kueri ini, dan dapat diteruskan ke permintaan kueri berikutnya untuk mendapatkan halaman berikutnya. Nilai token kelanjutan non-null dikembalikan sebagai bagian dari hasil hanya jika ada halaman berikutnya. Jika nilai ini disediakan tanpa opsi -GetSinglePage, maka kueri akan mengembalikan semua halaman mulai dari nilai token kelanjutan.

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

-ExcludeApplicationParameters

Menentukan apakah parameter aplikasi akan dikecualikan dari hasilnya.

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

-GetSinglePage

Menentukan apakah kueri akan mengembalikan satu halaman hasil kueri dengan nilai token kelanjutan, atau semua halaman digabungkan ke dalam satu daftar hasil. Jika opsi ini dipilih, maka pemanggil kueri bertanggung jawab untuk memeriksa halaman berikutnya.

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

-MaxResults

Menentukan jumlah maksimum item hasil yang dapat dikembalikan per halaman. Ini mendefinisikan batas atas untuk jumlah hasil yang dikembalikan, bukan minimum. Misalnya, jika halaman cocok dengan paling banyak 1000 item yang dikembalikan sesuai dengan batasan ukuran pesan maks yang ditentukan dalam konfigurasi, dan nilai MaxResults diatur ke 2000, maka hanya 1000 hasil yang dikembalikan, bahkan jika 2000 item hasil cocok dengan deskripsi kueri. Nilai ini memerlukan pilihan bendera GetSinglePage; itu akan diabaikan jika tidak.

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

System.Uri

System.String

Output

System.Object

Link Terkait

• Connect-ServiceFabricCluster
• Get-ServiceFabricClusterConnection
• New-ServiceFabricApplication
• Hapus-AplikasiServiceFabric