Get-ServiceFabricApplicationType

  • Referência
Módulo:
ServiceFabric

Obtém os tipos de aplicativo do Service Fabric registrados no cluster do Service Fabric que correspondem aos filtros fornecidos.

Sintaxe

Get-ServiceFabricApplicationType
   [[-ApplicationTypeName] <String>]
   [[-ApplicationTypeVersion] <String>]
   [-ApplicationTypeDefinitionKindFilter <ApplicationTypeDefinitionKindFilter>]
   [-ExcludeApplicationParameters]
   [-UsePaging]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]
Get-ServiceFabricApplicationType
   [[-ApplicationTypeName] <String>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Description

O cmdlet Get-ServiceFabricApplicationType obtém os tipos de aplicativo do Service Fabric registrados ou registrados no cluster do Service Fabric que correspondem aos filtros fornecidos. Cada versão de um tipo de aplicativo é retornada como um resultado individual na matriz de resultados. Se nenhum tipo de aplicativo for encontrado correspondendo aos parâmetros fornecidos, essa consulta não retornará nada.

Antes de executar qualquer operação em um cluster do Service Fabric, estabeleça uma conexão com o cluster usando o cmdlet Connect-ServiceFabricCluster.

Exemplos

Exemplo 1: Obter todos os tipos de aplicativos registrados ou de registro

PS C:\> Get-ServiceFabricApplicationType

Este comando obtém todos os tipos de aplicativos registrados.

Exemplo 2: Obter registro ou registro de tipo de aplicativo com nomes de tipo especificados

PS C:\> # Scenario: multiple application types are provisioned in the cluster, including TestApp versions 1 and 2, as well as TestApp2 version 1.
PS C:\> Get-ServiceFabricApplicationType -ApplicationTypeName "TestApp"

Este comando obtém todas as versões do tipo de aplicativo "TestApp". Isso não obtém o tipo de aplicativo "TestApp2" porque o nome do tipo de aplicativo não é uma correspondência exata.

Exemplo 3: Obter todos os tipos de aplicativos registrados ou registrados sem parâmetros de aplicativo padrão

PS C:\>Get-ServiceFabricApplicationType -ExcludeApplicationParameters

Este comando obtém todos os tipos de aplicativos registrados. Os objetos System.Fabric.Query.ApplicationType retornados têm uma propriedade DefaultParameters não preenchida, independentemente de o tipo de aplicativo ter parâmetros de aplicativo padrão.

Exemplo 4: Obter todos os tipos de aplicativos registrados ou de registro com paginação e, em seguida, tubulação

PS C:\> Get-ServiceFabricApplicationType -UsePaging | Get-ServiceFabricApplicationManifest

Este comando obtém todos os tipos de aplicativos registrados ou de registro usando paginação. Isso significa que as mensagens não são descartadas se não se encaixarem em uma mensagem, cujo tamanho é determinado pela configuração de tamanho máximo da mensagem. A paginação é feita nos bastidores pela consulta. A tubulação e outras funcionalidades permanecem inalteradas.

Parâmetros

-ApplicationTypeDefinitionKindFilter

Especifica o filtro para ApplicationTypeDefinitionKindFilter com base em como o tipo de aplicativo é definido. O valor pode ser obtido de membros ou operações bitwise em membros de ApplicationTypeDefinitionKindFilter. Somente os tipos de aplicativos que correspondem ao filtro são retornados. ApplicationTypeName e ApplicationTypeDefinitionKindFilter não podem ser especificados juntos.

Tipo:ApplicationTypeDefinitionKindFilter
Valores aceites:Default, ServiceFabricApplicationPackage, Compose, MeshApplicationDescription, All
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ApplicationTypeName

Especifica o nome de um tipo de aplicativo do Service Fabric. O cmdlet obtém todas as versões do nome do tipo de aplicativo que você especificar.

Se você não especificar esse parâmetro, esse cmdlet obterá todos os tipos de aplicativo. Esse parâmetro corresponde aos nomes exatos de tipo de aplicativo que diferenciam maiúsculas de minúsculas definidos no manifesto do aplicativo de todos os tipos de aplicativo provisionados ou provisionados. Por exemplo, o valor "Test" não corresponde a "TestApp" porque é apenas uma correspondência parcial. Esse valor não deve conter a versão do tipo de aplicativo e corresponde a todas as versões do mesmo nome de tipo de aplicativo.

ApplicationTypeName e ApplicationTypeDefinitionKindFilter não podem ser especificados juntos.

Tipo:String
Position:0
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ApplicationTypeVersion

Especifica a versão de um tipo de aplicativo do Service Fabric. O cmdlet obtém o tipo de aplicativo que corresponde ao nome e à versão do tipo de aplicativo especificado.

Forneça esse parâmetro somente se também fornecer o parâmetro ApplicationTypeName. Este parâmetro executa um filtro na parte superior do filtro ApplicationTypeName. Ele corresponde à versão exata do tipo de aplicativo que diferencia maiúsculas de minúsculas definida no manifesto do aplicativo de um tipo de aplicativo provisionado ou provisionado. Por exemplo, o valor "Version" não corresponde a "Version1" porque é apenas uma correspondência parcial. Esse valor não deve conter o nome do tipo de aplicativo.

Tipo:String
Position:1
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ExcludeApplicationParameters

Especifica se os parâmetros de aplicativo padrão devem ser excluídos do resultado da consulta.

Se definido, o campo de parâmetros padrão do aplicativo ainda estará visível, mas estará vazio.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TimeoutSec

Especifica o período de tempo limite, em segundos, para a operação.

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-UsePaging

Especifica se uma versão paginada desta consulta deve ser usada.

Se essa consulta for despaginada, o número de resultados retornados será restrito pela configuração de tamanho máximo de mensagem. Se não for especificado e houver muitos tipos de aplicativo para caber em uma mensagem, a consulta falhará. Nenhum resultado é retornado ao usuário. Se a consulta estiver paginada, os resultados não serão descartados devido a contraints de tamanho da mensagem, porque os resultados são divididos em páginas quando necessário e repetidos. A paginação é feita internamente pela consulta e nenhuma etapa adicional é necessária.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

System.String

Saídas

System.Object