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 DeployedApplicationStatus è Active, Get-ServiceFabricDeployedApplication restituisce i nomi di directory nei valori restituiti WorkDirectory, LogDirectory e TempDirectory. Quando DeployedApplicationStatus è Download, i valori WorkDirectory, LogDirectory e TempDirectory sono Null.

I servizi dell'applicazione distribuiti archiviano i dati persistenti in WorkDirectory. Per scopi di debug o diagnostica, potrebbe essere necessario conoscere la posizione di WorkDirectory per un'applicazione o un processo diverso.

I servizi applicazioni distribuiti devono archiviare il log in LogDirectory creato da Service Fabric. Potrebbe essere necessario conoscere il percorso di un caricatore personalizzato dei file di log. La posizione di LogDirectory può essere necessaria anche a scopo diagnostico 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 dei messaggi. 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 scorre in modo trasparente tutte le pagine restituite. Per usare il paging e altre nuove funzionalità, vedere il set di parametri "UsePagedAPI". Selezione di eventuali nuovi segnali di filtro 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 , DeployedApplicationStatus è Active e, pertanto, Get-ServiceFabricDeployedApplication restituisce i nomi di directory nei valori restituiti WorkDirectory, LogDirectory e TempDirectory .

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 , DeployedApplicationStatus è Download e, pertanto, il comando restituisce valori null per WorkDirectory, LogDirectory e 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 specificato 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. Selezionando "Dettagliato" 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 sono presenti troppe applicazioni che rispettano il token di continuazione fornito nel nodo per rientrare in una sola pagina di risultati, questa configurazione della query restituirà una compilazione di tutte le pagine restituite, eseguendo un ciclo attraverso 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 l'applicazione con lo 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 corrisponderà 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.

Type:	Uri
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ContinuationToken

Specifica il token di continuazione che può essere utilizzato 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.

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

-GetSinglePage

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 minimo. Ad esempio, se la pagina rientra al massimo 1000 elementi restituiti in base alle limitazioni 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.

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

-NodeName

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

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

-TimeoutSec

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

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

-UsePaging

Specifica se la query verrà visualizzata in paging. Se questa query non è selezionata, questa query non funzionerà quando sono presenti troppi risultati da inserire in una sola 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.

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

Input

System.String

System.Uri

Output

System.Object