Get-ServiceFabricApplication
Obtém a(s) aplicação no cluster de Tecido de Serviço.
Syntax
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>]
Description
O Get-ServiceFabricApplication cmdlet recebe a(s) aplicação(s) no cluster de Tecido de Serviço. Por predefinição, não existem restrições ao número de resultados de consulta que possam ser devolvidos por esta consulta, independentemente da configuração do tamanho máximo da mensagem; enquanto esta é uma consulta paged, ao contrário das chamadas equivalentes REST ou C#, o comportamento padrão desta consulta é dar a volta a todas as páginas devolvidas de forma transparente. A opção GetSinglePage configura esta consulta para devolver uma única página.
Antes de efetuar qualquer operação num cluster de tecido de serviço, estabeleça uma ligação ao cluster utilizando o cmdlet Connect-ServiceFabricCluster .
Exemplos
Exemplo 1: Obter todas as aplicações
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 : {}
Este comando recebe todas as aplicações no aglomerado.
Exemplo 2: Obter aplicação pelo 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 : {}
Este comando obtém a aplicação específica com o tecido do nome:/samples/PQueueApp1.
Exemplo 3: Obter aplicação por nome do tipo
PS C:\>Get-ServiceFabricApplication -ApplicationTypeName PersistentQueueApp
ApplicationName : fabric:/samples/PQueueApp1
ApplicationTypeName : PersistentQueueApp
ApplicationTypeVersion : 1.0
ApplicationStatus : Ready
HealthState : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters : {}
Este comando obtém a aplicação(s Fabric de Serviço) cujo nome de tipo é PersistentQueueApp.
Exemplo 4: Obter aplicação por definição tipo
PS C:\>Get-ServiceFabricApplication -ApplicationDefinitionKindFilter Compose
ApplicationName : fabric:/VQueueApp1
ApplicationTypeName : Compose_0
ApplicationTypeVersion : v0
ApplicationStatus : Ready
HealthState : Ok
ApplicationDefinitionKind : Compose
ApplicationParameters : {}
Este comando obtém a aplicação(s Fabric de serviço) que são definidas pela descrição da aplicação Do Tecido de Serviço.
Exemplo 5: Obter aplicação com resultados máximos
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
Este comando obtém todas as aplicações de Tecido de Serviço no cluster que se encaixam numa página. Embora haja mais aplicações no cluster, apenas dois resultados são devolvidos como configurado pelo parâmetro MaxResults. Como existem resultados que não se enquadram na página, é devolvido um valor simbólico de continuação, indicando a presença de páginas posteriores.
Exemplo 6: Obter aplicação com token de continuação
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:
Este comando obtém a(s) aplicação De Tecido de Serviço que respeita o token de continuação fornecido que se encaixa numa única página. O sinal de continuação fornecido a esta consulta é o mesmo devolvido do exemplo acima. A opção "Verbose" não mostra nenhum símbolo de continuação, simbolizando que não há mais páginas disponíveis.
Exemplo 7: Obter aplicação por nome, excluindo os parâmetros de aplicação
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 : {}
Este comando obtém a aplicação Service Fabric que corresponde ao nome de aplicação fornecido. Como se pode ver pelo exemplo 5, esta aplicação tem parâmetros de aplicação, mas está excluída dos resultados devolvidos devido à bandeira "Excluir AplicaçõesParameters"
Parâmetros
-ApplicationDefinitionKindFilter
Especifica o filtro para AplicaçãoDefinitionKindFilter com base na forma como a aplicação é definida. O valor pode ser obtido a partir de membros ou operações bitwise em membros do ApplicationDefinitionKindFilter. Apenas são devolvidas as aplicações que correspondam ao filtro. No máximo, um dos nomes de aplicações, o ApplicationTypeName ou o ApplicationDefinitionKindFilter podem ser especificados. Se não for especificado nenhum filtro, todas as aplicações são devolvidas.
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
Especifica o Identificador de Recursos Uniforme (URI) de uma aplicação de Tecido de Serviço. O cmdlet obtém a aplicação que tem o URI especificado. No máximo, um dos nomes de aplicações, o ApplicationTypeName ou o ApplicationDefinitionKindFilter podem ser especificados. Se não for especificado nenhum filtro, todas as aplicações são devolvidas.
Type: | Uri |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ApplicationTypeName
Especifica o nome do tipo de aplicação utilizado para filtrar as aplicações para consulta. No máximo, um dos nomes de aplicações, o ApplicationTypeName ou o ApplicationDefinitionKindFilter podem ser especificados. Se não for especificado nenhum filtro, todas as aplicações são devolvidas.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ContinuationToken
Especifica o token de continuação que pode ser usado para recuperar a próxima página dos resultados da consulta.
Se muitos resultados respeitarem os filtros fornecidos, podem não caber numa única mensagem. A paging é usada para explicar isso dividindo a recolha de resultados devolvidos em páginas separadas. O token de continuação é usado para saber onde a página anterior ficou para fora, carregando significado apenas para a própria consulta. Este valor deve ser gerado a partir da execução desta consulta, e pode ser passado para o próximo pedido de consulta para obter páginas posteriores. Um valor simbólico de continuação não nulo só é devolvido como parte do resultado se houver uma página subsequente. Se este valor for fornecido sem a opção -GetSinglePage, então a consulta devolverá todas as páginas a partir do valor de token de continuação.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcludeApplicationParameters
Especifica se os parâmetros de aplicação serão excluídos do resultado.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GetSinglePage
Especifica se a consulta devolverá uma página de resultados de consulta com um valor simbólico de continuação, ou todas as páginas combinadas numa lista de resultados. Se esta opção for selecionada, então é da responsabilidade do autor da consulta verificar se as páginas seguintes são selecionadas.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxResults
Especifica o número máximo de itens de resultado que podem ser devolvidos por página. Isto define o limite superior para o número de resultados devolvidos, não um mínimo. Por exemplo, se a página encaixar no máximo 1000 itens devolvidos de acordo com as restrições máximas do tamanho da mensagem definidas na configuração, e o valor MaxResults estiver definido para 2000, apenas 1000 resultados são devolvidos, mesmo que itens de resultado de 2000 correspondam à descrição da consulta. Este valor requer a seleção da bandeira GetSinglePage; será ignorado de outra forma.
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeoutSec
Especifica o período de tempo de ício, em segundos, para a operação.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
System.Uri
System.String
Saídas
System.Object