Bagikan melalui


Get-ServiceFabricApplication

Mendapatkan aplikasi pada kluster Service Fabric.

Sintaks

AllPages (Default)

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

SinglePage

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 maks; 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: Mendapatkan 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 di 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 cocok ke 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 aplikasi 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.

Properti parameter

Jenis:ApplicationDefinitionKindFilter
Nilai default:None
Nilai yang diterima:Default, ServiceFabricApplicationDescription, Compose, MeshApplicationDescription, All
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

-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.

Properti parameter

Jenis:Uri
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:0
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa: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.

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:True
Nilai dari argumen yang tersisa: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 cocok dengan satu pesan. Halaman digunakan untuk memperhitungkan 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.

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

-ExcludeApplicationParameters

Menentukan apakah parameter aplikasi akan dikecualikan dari hasilnya.

Properti parameter

Jenis:SwitchParameter
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

-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.

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

SinglePage
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa: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.

Properti parameter

Jenis:Int64
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

SinglePage
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.

Input

System.Uri

System.String

Output

System.Object