Get-ServiceFabricApplication

  • Başvuru
Modül:
ServiceFabric

Service Fabric kümesindeki uygulamaları alır.

Sözdizimi

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

Description

Get-ServiceFabricApplication cmdlet'i, Service Fabric kümesindeki uygulamaları alır. Varsayılan olarak, maksimum ileti boyutu yapılandırmasından bağımsız olarak, bu sorgu tarafından döndürülebilecek sorgu sonuçlarının sayısında herhangi bir kısıtlama yoktur; Rest veya C# eşdeğer çağrılarından farklı olarak, bu sorgu disk belleğine alınmış bir sorgu olsa da, bu sorgunun varsayılan davranışı döndürülen tüm sayfalarda saydam bir şekilde döngü yapmaktır. GetSinglePage seçeneği bu sorguyu tek bir sayfa döndürecek şekilde yapılandırıyor.

Service Fabric kümesinde herhangi bir işlem yapmadan önce Connect-ServiceFabricCluster cmdlet'ini kullanarak kümeyle bağlantı kurun.

Örnekler

Örnek 1: Tüm uygulamaları alma

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     : {}

Bu komut kümedeki tüm uygulamaları alır.

Örnek 2: Uygulamayı ada göre alma

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

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

Bu komut, fabric:/samples/PQueueApp1 adlı belirli uygulamayı alır.

Örnek 3: Uygulamayı tür adına göre alma

PS C:\>Get-ServiceFabricApplication -ApplicationTypeName PersistentQueueApp

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

Bu komut, tür adı PersistentQueueApp olan Service Fabric uygulamalarını alır.

Örnek 4: Tanım türüne göre uygulama alma

PS C:\>Get-ServiceFabricApplication -ApplicationDefinitionKindFilter Compose

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

Bu komut, Service Fabric uygulama açıklaması tarafından tanımlanan Service Fabric uygulamalarını alır.

Örnek 5: Maksimum sonuçlarla uygulama alma

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

Bu komut, kümedeki bir sayfaya sığan tüm Service Fabric uygulamalarını alır. Kümede daha fazla uygulama olsa da, MaxResults parametresi tarafından yapılandırıldığı şekilde yalnızca iki sonuç döndürülür. Sayfaya sığmayan sonuçlar olduğundan, sonraki sayfaların varlığını gösteren bir devamlılık belirteci değeri döndürülür.

Örnek 6: Devamlılık belirteci ile uygulama alma

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:

Bu komut, tek bir sayfaya sığan sağlanan devamlılık belirtecine uyan Service Fabric uygulamalarını alır. Bu sorguya sağlanan devamlılık belirteci, yukarıdaki örnekten döndürülen belirteçle aynıdır. "Ayrıntılı" seçeneği devam belirteci göstermez ve artık kullanılabilir sayfa kalmadığını gösterir.

Örnek 7: Uygulama parametrelerini dışlarken uygulamayı ada göre alma

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     : {}

Bu komut, sağlanan uygulama adıyla eşleşen Service Fabric uygulamasını alır. Örnek 5'ten görüldüğü gibi, bu uygulamanın uygulama parametreleri vardır, ancak "ExcludeApplicationParameters" bayrağı nedeniyle döndürülen sonuçlardan dışlanır

Parametreler

-ApplicationDefinitionKindFilter

Uygulamanın nasıl tanımlandığına bağlı olarak ApplicationDefinitionKindFilter filtresini belirtir. Değer , ApplicationDefinitionKindFilter üyelerindeki üyelerden veya bit tabanlı işlemlerden alınabilir. Yalnızca filtreyle eşleşen uygulamalar döndürülür. ApplicationName, ApplicationTypeName veya ApplicationDefinitionKindFilter'dan en fazla biri belirtilebilir. Filtre belirtilmezse, tüm uygulamalar döndürülür.

Tür:ApplicationDefinitionKindFilter
Kabul edilen değerler:Default, ServiceFabricApplicationDescription, Compose, MeshApplicationDescription, All
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ApplicationName

Service Fabric uygulamasının Tekdüzen Kaynak Tanımlayıcısını (URI) belirtir. Cmdlet, belirtilen URI'ye sahip uygulamayı alır. ApplicationName, ApplicationTypeName veya ApplicationDefinitionKindFilter'dan en fazla biri belirtilebilir. Filtre belirtilmezse, tüm uygulamalar döndürülür.

Tür:Uri
Position:0
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ApplicationTypeName

Sorgu yapılacak uygulamaları filtrelemek için kullanılan uygulama türü adını belirtir. ApplicationName, ApplicationTypeName veya ApplicationDefinitionKindFilter'dan en fazla biri belirtilebilir. Filtre belirtilmezse, tüm uygulamalar döndürülür.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ContinuationToken

Sorgu sonuçlarının sonraki sayfasını almak için kullanılabilecek devamlılık belirtecini belirtir.

Sağlanan filtrelere çok fazla sonuç uyarsa, bunlar tek bir iletiye sığmayabilir. Sayfalama, döndürülen sonuç koleksiyonunu ayrı sayfalara bölerek bunu hesaba katmak için kullanılır. Devamlılık belirteci, önceki sayfanın nerede kaldığını bilmek için kullanılır ve yalnızca sorgunun kendisine anlam taşır. Bu değer bu sorgu çalıştırılarak oluşturulmalıdır ve sonraki sayfaları almak için bir sonraki sorgu isteğine geçirilebilir. Sonucun bir parçası olarak null olmayan bir devamlılık belirteci değeri yalnızca sonraki bir sayfa varsa döndürülür. Bu değer -GetSinglePage seçeneği olmadan sağlanırsa, sorgu devamlılık belirteci değerinden başlayarak tüm sayfaları döndürür.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ExcludeApplicationParameters

Uygulama parametrelerinin sonuçtan dışlanıp dışlanmayacağını belirtir.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-GetSinglePage

Sorgunun devamlılık belirteci değeri olan bir sorgu sonuçları sayfası mı döndüreceğini yoksa tüm sayfaların tek bir sonuç listesinde mi birleştirileceğini belirtir. Bu seçenek belirlenirse, sonraki sayfaları denetlemek sorguyu çağıranın sorumluluğundadır.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-MaxResults

Sayfa başına döndürülebilecek en fazla sonuç öğesi sayısını belirtir. Bu, döndürülen sonuç sayısı için alt sınırı değil üst sınırı tanımlar. Örneğin, sayfa yapılandırmada tanımlanan maksimum ileti boyutu kısıtlamalarına göre en fazla 1000 döndürülen öğeye uyuyorsa ve MaxResults değeri 2000 olarak ayarlandıysa, 2000 sonuç öğesi sorgu açıklamasıyla eşleşse bile yalnızca 1000 sonuç döndürülür. Bu değer GetSinglePage bayrağının seçilmesini gerektirir; yoksayılır.

Tür:Int64
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-TimeoutSec

İşlemin zaman aşımı süresini saniye cinsinden belirtir.

Tür:Int32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

System.Uri

System.String

Çıkışlar

System.Object