Get-ServiceFabricDeployedApplication
Obtém a(s) aplicação de Tecido de Serviço num nó especificado.
Syntax
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 Get-ServiceFabricDeployedApplication cmdlet recebe a aplicação(s) de Tecido de Serviço implantada num nó especificado.
O Service Fabric cria diretórios de trabalho, log e diretórios temporários no nó para cada aplicação implantada. Como os nomes do diretório incluem a identificação do formulário, os nomes do diretório não podem ser adivinhados. Quando o Classificador de Aplicação de Aplicações está Ativo, o Get-ServiceFabricDeployedApplication devolve os nomes do diretório nos valores workDirectory, LogDirectory e TempDirectory . Quando o 'ImplantedApplicationStatus ' está a ser descarregado, os valores WorkDirectory, LogDirectory e TempDirectory são nulos.
Os serviços de aplicação implantados armazenam os seus dados persistentes no WorkDirectory. Para depuração ou diagnóstico, uma aplicação ou processo diferente pode precisar de saber a localização do WorkDirectory.
Os serviços de aplicação implantados devem armazenar o seu registo no LogDirectory criado pela Service Fabric. Um uploader personalizado dos ficheiros de registo pode precisar de saber a localização. A localização do LogDirector também pode ser necessária para fins de diagnóstico quando uma aplicação num determinado nó não está a funcionar como esperado.
Por predefinição, esta consulta devolve uma série de resultados limitados à configuração do tamanho máximo da mensagem. SDKs e clusters versões 6.1 ou mais recentes suportam funcionalidade de paging que remove esta restrição; o novo comportamento será devolver os resultados independentemente da configuração do tamanho máximo da mensagem, porque esta consulta passa por todas as páginas devolvidas de forma transparente. Para utilizar a paging e outras novas funcionalidades, consulte o conjunto de parâmetros "UsePagedAPI". Selecionar quaisquer novos sinais de filtros para a consulta para usar paging sob o exaustor. Caso contrário, selecione "UsePaging" para optar por consulta de 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 aplicação "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 : UnknownEste comando retorna as aplicações implementadas. Neste exemplo, o Classificador de Aplicação de Aplicações é Ativo e, portanto, Get-ServiceFabricDeployedApplication devolve os nomes do diretório nos valores workDirectory, LogDirectory e TempDirectory .
Exemplo 2: Obter aplicação "tecido:/samples/VQueueApp2"
PS C:\> Get-ServiceFabricDeployedApplication -NodeName VIPULM4-RK01-BD01 fabric:/samples/VQueueApp2
ApplicationName : fabric:/samples/VQueueApp2
ApplicationTypeName : VolatileQueueApp
DeployedApplicationStatus : Downloading
HealthState : UnknownEste comando retorna as aplicações implementadas. Neste exemplo, o DeployedApplicationStatus está a descarregar e, portanto, o comando devolve valores de nulo para WorkDirectory, LogDirectory e TempDirectory.
Exemplo 3: Obter aplicações(s) 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/PQueueApp1Este comando obtém todas as aplicações de Tecido de Serviço implantadas no nó fornecido no cluster que se encaixa numa página. O tamanho da página é ainda limitado a dois itens, conforme configurado pelo parâmetro MaxResults. Como selecionamos a opção "GetSinglePage", esta consulta retornará apenas uma página de resultados. MaxResults não pode ser utilizado sem esta opção. Selecionar "Verbose" imprime o valor simbólico de continuação devolvido. Este valor pode ser usado numa consulta subsequente para obter a próxima página de resultados. Também pode aceder ao token de continuação devolvido guardando os resultados devolvidos e acedendo à propriedade "ContinuationToken". A propriedade "ContinuationToken" é nula é que não há nenhum token de continuação devolvido.
Exemplo 4: Obter aplicação 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 : UnknownEste 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. Neste agrupamento de exemplos, há apenas um ponto que respeita a continuação do token. Se existirem demasiadas aplicações que respeitem o token de continuação fornecido no nó para caber numa página de resultados, então esta configuração de consulta devolverá uma compilação de todas as páginas devolvidas, passando por elas de forma transparente; a consulta irá então devolver um vetor de todos os resultados. Para obter apenas uma página de resultados, selecione a opção "GetSinglePage".
Exemplo 5: Obter aplicação com estado de saúde
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 : OkEste comando obtém a aplicação Service Fabric que corresponde ao nome de aplicação fornecido e inclui o seu estado de saúde.
Parâmetros
-ApplicationName
Especifica o Identificador de Recursos Uniforme (URI) de uma aplicação de Tecido de Serviço. O cmdlet obtém a aplicação implementada que corresponde ao nome de aplicação especificado. Esta consulta combina exatamente. Por exemplo, o tecido URI:/App não corresponderá ao tecido:/App1. No máximo, um resultado será devolvido se o nome do pedido for fornecido. Se o nome da aplicação fornecido não corresponder a qualquer pedido no nó, a consulta retorna nulo.
| Type: | Uri |
| Position: | 1 |
| 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 |
-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: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IncludeHealthState
Especifica se a consulta devolverá o estado de saúde das aplicações implementadas. Se este parâmetro não for especificado, então o estado de saúde devolvido é "Desconhecido". Quando selecionada, a consulta vai paralelamente ao nó e ao serviço do sistema de saúde antes da fusão dos resultados. Como resultado, a consulta é mais cara e pode demorar mais tempo.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
-NodeName
Especifica o nome de um nó de tecido de serviço. O cmdlet obtém aplicações implantadas no nó que especifica.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| 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 |
-UsePaging
Especifica se a consulta será paged. Se não for selecionada, esta consulta não funcionará quando há demasiados resultados para encaixar numa página, tal como definido pela configuração do tamanho máximo da mensagem. Selecionar esta opção configura esta consulta para devolver todos os resultados, independentemente da configuração do tamanho da mensagem máxima. Fá-lo recebendo resultados paged e rodando em todas as páginas de forma transparente em nome do chamador.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
System.String
System.Uri
Saídas
System.Object