Get-ServiceFabricDeployedApplication

  • Riferimento
Modulo:
ServiceFabric

Ottiene le applicazioni di Service Fabric in un nodo specificato.

Sintassi

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

Descrizione

Il cmdlet Get-ServiceFabricDeployedApplication ottiene le applicazioni di Service Fabric distribuite in un nodo specificato.

Service Fabric crea directory di lavoro, log e temporanee nel nodo per ogni applicazione distribuita. Poiché i nomi di directory includono l'ID applicazione, non è possibile indovinare i nomi di directory. Quando il DeployedApplicationStatus è Attivo, Get-ServiceFabricDeployedApplication restituisce i nomi di directory nel WorkDirectory, LogDirectorye TempDirectory valori restituiti. Quando il DeployedApplicationStatus è Download, i valori WorkDirectory, LogDirectorye TempDirectory sono Null.

I servizi applicazioni distribuiti archiviano i dati persistenti nel WorkDirectory. Per scopi di debug o diagnostica, potrebbe essere necessario conoscere la posizione del WorkDirectory.

I servizi applicazioni distribuiti devono archiviare il log nel LogDirectory creato da Service Fabric. Potrebbe essere necessario conoscere il percorso di un uploader personalizzato dei file di log. La posizione del LogDirectory può essere necessaria per scopi diagnostici e quando un'applicazione in un determinato nodo non funziona come previsto.

Per impostazione predefinita, questa query restituisce un numero di risultati limitato alla configurazione massima delle dimensioni del messaggio. SDK e cluster versioni 6.1 o successive supportano la funzionalità di paging che rimuove questa restrizione; Il nuovo comportamento sarà quello di restituire i risultati indipendentemente dalla configurazione massima delle dimensioni dei messaggi, perché questa query esegue il ciclo di tutte le pagine restituite in modo trasparente. Per usare il paging e altre nuove funzionalità, vedere il set di parametri "UsePagedAPI". Selezione di nuovi segnali di filtri alla query per l'uso del paging sotto le quinte. In caso contrario, selezionare "UsePaging" per acconsentire esplicitamente alla query con paging.

Prima di eseguire qualsiasi operazione in un cluster di Service Fabric, stabilire una connessione al cluster usando il cmdlet Connect-ServiceFabricCluster.

Esempio

Esempio 1: Ottenere l'applicazione "fabric:/samples/CalcApp2"

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

Questo comando restituisce le applicazioni distribuite. In questo esempio, il DeployedApplicationStatus è Attivo e, pertanto, Get-ServiceFabricDeployedApplication restituisce i nomi di directory nel WorkDirectory, LogDirectorye Valori restituiti da TempDirect ory.

Esempio 2: Ottenere l'applicazione "fabric:/samples/VQueueApp2"

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

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

Questo comando restituisce le applicazioni distribuite. In questo esempio, il DeployedApplicationStatus è Download e, di conseguenza, il comando restituisce i valori Null per WorkDirectory, LogDirectorye TempDirectory.

Esempio 3: Ottenere applicazioni con risultati massimi

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

Questo comando ottiene tutte le applicazioni di Service Fabric distribuite nel nodo fornito nel cluster che si adattano a una pagina. Le dimensioni della pagina sono ulteriormente limitate a due elementi, come configurato dal parametro MaxResults. Poiché è stata selezionata l'opzione "GetSinglePage", questa query restituirà solo una pagina di risultati. MaxResults non può essere usato senza questa opzione. Se si seleziona "Verbose" viene stampato il valore del token di continuazione restituito. Questo valore può essere usato in una query successiva per ottenere la pagina successiva dei risultati. È anche possibile accedere al token di continuazione restituito salvando i risultati restituiti e accedendo alla proprietà "ContinuationToken". La proprietà "ContinuationToken" è null non esiste alcun token di continuazione restituito.

Esempio 4: Ottenere l'applicazione con il token di continuazione

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

