Get-ServiceFabricApplication

  • Referência
Módulo:
ServiceFabric

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