Get-ServiceFabricApplication

  • Riferimento
Modulo:
ServiceFabric

Ottiene le applicazioni nel cluster di Service Fabric.

Sintassi

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

Descrizione

Il cmdlet Get-ServiceFabricApplication ottiene le applicazioni nel cluster di Service Fabric. Per impostazione predefinita, non esistono restrizioni sul numero di risultati della query che possono essere restituiti da questa query, indipendentemente dalla configurazione massima delle dimensioni dei messaggi; mentre si tratta di una query di paging, a differenza delle chiamate EQUIVALENTi REST o C#, il comportamento predefinito di questa query consiste nel scorrere in modo trasparente tutte le pagine restituite. L'opzione GetSinglePage configura questa query per restituire una singola pagina.

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 tutte le applicazioni

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

Questo comando ottiene tutte le applicazioni nel cluster.

Esempio 2: Ottenere l'applicazione in base al nome

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

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

Questo comando ottiene l'applicazione specifica con il nome fabric:/samples/PQueueApp1.

Esempio 3: Ottenere l'applicazione in base al nome del tipo

PS C:\>Get-ServiceFabricApplication -ApplicationTypeName PersistentQueueApp

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

Questo comando ottiene le applicazioni di Service Fabric il cui nome di tipo è PersistentQueueApp.

Esempio 4: Ottenere l'applicazione per tipo di definizione

PS C:\>Get-ServiceFabricApplication -ApplicationDefinitionKindFilter Compose

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

Questo comando ottiene le applicazioni di Service Fabric definite dalla descrizione dell'applicazione di Service Fabric.

Esempio 5: Ottenere un'applicazione con risultati massimi

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

Questo comando ottiene tutte le applicazioni di Service Fabric nel cluster che si adattano a una pagina. Anche se nel cluster sono presenti più applicazioni, vengono restituiti solo due risultati come configurato dal parametro MaxResults. Poiché sono presenti risultati che non rientrano nella pagina, viene restituito un valore del token di continuazione, che indica la presenza di pagine successive.

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

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:

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. L'opzione "Verbose" non mostra alcun token di continuazione, simbolizzando che non sono disponibili altre pagine.

Esempio 7: Ottenere l'applicazione in base al nome escludendo i parametri dell'applicazione

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

Questo comando ottiene l'applicazione di Service Fabric che corrisponde al nome dell'applicazione specificato. Come illustrato nell'esempio 5, questa applicazione ha parametri dell'applicazione, ma viene esclusa dai risultati restituiti a causa del flag "ExcludeApplicationParameters"

Parametri

-ApplicationDefinitionKindFilter

Specifica il filtro per ApplicationDefinitionKindFilter in base alla modalità di definizione dell'applicazione. Il valore può essere ottenuto dai membri o dalle operazioni bit per bit sui membri di ApplicationDefinitionKindFilter. Vengono restituite solo le applicazioni che corrispondono al filtro. Al massimo è possibile specificare ApplicationName, ApplicationTypeName o ApplicationDefinitionKindFilter. Se non viene specificato alcun filtro, vengono restituite tutte le applicazioni.

Tipo:ApplicationDefinitionKindFilter
Valori accettati:Default, ServiceFabricApplicationDescription, Compose, MeshApplicationDescription, All
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ApplicationName

Specifica l'URI (Uniform Resource Identifier) di un'applicazione di Service Fabric. Il cmdlet ottiene l'applicazione con l'URI specificato. Al massimo è possibile specificare ApplicationName, ApplicationTypeName o ApplicationDefinitionKindFilter. Se non viene specificato alcun filtro, vengono restituite tutte le applicazioni.

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

-ApplicationTypeName

Specifica il nome del tipo di applicazione usato per filtrare le applicazioni per cui eseguire una query. Al massimo è possibile specificare ApplicationName, ApplicationTypeName o ApplicationDefinitionKindFilter. Se non viene specificato alcun filtro, vengono restituite tutte le applicazioni.

Tipo:String
Posizione:Named
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

-ExcludeApplicationParameters

Specifica se i parametri dell'applicazione verranno esclusi dal risultato.

Tipo:SwitchParameter
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:True
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

-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

Input

System.Uri

System.String

Output

System.Object