Questo comando ottiene le applicazioni di Service Fabric che rispettano il token di continuazione fornito che rientrano in una singola pagina. Il token di continuazione fornito a questa query è lo stesso restituito dall'esempio precedente. In questo cluster di esempio è presente un solo elemento che rispetta il token di continuazione. Se ci sono troppe applicazioni che rispettano il token di continuazione fornito nel nodo per adattarsi a una pagina di risultati, questa configurazione della query restituirà una compilazione di tutte le pagine restituite, eseguendo un ciclo tra di esse in modo trasparente; la query restituirà quindi un vettore di tutti i risultati. Per ottenere una sola pagina di risultati, selezionare l'opzione "GetSinglePage".

Esempio 5: Ottenere un'applicazione con stato di integrità

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

Questo comando ottiene l'applicazione di Service Fabric che corrisponde al nome dell'applicazione specificato e ne include lo stato di integrità.

Parametri

-ApplicationName

Specifica l'URI (Uniform Resource Identifier) di un'applicazione di Service Fabric. Il cmdlet ottiene l'applicazione distribuita che corrisponde al nome dell'applicazione specificato. Questa query esegue una corrispondenza esatta. Ad esempio, l'URI fabric:/App non corrisponde a fabric:/App1. Al massimo verrà restituito un risultato se viene specificato il nome dell'applicazione. Se il nome dell'applicazione specificato non corrisponde ad alcuna applicazione nel nodo, la query restituisce Null.

Tipo:Uri
Posizione:1
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ContinuationToken

Specifica il token di continuazione che può essere usato per recuperare la pagina successiva dei risultati della query.

Se troppi risultati rispettano i filtri forniti, potrebbero non rientrare in un unico messaggio. Il paging viene usato per tenere conto di questo problema suddividendo la raccolta di risultati restituiti in pagine separate. Il token di continuazione viene usato per sapere dove è stata interrotta la pagina precedente, portando significato solo alla query stessa. Questo valore deve essere generato dall'esecuzione di questa query e può essere passato alla richiesta di query successiva per ottenere le pagine successive. Un valore del token di continuazione non Null viene restituito come parte del risultato solo se è presente una pagina successiva. Se questo valore viene fornito senza l'opzione -GetSinglePage, la query restituirà tutte le pagine a partire dal valore del token di continuazione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-GetSinglePage

Specifica se la query restituirà una pagina dei risultati della query con un valore del token di continuazione o tutte le pagine combinate in un elenco di risultati. Se questa opzione è selezionata, è responsabilità del chiamante della query verificare la presenza di pagine successive.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-IncludeHealthState

Specifica se la query restituirà lo stato di integrità delle applicazioni distribuite. Se questo parametro non viene specificato, lo stato di integrità restituito è "Unknown". Quando questa opzione è selezionata, la query passa in parallelo al nodo e al servizio del sistema di integrità prima che i risultati vengano uniti. Di conseguenza, la query è più costosa e può richiedere più tempo.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MaxResults

Specifica il numero massimo di elementi dei risultati che possono essere restituiti per pagina. In questo modo viene definito il limite superiore per il numero di risultati restituiti, non un valore minimo. Ad esempio, se la pagina rientra al massimo 1000 elementi restituiti in base alle restrizioni massime delle dimensioni dei messaggi definite nella configurazione e il valore MaxResults è impostato su 2000, vengono restituiti solo 1000 risultati, anche se 2000 elementi dei risultati corrispondono alla descrizione della query.

Questo valore richiede la selezione del flag GetSinglePage; verrà ignorato in caso contrario.

Tipo:Int64
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NodeName

Specifica il nome di un nodo di Service Fabric. Il cmdlet ottiene le applicazioni distribuite nel nodo specificato.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-TimeoutSec

Specifica il periodo di timeout, espresso in secondi, per l'operazione.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UsePaging

Specifica se la query verrà paging. Se non è selezionata, questa query non funzionerà quando sono presenti troppi risultati da adattare a una pagina, come definito dalla configurazione delle dimensioni massime dei messaggi. Se si seleziona questa opzione, questa query viene configurata per restituire tutti i risultati, indipendentemente dalla configurazione delle dimensioni massime dei messaggi. A tale scopo, ottenere risultati di paging e scorrere in modo trasparente tutte le pagine per conto del chiamante.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

System.String

System.Uri

Output

System.Object