Partilhar via


Configuração de cache com Windows PowerShell (Cache do Windows Server AppFabric)

Há dois modos para configurar o Serviço de Cache do Windows Server AppFabric: 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 o uso do Assistente de Configuração do AppFabric, consulte Configurar o Windows Server AppFabric.

Se você estiver usando um computador com o recurso Administração de Cache instalado, existem duas maneiras de usar o Windows PowerShell para gerenciar os recursos de cache do AppFabric. No Menu Iniciar, vá para Ferramentas Administrativas e selecione Módulos do Windows PowerShell. Ou então, você pode ir para o Menu Iniciar, clicar em Todos os Programas, em Windows Server AppFabric e em Windows PowerShell de Administração de Cache.

Observação

Nos sistemas operacionais Windows Vista, Windows 7 e Windows Server 2008, você deve executar o Windows PowerShell com privilégios administrativos para que alguns comandos de configuração funcionem corretamente. Para o atalho Windows PowerShell de Administração de Cache, clique com o botão direito do mouse no atalho e selecione Executar como administrador.

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 Windows Server AppFabric. A tabela a seguir lista os comandos do Windows PowerShell de Administração de Cache disponíveis para configurar o Serviço de Cache.

Comando Descrição

Add-CacheAdmin

Configura a Administração de Cache no host de cache. Esse comando opera no servidor localmente.

Add-CacheHost

Configura um host de cache para permitir que ele faça parte de um cluster existente. Esse comando opera no servidor localmente.

Get-CacheClusterInfo

Retorna as informações do cluster de cache, inclusive detalhes sobre seu status de inicialização e tamanho.

Get-CacheConnectionString

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 Windows Server AppFabric. Não há cenários do usuário conhecidos que exigem seu uso.

New-CacheCluster

Cria e inicializa um novo repositório de configuração do cluster de cache.

Register-CacheHost

Adiciona um host de cache ao repositório de configuração do cluster de cache.

Remove-CacheAdmin

Desconfigura a Administração de Cache no host de cache. Esse comando opera no servidor localmente.

Remove-CacheCluster

Remove uma configuração de cluster existente.

Remove-CacheHost

Desconfigura um host de cache que atualmente não é um membro de um cluster de cache. Esse comando opera no servidor localmente.

Set-CacheConfigurationLog

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.

Set-CacheConnectionString

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 Windows Server AppFabric. Não há cenários do usuário conhecidos que exigem seu uso.

Test-CacheClusterConnection

Testa a conexão com um repositório de configuração do cluster de cache.

Unregister-CacheHost

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.

Consulte também

Conceitos

Usando o Windows PowerShell para gerenciar os recursos de cache do Windows Server AppFabric
Definições de configuração (Cache do Windows Server AppFabric)
Opções de configuração de cache do Windows Server AppFabric
Solucionando problemas de cache do Windows Server AppFabric
Conceitos de cache do Windows Server AppFabric
Desenvolvendo um cliente de cache (cache do Windows Server AppFabric)

  2011-12-05