Configuração de cache com Windows PowerShell (Cache do AppFabric 1.1)
Há duas maneiras de configurar o Serviço de Microsoft AppFabric 1.1 para Cache do Windows Server: a interface do usuário do Assistente de Configuração do AppFabric e um conjunto de comandos do Windows PowerShell para Cache do AppFabric. Este tópico descreve os comandos do Windows PowerShell. Para obter mais informações sobre como usar o Assistente de Configuração do AppFabric, consulte Configurar AppFabric.
Se estiver usando um computador com o recurso Administração de Cache instalado, acesse o Menu Iniciar, clique em Todos os Programas, Microsoft AppFabric 1.1 para Windows Server e clique em Windows PowerShell de Administração de Cache. Depois disso, você deverá importar manualmente o módulo do Windows PowerShell module que contém os comandos de configuração. Isso é exibido no exemplo a seguir.
Import-Module DistributedCacheConfiguration
Observação
Você deve executar o Windows PowerShell com privilégios administrativos para que alguns comandos de administração funcionem corretamente. Para o atalho Windows PowerShell de Administração de Cache, você deve clicar com o botão direito do mouse no atalho e selecionar Executar como administrador.
Alterações do nome do comando no Atualização de março de 2012 para o AppFabric 1.1
O nome incluído atualizado Atualização de março de 2012 para o AppFabric 1.1 altera para os comandos do Windows PowerShell para AppFabric. Essas alterações melhoram a compreensão e a consistência dos comandos. As tabelas seguintes incluem o nome do comando original (RTM) e o nome do comando em março de 2012 (QFE).
Para conservar a compatibilidade com versões anteriores, o script do PowerShell foi fornecido para ser o alias dos novos comandos com os nomes dos antigos comandos. Todas as alterações no nome do parâmetro receberam alias no módulo do PowerShell.
Obtendo ajuda na sessão do Windows PowerShell
As informações a seguir fornecem um resumo dos comandos de administração referentes aos recursos de cache do AppFabric. É importante saber que você pode obter ajuda dentro de sua sessão do Windows PowerShell também. Por exemplo, o seguinte comando exibe todos os comandos de configuração:
get-command -module DistributedCacheConfiguration
Se você precisar de ajuda sobre um comando específico, use o comando get-help. Por exemplo, o seguinte comando exibe a ajuda completa do comando Add-CacheHost:
get-help Add-CacheHost -full
Comandos de configuração
Existem duas categorias principais de comandos do PowerShell de armazenamento em Cache do AppFabric: comandos de administração e comandos de configuração. Este tópico foca nos comandos de configuração. Para obter mais informações sobre os comandos de administração, consulte Usando o Windows PowerShell para gerenciar os recursos de cache do AppFabric 1.1. A tabela a seguir lista os comandos do Windows PowerShell disponíveis para configurar o Serviço de Cache.
| Comando (RTM) | Comando (QFE) | Descrição |
|---|---|---|
|
|
Configura a Administração de Cache no host de cache. Esse comando opera no servidor localmente. |
|
|
Configura um host de cache para permitir que ele faça parte de um cluster existente. Esse comando opera no servidor localmente. |
|
|
Retorna as informações do cluster de cache, inclusive detalhes sobre seu status de inicialização e tamanho. |
|
|
Retorna a cadeia de conexão temporária que foi definida com o comando Set-CacheConnectionString. Observe que esse comando não reflete necessariamente a cadeia de conexão usada pelo repositório de configuração do cluster de cache. Observação Esse comando é usado internamente pelo Microsoft AppFabric 1.1 para Windows Server. Não há cenários do usuário conhecidos que exigem seu uso. |
|
|
Cria e inicializa um novo repositório de configuração do cluster de cache. |
|
|
Adiciona um host de cache ao repositório de configuração do cluster de cache. |
|
|
Desconfigura a Administração de Cache no host de cache. Esse comando opera no servidor localmente. |
|
|
Remove uma configuração de cluster existente. |
|
|
Desconfigura um host de cache que atualmente não é um membro de um cluster de cache. Esse comando opera no servidor localmente. |
|
|
Define o local de um arquivo de log personalizado para usar no registro de comandos de configuração. Por padrão, os logs residem na pasta Temp. |
|
|
Persiste a cadeia de conexão para uso temporário. Essa cadeia pode ser recuperada com Get-CacheConnectionString. Observe que esse comando não altera a cadeia de conexão usada pelo repositório de configuração do cluster de cache. Observação Esse comando é usado internamente pelo Microsoft AppFabric 1.1 para Windows Server. Não há cenários do usuário conhecidos que exigem seu uso. |
|
|
Testa a conexão com um repositório de configuração do cluster de cache. |
|
|
Remove uma entrada do host de cache de um repositório de configuração do cluster de cache. Se o registro do host atual estiver sendo desfeito, o parâmetro HostName não será necessário. Neste caso, os parâmetros Provider e ConnectionString também serão opcionais, supondo que o host de cache atual está configurado e que o comando Remove-CacheHost não foi chamado no host de cache. Aviso
|
Consulte também
Conceitos
Usando o Windows PowerShell para gerenciar os recursos de cache do AppFabric 1.1
Definições de configuração
Opções de configuração de cache do AppFabric
Solucionando problemas de cache do AppFabric
Conceitos de cache do AppFabric (Cache do AppFabric 1.1)
Desenvolvendo um cliente de cache
2012-04-05