Aracılığıyla paylaş

Get-ServiceFabricDeployedApplication

  • Başvuru
Modül:
ServiceFabric

Belirtilen düğümdeki Service Fabric uygulamalarını alır.

Syntax

Get-ServiceFabricDeployedApplication
   [-NodeName] <String>
   [[-ApplicationName] <Uri>]
   [-UsePaging]
   [-GetSinglePage]
   [-IncludeHealthState]
   [-MaxResults <Int64>]
   [-ContinuationToken <String>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]
Get-ServiceFabricDeployedApplication
   [-NodeName] <String>
   [[-ApplicationName] <Uri>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Description

Get-ServiceFabricDeployedApplication cmdlet'i, Service Fabric uygulamalarının belirtilen düğümde dağıtıldığını alır.

Service Fabric, dağıtılan her uygulama için düğümde iş, günlük ve geçici dizinler oluşturur. Dizin adları uygulama kimliğini içerdiğinden, dizin adları tahmin edilemez. DeployedApplicationStatus Etkin olduğunda, Get-ServiceFabricDeployedApplication, WorkDirectory, LogDirectory ve TempDirectory dönüş değerlerinde dizin adlarını döndürür. DeployedApplicationStatus İndiriliyor olduğunda, WorkDirectory, LogDirectory ve TempDirectory değerleri null olur.

Dağıtılan uygulama hizmetleri kalıcı verilerini WorkDirectory'de depolar. Hata ayıklama veya tanılama amacıyla farklı bir uygulama veya işlemin WorkDirectory konumunu bilmesi gerekebilir.

Dağıtılan uygulama hizmetleri, günlüklerini Service Fabric tarafından oluşturulan LogDirectory'de depolamalıdır. Günlük dosyalarının özel bir yükleyicisinin konumu bilmesi gerekebilir. LogDirectory'nin konumu hem tanılama amacıyla hem de belirli bir düğümdeki bir uygulama beklendiği gibi çalışmadığında gerekli olabilir.

Varsayılan olarak, bu sorgu maksimum ileti boyutu yapılandırmasıyla sınırlı sayıda sonuç döndürür. SDK'lar ve kümeler sürüm 6.1 veya üzeri, bu kısıtlamayı kaldıran disk belleği işlevselliğini destekler; yeni davranış, maksimum ileti boyutu yapılandırmasından bağımsız olarak sonuçları döndürmek olacaktır çünkü bu sorgu döndürülen tüm sayfalarda saydam bir şekilde döngü oluşturur. Sayfalama ve diğer yeni işlevleri kullanmak için "UsePagedAPI" parametre kümesine bakın. Yeni filtrelerin seçilmesi, arka planda sayfalama kullanmak için sorguya işaret eder. Aksi takdirde, sayfalanmış sorgulamayı kabul etmek için "UsePaging" seçeneğini belirleyin.

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

Örnekler

Örnek 1: "fabric:/samples/CalcApp2" uygulamasını alma

PS C:\> Get-ServiceFabricDeployedApplication -NodeName "VIPULM4-RK01-BD01" -ApplicationName fabric:/samples/CalcApp2

ApplicationName           : fabric:/samples/CalcApp2
ApplicationTypeName       : CalculatorApp
DeployedApplicationStatus : Active
WorkDirectory             : D:\ServiceFabric\Data\VIPULM4-RK01-BD01\Fabric\work\Applications\CalculatorApp_App5\work
LogDirectory              : D:\ServiceFabric\Data\VIPULM4-RK01-BD01\Fabric\work\Applications\CalculatorApp_App5\log
TempDirectory             : D:\ServiceFabric\Data\VIPULM4-RK01-BD01\Fabric\work\Applications\CalculatorApp_App5\temp
HealthState               : Unknown

Bu komut, dağıtılan uygulamaları döndürür. Bu örnekte, DeployedApplicationStatus Etkindir ve bu nedenle Get-ServiceFabricDeployedApplication, WorkDirectory, LogDirectory ve TempDirectory dönüş değerlerinde dizin adlarını döndürür.

Örnek 2: "fabric:/samples/VQueueApp2" uygulamasını alma

PS C:\> Get-ServiceFabricDeployedApplication -NodeName VIPULM4-RK01-BD01 fabric:/samples/VQueueApp2

ApplicationName           : fabric:/samples/VQueueApp2
ApplicationTypeName       : VolatileQueueApp
DeployedApplicationStatus : Downloading
HealthState               : Unknown

Bu komut, dağıtılan uygulamaları döndürür. Bu örnekte, DeployedApplicationStatus İndiriliyor şeklindedir ve bu nedenle komut WorkDirectory, LogDirectory ve TempDirectory için null değerlerini döndürür.

Örnek 3: Maksimum sonuç içeren uygulamaları alma

PS C:\>Get-ServiceFabricDeployedApplication -NodeName _Node_1 -MaxResults 2 -GetSinglePage -Verbose

ApplicationName           : fabric:/samples/CalculatorApp
ApplicationTypeName       : CalculatorApp
DeployedApplicationStatus : Active
WorkDirectory             : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\work
LogDirectory              : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\log
TempDirectory             : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\temp
HealthState               : Unknown

ApplicationName           : fabric:/samples/PQueueApp1
ApplicationTypeName       : PersistentQueueApp
DeployedApplicationStatus : Active
WorkDirectory             : C:\SfDevCluster\Data\_App\_Node_1\PersistentQueueApp_App1\work
LogDirectory              : C:\SfDevCluster\Data\_App\_Node_1\PersistentQueueApp_App1\log
TempDirectory             : C:\SfDevCluster\Data\_App\_Node_1\PersistentQueueApp_App1\temp
HealthState               : Unknown

VERBOSE: Continuation Token: fabric:/samples/PQueueApp1

Bu komut, bir sayfaya sığan kümedeki sağlanan düğümde dağıtılan tüm Service Fabric uygulamalarını alır. Sayfanın boyutu, MaxResults parametresi tarafından yapılandırıldığı gibi iki öğeyle daha sınırlıdır. "GetSinglePage" seçeneğini seçtiğimiz için bu sorgu yalnızca bir sonuç sayfası döndürür. MaxResults bu seçenek olmadan kullanılamaz. "Ayrıntılı" seçildiğinde döndürülen devamlılık belirteci değeri yazdırılır. Bu değer, sonuçların sonraki sayfasını almak için sonraki sorguda kullanılabilir. Döndürülen sonuçları kaydederek ve "ContinuationToken" özelliğine erişerek de döndürülen devamlılık belirtecini erişebilirsiniz. "ContinuationToken" özelliği null, döndürülen bir devamlılık belirteci yok.

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

PS C:\>Get-ServiceFabricDeployedApplication -NodeName _Node_1 -ContinuationToken fabric:/samples/PQueueApp1 -UsePaging

ApplicationName           : fabric:/samples/VQueueApp1
ApplicationTypeName       : VolatileQueueApp
DeployedApplicationStatus : Active
WorkDirectory             : C:\SfDevCluster\Data\_App\_Node_1\VolatileQueueApp_App2\work
LogDirectory              : C:\SfDevCluster\Data\_App\_Node_1\VolatileQueueApp_App2\log
TempDirectory             : C:\SfDevCluster\Data\_App\_Node_1\VolatileQueueApp_App2\temp
HealthState               : Unknown

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. Bu örnek kümede, devamlılık belirtecini dikkate alan tek bir öğe vardır. Düğümde sağlanan devamlılık belirtecine uyan ve bir sonuç sayfasına sığmayacak kadar çok uygulama varsa, bu sorgu yapılandırması döndürülen tüm sayfaların bir derlemesini döndürür ve bunlar arasında saydam bir döngü oluşturur; sorgu daha sonra tüm sonuçların vektörünü döndürür. Yalnızca bir sonuç sayfası almak için "GetSinglePage" seçeneğini belirleyin.

Örnek 5: Sistem durumuyla uygulama alma

PS C:\>Get-ServiceFabricDeployedApplication -NodeName _Node_1 -ApplicationName fabric:/samples/CalculatorApp -IncludeHealthState

ApplicationName           : fabric:/samples/CalculatorApp
ApplicationTypeName       : CalculatorApp
DeployedApplicationStatus : Active
WorkDirectory             : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\work
LogDirectory              : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\log
TempDirectory             : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\temp
HealthState               : Ok

Bu komut, sağlanan uygulama adıyla eşleşen ve sistem durumunu içeren Service Fabric uygulamasını alır.

Parametreler

-ApplicationName

Service Fabric uygulamasının Tekdüzen Kaynak Tanımlayıcısını (URI) belirtir. cmdlet'i, belirtilen uygulama adıyla eşleşen dağıtılan uygulamayı alır. Bu sorgu tam olarak eşleşmektedir. Örneğin, URI dokusu:/Uygulama fabric:/App1 ile eşleşmez. Uygulama adı sağlanırsa en fazla bir sonuç döndürülür. Sağlanan uygulama adı düğümdeki herhangi bir uygulamayla eşleşmiyorsa sorgu null döndürür.

Type:Uri
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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. Disk belleği, döndürülen sonuç koleksiyonunu ayrı sayfalara bölerek bunu hesaba katmak için kullanılır. Devam 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şlayan tüm sayfaları döndürür.

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

-GetSinglePage

Sorgunun devamlılık belirteci değeriyle 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.

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

-IncludeHealthState

Sorgunun dağıtılan uygulamaların sistem durumunu döndüreceğini belirtir. Bu parametre belirtilmezse, döndürülen sistem durumu "Bilinmiyor" olur. Seçildiğinde, sonuçlar birleştirilmeden önce sorgu düğüme ve sistem durumu sistemi hizmetine paralel olarak gider. Sonuç olarak, sorgu daha pahalıdır ve daha uzun sürebilir.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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, sorgu açıklamasıyla eşleşen 2000 sonuç öğesi olsa bile yalnızca 1000 sonuç döndürülür.

Bu değer GetSinglePage bayrağının seçilmesini gerektirir; yoksayılır.

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

-NodeName

Service Fabric düğümünün adını belirtir. cmdlet'i, belirttiğiniz düğümde dağıtılan uygulamaları alır.

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

-TimeoutSec

İşlem için zaman aşımı süresini saniye cinsinden belirtir.

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

-UsePaging

Sorgunun disk belleğine alınıp alınmayacağını belirtir. Seçili değilse, en büyük ileti boyutu yapılandırmasıyla tanımlandığı gibi bir sayfaya sığamayacak kadar çok sonuç olduğunda bu sorgu çalışmaz. Bu seçeneğin seçilmesi, en büyük ileti boyutu yapılandırmasından bağımsız olarak bu sorguyu tüm sonuçları döndürecek şekilde yapılandırılır. Bunu yapmak için sayfalama sonuçları alır ve arayan adına tüm sayfalarda saydam bir şekilde döngü yapar.

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

Girişler

System.String

System.Uri

Çıkışlar

System.Object