Get-ServiceFabricApplication
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 delle dimensioni massime 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 tutte le pagine restituite in modo trasparente. 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/CalculatorAppWithAppParametersQuesto 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 configurati 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, che indica che non sono disponibili più pagine.
Esempio 7: Ottenere l'applicazione per 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.
| Type: | ApplicationDefinitionKindFilter |
| Accepted values: | Default, ServiceFabricApplicationDescription, Compose, MeshApplicationDescription, All |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Uri |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ApplicationTypeName
Specifica il nome del tipo di applicazione utilizzato 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.
| Type: | String |
| Position: | Named |
| 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 |
-ExcludeApplicationParameters
Specifica se i parametri dell'applicazione verranno esclusi dal risultato.
| Type: | SwitchParameter |
| 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: | True |
| 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 |
-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 |
Input
System.Uri
System.String
Output
System.Object