Compartilhar via

Exibir serviços usando cmdlets do AppFabric

  • Artigo

Este tópico descreve como exibir serviços e instâncias de serviço usando os cmdlets do AppFabric.

Dica

Para executar manualmente um cmdlet do AppFabric, abra o console do Windows PowerShell para o AppFabric, insira o cmdlet adequado e pressione ENTER. Para obter mais informações sobre a execução de cmdlets, consulte Executando Cmdlets do AppFabric Para obter informações sobre qualquer uma das classes ou parâmetros comuns usados nas instruções de sintaxe neste documento, consulte Referência do Windows PowerShell para AppFabric.

Para obter os serviços de um aplicativo

O cmdlet Get-ASAppService exibe todos os serviços disponíveis no escopo especificado. A tabela a seguir descreve os parâmetros desse cmdlet.

Parâmetro Descrição

-Root (opcional)

Se especificado, os parâmetros –Uri, -SiteName e –ServiceObject não devem ser especificados. Quando você usa esse parâmetro, o cmdlet retorna todos os serviços hospedados no servidor local no ambiente IIS/WAS.

Get-ASAppService –Root

-SiteName (opcional)

Se especificado, os parâmetros –Root, –Uri, –ServiceObject não devem ser especificados. Quando você usa esse parâmetro, o cmdlet retorna todos os serviços hospedados em um site especificado.

Get-ASAppService –SiteName “Default Web Site”

-VirtualPath (Opcional)

Parâmetro opcional usado com -SiteName quando nem –Uri nem –ServiceObject forem especificados. Especifica o caminho virtual para um serviço ou aplicativo; por exemplo, /MyDir1/MyApp1/POService.svc.

Get-ASAppService –SiteName “Default Web Site” –VirtualPath “/MyWFServiceApplication”

-Uri (Opcional)

Se especificado, –SiteName, -VirtualPath e –ServiceObject não devem ser especificados. Especifica um URI para um site, aplicativo ou serviço. Se especificado, somente os serviços disponíveis nessa URI serão retornados.

Get-ASAppService –Uri “https://localhost/MyWFServiceApplication”

-ApplicationObject (Opcional)

Se especificado, –SiteName, -VirtualPath e –Uri não devem ser especificados. Esse parâmetro é normalmente usado para o transporte de saída pelo cmdlet Get-ASAppService.

Get-Application | Get-ASAppService

-Count (Opcional)

Retorna a contagem de serviços.

Get-ASAppService -Count

Para obter mais informações sobre esse cmdlet, consulte Get-ASAppService.

Para obter uma instância de serviço

O cmdlet Get-ASAppServiceInstance exibe informações sobre os objetos de instância de serviço de um ou mais repositórios de persistência. O cmdlet Get-ASAppServiceInstance cmdlet consulta um conjunto específico de repositórios de persistência e retorna uma coleção de instâncias de serviço que correspondem aos parâmetros de consulta fornecidos. A tabela a seguir descreve os parâmetros desse cmdlet.

Parâmetro Descrição

-Root (opcional)

Se especificado, os parâmetros –Uri, -SiteName e –ServiceObject não devem ser especificados. Quando você usa esse parâmetro, o cmdlet retorna todas as instâncias de serviços no servidor local.

Get-ASAppServiceInstance –Root

-SiteName (opcional)

Se especificado, nem –Uri, nem –ServiceObject devem ser especificados. Especifica o nome de um site. Se especificado, somente as instâncias de serviço armazenadas no site especificado retornarão.

Get-ASAppServiceInstance –SiteName “Default Web Site”

-VirtualPath (Opcional)

Parâmetro opcional usado com -SiteName quando nem –Uri nem –ServiceObject forem especificados. Especifica o caminho virtual para um serviço ou aplicativo; por exemplo, /MyDir1/MyApp1/POService.svc.

Get-ASAppServiceInstance –SiteName “Default Web Site” –VirtualPath “/MyWFServiceApplication”

-Uri (Opcional)

Se especificado, –SiteName, -VirtualPath e –ServiceObject não devem ser especificados. Especifica um URI para um site, aplicativo ou serviço. Se especificado, somente as instâncias de serviço nessa URI serão retornadas

Get-ASAppServiceInstance –Uri “https://localhost/MyWFServiceApplication”

-ServiceInfo (Opcional)

Se especificado, –SiteName, -VirtualPath e –Uri não devem ser especificados. Especifica um objeto ServiceInfo usado para determinar as instâncias de serviços que retornarão informações. Esse parâmetro é normalmente usado para o transporte de saída pelo cmdlet Get-ASAppService.

Get-ASAppService | Get-ASAppServiceInstance

-ApplicationInfo (Opcional)

Se especificado, –SiteName, -VirtualPath e –Uri não devem ser especificados. Especifica um objeto ApplicationInfo usado para determinar as instâncias de serviços que retornarão informações. Esse parâmetro é normalmente usado para o transporte de saída pelo cmdlet Get-ASApplication.

Get-ASApplication | Get-ASAppServiceInstance

-Count (Opcional)

Especifica que somente uma contagem do número de instâncias encontrado corresponde aos parâmetros de consulta que devem ser retornados.

