Compartilhar via


Get-ServiceFabricApplicationType

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 aplicativo registrados ou registrados

PS C:\> Get-ServiceFabricApplicationType

Esse comando obtém todos os tipos de aplicativo registrados.

Exemplo 2: obter o tipo de aplicativo registrado ou de registro 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"

Esse 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 aplicativo registrados ou registrados sem parâmetros de aplicativo padrão

PS C:\>Get-ServiceFabricApplicationType -ExcludeApplicationParameters

Esse comando obtém todos os tipos de aplicativo registrados. Os objetos System.Fabric.Query.ApplicationType 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 aplicativo registrados ou registrados com paginação e, em seguida, tubulação

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

Esse comando obtém todos os tipos de aplicativo registrados ou registrados usando paginação. Isso significa que as mensagens não serão descartadas se não se encaixarem em uma mensagem, cujo tamanho é determinado pela configuração de tamanho máximo de messaage. 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 bit a bit em membros de ApplicationTypeDefinitionKindFilter. Somente os aplicativos que correspondem ao filtro são retornados. ApplicationTypeName e ApplicationTypeDefinitionKindFilter não podem ser especificados juntos.

Tipo:ApplicationTypeDefinitionKindFilter
Valores aceitos:Default, ServiceFabricApplicationPackage, Compose, MeshApplicationDescription, All
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 de tipo de aplicativo exatos que diferenciam maiúsculas de minúsculas definidos no manifesto do aplicativo de todos os tipos de aplicativo provisionados ou de provisionamento. 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
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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 especificados.

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

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ExcludeApplicationParameters

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

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TimeoutSec

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

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UsePaging

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

Se essa consulta for despagada, o número de resultados retornados será restringido pela configuração de tamanho máximo da 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 for paginada, os resultados não serão descartados devido ao tamanho da mensagem, pois os resultados são divididos em páginas quando necessário e em loop. A paginação é feita internamente pela consulta e nenhuma etapa adicional é necessária.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

System.String

Saídas

System.Object