Executando Cmdlets do AppFabric

Este tópico descreve como iniciar uma sessão de console do AppFabric Windows PowerShell, importar o móduloAppFabric para o Windows PowerShell e obter ajuda sobre os cmdlets de AppFabric.

Você pode executar um cmdlet do AppFabric na linha de comandos de uma sessão do Windows PowerShell assim que o módulo AppFabric Windows PowerShell (o módulo ApplicationServer) for o carregado em uma sessão genérica do Windows PowerShell. O módulo ApplicationServer é automaticamente importado quando você executa o comando Módulos do Windows PowerShell nas Ferramentas Administrativas. O módulo ApplicationServer não será carregado automaticamente se você abrir o módulo do Windows PowerShell usando o ícone na barra de ferramentas ou o comando powershell.exe. Nesses casos, você deverá importar manualmente o módulo, como descrito a seguir. Quando você faz isso, o módulo é carregado apenas na sessão atual.

O Windows PowerShell possui funcionalidade interna que fornece informações de ajuda da linha de comandos. Essa funcionalidade é acessada usando o cmdlet Get-Help ou o alias de Ajuda. O conteúdo padrão retornado pelo cmdlet Get-Help fornece uma descrição básica da funcionalidade e da sintaxe do cmdlet. Para obter progressivamente informações mais detalhadas sobre parâmetros e outros elementos do cmdlet, você pode fornecer o parâmetro –detailed ou –full. O alias de Ajuda exibe as informações retornadas por uma página de Get-Help por vez. Você também pode listar os cmdlets de AppFabric para o Windows PowerShell ou realizar a saída da ajuda agregada dos cmdlets de AppFabric, como descrito a seguir.

Para abrir o módulo AppFabric para o Windows PowerShell

1. Para abrir o console do PowerShell com os módulos do AppFabric automaticamente carregados, clique em Iniciar, aponte para Ferramentas Administrativas e clique em Módulos do Windows PowerShell.

   Dica

   O comando dos Módulos do Windows PowerShell automaticamente carregam os módulos ApplicationServer, DistributedCacheAdministration e DistributedCacheConfiguration.

2. Para abrir o console do PowerShell com o módulo DistributedCacheAdministration automaticamente carregado, clique em Iniciar, em Microsoft AppFabric 1.1 para Windows Server e clique em Windows PowerShell de Administração de Cache.

   Dica

   O comando do Windows PowerShell de Administração de Cache carrega automaticamente o módulo DistributedCacheAdministration, mas não carrega automaticamente o módulo AplicationServer ou DistributedCacheConfiguration.

   Dica

   Se você abrir o console do Windows PowerShell por outros meios diferentes do comando Módulos do Windows PowerShell nas Ferramentas Administrativas, será necessário importar os módulos do AppFabric (veja abaixo). Esses outros métodos incluem o comando do Windows PowerShell no menu Acessórios, o ícone do Windows PowerShell na barra de ferramentas ou executar powershell.exe em <unidade>:\Windows\System32\WindowsPowerShell\v1.0. Você precisará importar os módulos do AppFabric separadamente, pois esses métodos não carregam automaticamente o módulo ApplicationServer e outros módulos do AppFabric.

Para importar o módulo AppFabric para o Windows PowerShell

1. Se você abrir o console do Windows PowerShell por outros meios diferentes do comando Módulos do Windows PowerShell nas Ferramentas Administrativas, será necessário importar os módulos do AppFabric separadamente.

2. Digite um ou mais dos seguintes comandos no prompt do Windows PowerShell e pressione ENTER: Import-Module ApplicationServer, Import-Module distributedcacheconfiguration e Import-Module distributedcacheadministration.

   Dica

   Você pode importar o módulo ApplicationServer para o Windows PowerShell sem ser um administrador do computador.

   Dica

   Ao importar o módulo manualmente, ele permanecerá carregado apenas para a sessão atual. Se abrir o console novamente usando um dos métodos anteriores, você precisará importar o módulo novamente.

   Dica

   Para verificar se o módulo ApplicationServer do Windows PowerShell foi carregado, execute um ou mais dos seguintes comandos no prompt do Windows PowerShell e pressione ENTER: Get-Command –module ApplicationServer, Get-Command –module distributedcacheconfiguration e Get-Command –module distributedcacheadministration. Verifique se os cmdlets de AppFabric estão listados.

Para obter ajuda para o cmdlet

1. Para obter ajuda para um cmdlet específico, digite o seguinte comando no prompt do Windows PowerShell e pressione ENTER: Get-Help <cmdlet name> [-detailed | -full].

   Dica

   Por exemplo, para exibir a ajuda completa do cmdlet Get-ServiceInstance, digite o seguinte comando no prompt do Windows PowerShell e pressione ENTER: Get-Help Get-ServiceInstance –full.

2. Para exibir uma lista dos cmdlets fornecidos pelo módulo ApplicationServer na tela, digite o seguinte comando no prompt do Windows PowerShell e pressione ENTER: Get-Command –module ApplicationServer.

3. Para imprimir uma lista de todos cmdlets fornecidos pelo módulo ApplicationServer para um arquivo, digite o seguinte comando no prompt do Windows PowerShell e pressione ENTER: Get-Command –module ApplicationServer | Sort-Object > C:\AppFabricCmdlets.txt.

   Para imprimir uma referência de todos arquivos de ajuda do cmdlet fornecidos pelo módulo ApplicationServer para um arquivo, ordenados por substantivo e verbo, digite o seguinte comando no prompt do Windows PowerShell e pressione ENTER: Get-Command –module ApplicationServer | Sort-Object Verb,Noun | Get-Help -detailed > C:\HelpTopicsSortedNounVerb.txt.

  2012-03-05