//root level is the default level
Get-ASAppServiceInstance -Count

-CreatedTimeFrom (Opcional)

Especifica o início de um intervalo de tempo no qual uma instância de serviço foi iniciada. Se esse parâmetro for especificado, somente as instâncias iniciadas durante ou depois do carimbo de data e hora retornarão.

Get-ASAppServiceInstance -CreatedTimeFrom 1/1/2009

-CreatedTimeTo (Opcional)

Especifica o fim de um intervalo de tempo no qual uma instância de serviço foi iniciada. Se esse parâmetro for especificado, somente as instâncias iniciadas durante ou antes do carimbo de data e hora retornarão.

Get-ASAppServiceInstance -CreatedTimeTo 6/1/2009
Get-ASAppServiceInstance -CreatedTimeFrom 1/1/2009 -CreatedTimeTo 6/1/2009

-MachineName (Opcional)

Especifica um nome de computador. Se especificado, somente as instâncias de serviço bloqueadas por esse computador retornarão.

Get-ASAppServiceInstance -MachineName

-ModifiedTimeFrom (Opcional)

Especifica o início de um intervalo de tempo no qual uma instância de serviço foi modificada. Se esse parâmetro for especificado, somente as instâncias modificadas durante ou depois do carimbo de data e hora retornarão.

Get-ASAppServiceInstance -ModifiedTimeFrom 1/1/2009

-ModifiedTimeTo (Opcional)

Especifica o fim de um intervalo de tempo no qual uma instância de serviço foi modificada. Se esse parâmetro for especificado, somente as instâncias modificadas durante ou antes do carimbo de data e hora retornarão.

Get-ASAppServiceInstance -ModifiedTimeTo 6/1/2009
Get-ASAppServiceInstance -ModifiedTimeFrom 1/1/2009 -ModifiedTimeTo 6/1/2009

-ExceptionName (Opcional)

Especifica uma cadeia de caracteres representando o tipo de nome totalmente qualificado de uma exceção .NET Framework. Se especificado, somente as instâncias de serviço que foram encerradas porque as exceções especificadas serão retornadas.

-MaxRows (Opcional)

Especifica o número de linhas (instâncias de serviço) para retorno.

Get-ASAppServiceInstance –MaxRows 100

-InstanceId (Opcional)

Especifica o ID da instância (especificado como GUID) da instância de serviço para retorno. O ID da instância identifica exclusivamente uma instância de serviço. Se esse parâmetro for especificado, a instância nesse ID retornará (se existir).

-ServiceType (Opcional)

Especifica um serviço pelo seu tipo. Se especificado, somente as instâncias desse tipo de serviço retornarão. O tipo de serviço pode ser expresso como um caminho total ou parcial ou como um nome e um namespace do .NET Framework totalmente qualificados. Ao especificar um tipo de serviço pelo namespace, você precisa usar o caractere "#" para separar o tipo de serviço do namespace. Por exemplo, se o nome de um serviço .NET Framework CLR totalmente qualificado for Contoso.Web.Sales.POService, O valor de parâmetro deve ser "Contoso.Web.Sales#POService".

Você não pode especificar explicitamente caracteres curinga, porém, esse parâmetro contém caracteres curinga implícitos (”*”) antes e após o valor fornecido. Por exemplo, "Contoso/Service.svc" é tratado como "*Contoso/Service.svc*" e "Sales#POService" é tratado como "*Sales#POService*".

-Status (Opcional)

Especifica o status da instância. Se especificado, somente as instâncias de serviço do estado especificado retornam pela consulta. Os valores possíveis para Status são: Em execução, Suspenso e Concluído.

Get-ASAppServiceInstance -Status Completed

-Condition (Opcional)

Especifica a condição da instância. Se especificado, somente as instâncias de serviço da condição especificada retornam pela consulta. Os valores possíveis para Condition são: Ativo, Ocioso, Exceção, Suspensão pelo Usuário, Êxito, Cancelado e Encerrado.

Get-ASAppServiceInstance -Condition Cancelled

-GroupBy (Opcional)

Especifica um campo usado para agrupar as contagens de instância de serviço retornadas. Os valores possíveis para GroupBy são: AplicativoÚnico, ServiçoÚnico, TipoDeServiço, Exceção, Status, Site e NomeDoComputador.

Get-ASAppServiceInstance –GroupBy Status

-OrderBy (Opcional)

Exibe as instâncias de serviços classificadas na ordem decrescente da hora da última atualização.

-ExcludeSubFolders (Opcional)

Se especificado, exclui os resultados para as instâncias em subaplicativos a partir dos resultados para aplicativo contido.

-Timeout (Opcional)

Especifica quanto tempo o cmdlet aguarda uma resposta do banco de dados. O valor é um valor de tempo no formato hh:mm:ss. O valor mínimo é 00:00:01 (1 seg.), o máximo é TimeSpan.MaxValue. Caso seja omitido, padroniza para 00:02:00 (2 min.).

-ReturnBinaryProperties (Opcional)

Se especificado, retorna a matriz das propriedade binárias de metadados do objeto InstanceInfo retornado.

Para obter mais informações sobre esse cmdlet, consulte Get-ASAppServiceInstance.

  2012-03-05