Get-ServiceFabricDeployedApplication
Belirtilen düğümdeki Service Fabric uygulamalarını alır.
Sözdizimi
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, belirtilen düğümde dağıtılan Service Fabric uygulamaları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.
Dağıtılan uygulama hizmetleri kalıcı verilerini WorkDirectoryiçinde depolar. Hata ayıklama veya tanılama amacıyla farklı bir uygulama veya işlemin WorkDirectorykonumunu bilmesi gerekebilir.
Dağıtılan uygulama hizmetleri, günlüklerini Service Fabric tarafından oluşturulan LogDirectory depolamalıdır. Günlük dosyalarının özel bir yükleyicisinin konumu bilmesi gerekebilir. LogDirectory 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 sayfalama işlevselliğini destekler; yeni davranış, en büyük 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üye girer. Disk belleği ve diğer yeni işlevleri kullanmak için "UsePagedAPI" parametre kümesine bakın. Yeni filtrelerin seçilmesi, arka planda disk belleği kullanmak için sorguya işaret eder. Aksi takdirde, sayfalanmış sorgulamayı kabul etmek için "UsePaging" öğesini seçin.
Service Fabric kümesinde herhangi bir işlem yapmadan ö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 : UnknownBu komut dağıtılan uygulamaları döndürür.
Bu örnekte, DeployedApplicationStatus
Ö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 : UnknownBu komut dağıtılan uygulamaları döndürür.
Bu örnekte, DeployedApplicationStatus
Örnek 3: En fazla 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/PQueueApp1Bu 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 de 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 sonraki bir sorguda bir sonraki sonuç sayfasını almak için 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 : UnknownBu 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: Uygulamayı sistem durumuyla 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 : OkBu 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 eşleşme yapar. Ö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.
| Tür: | Uri |
| Position: | 1 |
| 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. 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ş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 |
-GetSinglePage
Sorgunun bir 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: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-IncludeHealthState
Sorgunun dağıtılan uygulamaların sistem durumunu döndürip döndürmeyeceğ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.
| Tür: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İş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 en az 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 |
-NodeName
Service Fabric düğümünün adını belirtir. cmdlet'i, belirttiğiniz düğümde dağıtılan uygulamaları alır.
| Tür: | String |
| Position: | 0 |
| Default value: | None |
| Gerekli: | True |
| İşlem hattı girişini kabul et: | True |
| Joker karakterleri kabul et: | False |
-TimeoutSec
İşlem için 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 |
-UsePaging
Sorgunun disk belleğine alınıp alınmayacağını belirtir. Seçilmemişse, 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, sayfalanmış sonuçlar alarak ve arayan adına tüm sayfalarda saydam bir şekilde döngü yaparak yapar.
| Tür: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
Girişler
System.String
System.Uri
Çıkışlar
System.Object