Get-ServiceFabricDeployedApplication
Obtém o(s) aplicativo(s) do Service Fabric em um nó especificado.
Sintaxe
Get-ServiceFabricDeployedApplication
[-NodeName] <String>
[[-ApplicationName] <Uri>]
[-UsePaging]
[-GetSinglePage]
[-IncludeHealthState]
[-MaxResults <Int64>]
[-ContinuationToken <String>]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Get-ServiceFabricDeployedApplication
[-NodeName] <String>
[[-ApplicationName] <Uri>]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Description
O cmdlet Get-ServiceFabricDeployedApplication obtém o(s) aplicativo(s) do Service Fabric implantado(s) em um nó especificado.
O Service Fabric cria diretórios de trabalho, de log e temporários no nó para cada aplicativo implantado.
Como os nomes de diretório incluem a ID do aplicativo, os nomes de diretório não podem ser adivinhados.
Quando o
Os serviços de aplicativos implantados armazenam seus dados persistentes no WorkDirectory. Para fins de depuração ou diagnóstico, um aplicativo ou processo diferente pode precisar saber o local do WorkDirectory.
Os serviços de aplicativo implantados devem armazenar seu log no LogDirectory
Por padrão, essa consulta retorna um número de resultados limitados à configuração de tamanho máximo de mensagem. SDKs e clusters versões 6.1 ou mais recentes suportam a funcionalidade de paginação que remove essa restrição; O novo comportamento será retornar os resultados independentemente da configuração de tamanho máximo da mensagem, pois essa consulta percorre todas as páginas retornadas de forma transparente. Para usar a paginação e outras novas funcionalidades, consulte o conjunto de parâmetros "UsePagedAPI". A seleção de novos filtros sinaliza para a consulta usar a paginação sob o capô. Caso contrário, selecione "UsePaging" para optar pela consulta paginada.
Antes de executar qualquer operação em um cluster do Service Fabric, estabeleça uma conexão com o cluster usando o cmdlet
Exemplos
Exemplo 1: Obter o aplicativo "fabric:/samples/CalcApp2"
PS C:\> Get-ServiceFabricDeployedApplication -NodeName "VIPULM4-RK01-BD01" -ApplicationName fabric:/samples/CalcApp2
ApplicationName : fabric:/samples/CalcApp2
ApplicationTypeName : CalculatorApp
DeployedApplicationStatus : Active
WorkDirectory : D:\ServiceFabric\Data\VIPULM4-RK01-BD01\Fabric\work\Applications\CalculatorApp_App5\work
LogDirectory : D:\ServiceFabric\Data\VIPULM4-RK01-BD01\Fabric\work\Applications\CalculatorApp_App5\log
TempDirectory : D:\ServiceFabric\Data\VIPULM4-RK01-BD01\Fabric\work\Applications\CalculatorApp_App5\temp
HealthState : Unknown
Este comando retorna aplicativos implantados.
Neste exemplo, o
Exemplo 2: Obter o aplicativo "fabric:/samples/VQueueApp2"
PS C:\> Get-ServiceFabricDeployedApplication -NodeName VIPULM4-RK01-BD01 fabric:/samples/VQueueApp2
ApplicationName : fabric:/samples/VQueueApp2
ApplicationTypeName : VolatileQueueApp
DeployedApplicationStatus : Downloading
HealthState : Unknown
Este comando retorna aplicativos implantados. Neste exemplo, o DeployedApplicationStatus é Download e, portanto, o comando retorna valores de null para WorkDirectory, LogDirectorye TempDirectory.
Exemplo 3: Obter aplicação(ões) com resultados máximos
PS C:\>Get-ServiceFabricDeployedApplication -NodeName _Node_1 -MaxResults 2 -GetSinglePage -Verbose
ApplicationName : fabric:/samples/CalculatorApp
ApplicationTypeName : CalculatorApp
DeployedApplicationStatus : Active
WorkDirectory : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\work
LogDirectory : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\log
TempDirectory : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\temp
HealthState : Unknown
ApplicationName : fabric:/samples/PQueueApp1
ApplicationTypeName : PersistentQueueApp
DeployedApplicationStatus : Active
WorkDirectory : C:\SfDevCluster\Data\_App\_Node_1\PersistentQueueApp_App1\work
LogDirectory : C:\SfDevCluster\Data\_App\_Node_1\PersistentQueueApp_App1\log
TempDirectory : C:\SfDevCluster\Data\_App\_Node_1\PersistentQueueApp_App1\temp
HealthState : Unknown
VERBOSE: Continuation Token: fabric:/samples/PQueueApp1
Este comando obtém todos os aplicativos do Service Fabric implantados no nó fornecido no cluster que cabem em uma página. O tamanho da página é ainda limitado a dois itens, conforme configurado pelo parâmetro MaxResults. Como selecionamos a opção "GetSinglePage", essa consulta retornará apenas uma página de resultados. MaxResults não pode ser usado sem esta opção. Selecionar "Verbose" imprime o valor do token de continuação retornado. Esse valor pode ser usado em uma consulta subsequente para obter a próxima página de resultados. Você também pode acessar o token de continuação retornado salvando os resultados retornados e acessando a propriedade "ContinuationToken". A propriedade "ContinuationToken" é null se não houver nenhum token de continuação retornado.
Exemplo 4: Obter aplicativo com token de continuação
PS C:\>Get-ServiceFabricDeployedApplication -NodeName _Node_1 -ContinuationToken fabric:/samples/PQueueApp1 -UsePaging
ApplicationName : fabric:/samples/VQueueApp1
ApplicationTypeName : VolatileQueueApp
DeployedApplicationStatus : Active
WorkDirectory : C:\SfDevCluster\Data\_App\_Node_1\VolatileQueueApp_App2\work
LogDirectory : C:\SfDevCluster\Data\_App\_Node_1\VolatileQueueApp_App2\log
TempDirectory : C:\SfDevCluster\Data\_App\_Node_1\VolatileQueueApp_App2\temp
HealthState : Unknown
Este comando obtém o(s) aplicativo(s) do Service Fabric que respeitam o token de continuação fornecido que cabem em uma única página. O token de continuação fornecido a esta consulta é o mesmo retornado do exemplo acima. Neste cluster de exemplo, há apenas um item que respeita o token de continuação. Se houver muitos aplicativos que respeitem o token de continuação fornecido no nó para caber em uma página de resultados, essa configuração de consulta retornará uma compilação de todas as páginas retornadas, fazendo um loop através delas de forma transparente; A consulta retornará um vetor de todos os resultados. Para obter apenas uma página de resultados, selecione a opção "GetSinglePage".
Exemplo 5: Obter aplicativo com estado de integridade
PS C:\>Get-ServiceFabricDeployedApplication -NodeName _Node_1 -ApplicationName fabric:/samples/CalculatorApp -IncludeHealthState
ApplicationName : fabric:/samples/CalculatorApp
ApplicationTypeName : CalculatorApp
DeployedApplicationStatus : Active
WorkDirectory : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\work
LogDirectory : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\log
TempDirectory : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\temp
HealthState : Ok
Este comando obtém o aplicativo Service Fabric que corresponde ao nome do aplicativo fornecido e inclui seu estado de integridade.
Parâmetros
-ApplicationName
Especifica o URI (Uniform Resource Identifier) de um aplicativo do Service Fabric. O cmdlet obtém o aplicativo implantado que corresponde ao nome do aplicativo especificado. Esta consulta faz uma correspondência exata. Por exemplo, a malha URI:/App não corresponderá a malha:/App1. No máximo, um resultado será retornado se o nome do aplicativo for fornecido. Se o nome do aplicativo fornecido não corresponder a nenhum aplicativo no nó, a consulta retornará null.
Tipo: | Uri |
Position: | 1 |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-ContinuationToken
Especifica o token de continuação que pode ser usado para recuperar a próxima página de resultados da consulta.
Se muitos resultados respeitarem os filtros fornecidos, eles podem não caber em uma mensagem. A paginação é usada para explicar isso, dividindo a coleção de resultados retornados em páginas separadas. O token de continuação é usado para saber onde a página anterior parou, carregando significado apenas para a consulta em si. Esse valor deve ser gerado a partir da execução dessa consulta e pode ser passado para a próxima solicitação de consulta para obter páginas subsequentes. Um valor de token de continuação não nulo é retornado como parte do resultado somente se houver uma página subsequente. Se esse valor for fornecido sem a opção -GetSinglePage, a consulta retornará todas as páginas a partir do valor do token de continuação.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-GetSinglePage
Especifica se a consulta retornará uma página de resultados da consulta com um valor de token de continuação ou todas as páginas combinadas em uma lista de resultados. Se esta opção estiver selecionada, é da responsabilidade do chamador da consulta verificar as páginas subsequentes.
Tipo: | SwitchParameter |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-IncludeHealthState
Especifica se a consulta retornará o estado de integridade dos aplicativos implantados. Se esse parâmetro não for especificado, o estado de integridade retornado será "Desconhecido". Quando selecionada, a consulta vai em paralelo ao nó e ao serviço do sistema de integridade antes que os resultados sejam mesclados. Como resultado, a consulta é mais cara e pode levar mais tempo.
Tipo: | SwitchParameter |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-MaxResults
Especifica o número máximo de itens de resultado que podem ser retornados por página. Isso define o limite superior para o número de resultados retornados, não um mínimo. Por exemplo, se a página se encaixar no máximo 1000 itens retornados de acordo com as restrições de tamanho máximo de mensagem definidas na configuração e o valor MaxResults estiver definido como 2000, apenas 1000 resultados serão retornados, mesmo que 2000 itens de resultado correspondam à descrição da consulta.
Esse valor requer a seleção do sinalizador GetSinglePage; caso contrário, será ignorado.
Tipo: | Int64 |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-NodeName
Especifica o nome de um nó do Service Fabric. O cmdlet obtém aplicativos implantados no nó que você especificar.
Tipo: | String |
Position: | 0 |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
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 a consulta será paginada. Se não for selecionada, essa consulta não funcionará quando houver muitos resultados para caber em uma página, conforme definido pela configuração de tamanho máximo da mensagem. Selecionar essa opção configura essa consulta para retornar todos os resultados, independentemente da configuração de tamanho máximo da mensagem. Ele faz isso obtendo resultados paginados e fazendo looping em todas as páginas de forma transparente em nome do chamador.
Tipo: | SwitchParameter |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Entradas
System.String
System.Uri
Saídas
System.Object