Administração de cache com o Windows PowerShell (AppFabric 1.1)

Com o Windows PowerShell, você pode administrar o cluster de cache, os hosts de cache e o cache em si. 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.

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.

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 se concentra nos comandos de administração. Para obter mais informações sobre os comandos de configuração, consulte Configuração de cache com Windows PowerShell (Cache do AppFabric 1.1). As tabelas deste tópico dividem os comandos de administração em categorias. Alguns comandos são apresentados em mais de uma tabela, mostrando como os diferentes parâmetros são aplicados a cada uma das quatro categorias de comandos:

• Comandos relacionados ao cluster de cache

• Comandos relacionados ao host de cache

• Comandos relacionados ao cache

• Comandos de Gerenciamento do Console

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 administração:

get-command -module DistributedCacheAdministration

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 New-Cache:

get-help New-Cache -full

Considerações importantes

Ao usar os comandos do Windows PowerShell descritos neste tópico, é importante considerar os seguintes pontos:

• A identidade de segurança da pessoa que está usando esses comandos do Windows PowerShell deve ter privilégios de administrador em todos os servidores de cache do cluster de cache.

• Os valores de parâmetros dos comandos fazem distinção entre maiúsculas e minúsculas. Por exemplo, se você criar um cache denominado NamedCache1, o comando Get-CacheConfig -CacheName namedcache1 não funcionará. Faça a correspondência de maiúsculas e minúsculas, como em Get-CacheConfig -CacheName NamedCache1.

• Ao fazer alterações de configuração de cluster baseada em XML com os comandos Export-CacheClusterConfig e Import-CacheClusterConfig, você pode alterar as definições de configuração de cluster (atributos XML) no arquivo XML, mas não há suporte para adicionar ou remover caches nomeados e hosts de cache inserindo ou removendo elementos XML.

• Os comandos de cluster de cache Start-CacheCluster, Stop-CacheCluster e Restart-CacheCluster envolvem a coordenação do estado do serviço do Windows de host de cache em todos os servidores de cache do cluster. A execução desses comandos pode levar mais tempo quando os hosts principais executam a função de gerenciamento de cluster. É necessário que exista uma maioria de hosts principais em execução enquanto o restante dos hosts de cache são interrompidos e iniciados.

• Sempre inicie e pare o Serviço de Cache com os comandos de cluster de cache Start-CacheCluster, Stop-CacheCluster e Restart-CacheCluster. Poderá ocorrer uma parada se o serviço for iniciado e interrrompido a partir da ferramenta administrativa de serviços. Além disso, esses comandos devem ser executados em uma sessão elevada do Windows PowerShell com privilégios administrativos.

• Os comandos de cluster de cache Stop-CacheCluster ou Restart-CacheCluster fazem com que todos os dados sejam liberados da memória de todos os hosts de cache no cluster.

• Os comandos Set-CacheConfig e Import-CacheClusterConfig exigem que você reinicie o cluster de cache com Restart-CacheCluster para que as alterações sejam efetuadas.

• Os comandos Remove-Cache e New-Cache podem ser usados para alterar uma configuração de cache nomeado sem impactar outros caches nomeados no cluster.

Comandos relacionados ao cluster de cache

A tabela a seguir lista os comandos do Windows PowerShell de Administração de Cache disponíveis para executar operações relacionadas ao cluster.

Comando (RTM)	Comando (QFE)	Descrição
Use-CacheCluster	Connect-AFCacheClusterConfiguration	Define o contexto de sua sessão do Windows PowerShell para o cluster de cache desejado. Quando você iniciar uma sessão do Windows PowerShell, primeiro execute esse comando. Se ele estiver em um host de cache, você deverá executar o comando sem parâmetros, uma vez que eles serão obtidos da configuração de cache do computador. Se você estiver executando o comando de um computador não host, poderá usar os parâmetros a seguir para especificar o cluster de cache desejado. As descrições de parâmetro são: Provider: o provedor usado para armazenar as definições de configuração do cluster. Ela pode ser System.Data.SqlClient ou XML, dependendo de como as informações de configuração estão armazenadas. ConnectionString: a cadeia de conexão para o banco de dados ou local do arquivo de configuração XML.
Start-CacheCluster	Start-AFCacheCluster	Inicia todos os serviços de cache no cluster. Os hosts principais são iniciados primeiro. Observe que os serviços de cache não são iniciados automaticamente após uma reinicialização e, sendo assim, Start-CacheCluster ou Start-CacheHost deve ser chamado para iniciar o serviço. Esse comando exige privilégios de administrador.
Stop-CacheCluster	Stop-AFCacheCluster	Interrompe todos os serviços de cache no cluster. Esse comando exige privilégios de administrador.
Restart-CacheCluster	Restart-AFCacheCluster	Reinicia todos os serviços de cache do cluster na sequência correta. Esse comando exige privilégios de administrador.
Get-CacheClusterHealth	Get-AFCacheClusterHealth	Retorna estatísticas sobre a integridade do cluster de cache.
Export-CacheClusterConfig	Export-AFCacheClusterConfiguration	Projetado para ser usado junto com Import-CacheClusterConfig, esse comando permite editar as definições de configuração de cluster com XML. Para obter mais informações, consulte Editar definições de configuração de cluster. Esse comando exporta as definições de configuração de cluster, como elas existem atualmente no cluster, para o arquivo de configuração baseado em XML especificado. Esse comando pode ser usado independentemente de onde você optou por armazenar suas definições de configuração de cluster (SQL Server ou pasta de rede compartilhada). A descrição do parâmetro é: File: o caminho e o nome totalmente qualificado do arquivo de configuração baseado em XML a ser criado, descrevendo as definições atuais de configuração do cluster de cache. Exemplo: Export-CacheClusterConfig -File c:\Temp\CurrentClusterConfig.xml
Import-CacheClusterConfig	Import-AFCacheClusterConfiguration	Projetado para ser usado junto com Export-CacheClusterConfig, esse comando permite editar as definições de configuração de cluster com XML. Para obter mais informações, consulte Editar definições de configuração de cluster. Esse comando importa as definições de configuração de cluster conforme descrito no arquivo de configuração baseado em XML especificado. Esse comando pode ser usado independentemente de onde você optou por armazenar suas definições de configuração de cluster (SQL Server ou pasta de rede compartilhada). Reinicie o cluster com o Restart-CacheCluster para que as alterações sejam efetivadas. A descrição do parâmetro é: File: o caminho e o nome totalmente qualificado do arquivo de configuração baseado em XML que descreve as definições de configuração do cluster de cache a serem aplicadas ao cluster. Force: importa o arquivo de configuração sem solicitar confirmação. RefreshNow: altera as definições de configuração de cluster de cache do cluster em execução. Atualmente, esse recurso funciona somente com definições relacionadas ao gerenciamento de memória. Entretanto, ainda assim os hosts de cache individuais devem ser reiniciados ou adicionados ao cluster para que as definições de gerenciamento de memória tenham efeito. Exemplo: Import-CacheClusterConfig -File c:\CurrentClusterConfig.xml
Grant-CacheAllowedClientAccount	Grant-AFCacheAllowedClientAccount	Concede um acesso de conta do Windows ao cluster de cache. Por padrão, qualquer conta de administrador nos hosts de cache tem acesso ao cluster de cache. Outras contas devem ser explicitamente adicionadas à lista de contas de cliente permitidas usando esse comando. A descrição do parâmetro é: Account: a conta do Windows para conceder acesso ao cluster de cache. Force: adiciona a conta de cliente especificada sem validar se ela existe.
Revoke-CacheAllowedClientAccount	Revoke-AFCacheAllowedClientAccount	Revoga um acesso de conta do Windows ao cluster de cache. Isso não impedirá os administradores nos hosts de cache de acessar o cluster de cache. A descrição do parâmetro é: Account: a conta do Windows para conceder acesso ao cluster de cache.
Get-Cache	Get-AFCache	Quando usado sem parâmetros, lista informações sobre todos os caches contidos no cluster de cache. Observação Consulte a próxima tabela para obter informações sobre como usar esse comando com o parâmetro HostName.
Update-CacheHostAllowedVersions	Update-AFCacheHostAllowedVersions	Atualiza as variações de versão de hosts de cache e de clientes de cache que têm permissão para acessar o cluster de cache. Atualmente, os números de versão estão relacionados às seguintes versões: 1 = Windows Server AppFabric v1.0 3 = Microsoft AppFabric 1.1 para Windows Server As descrições de parâmetro são: BeginClientVersion: o valor inicial da variação de versão de clientes de cache. EndClientVersion: o valor final da variação de versão de clientes de cache. BeginServerVersion: o valor inicial da variação de versão de host de cache. EndServerVersion: o valor final da variação de versão de host de cache. Para obter mais informações, consulte Procedimento de Atualização para um Cluster de Cache do AppFabric (AppFabric 1.1).
Stop-CacheNonUpdatedHosts	Stop-AFCacheNonUpdatedHosts	Interrompe os hosts de cache cujas versões diferem dos valores de versão especificados. As descrições de parâmetro são: BeginServerVersion: o valor inicial da variação de versão de host de cache. EndServerVersion: o valor final da variação de versão de host de cache. HostTimeout: o tempo limite em segundos a ser aguardado para que cada host de cache seja interrompido. Version: o código de versão da cada host de cache. Para obter mais informações, consulte Procedimento de Atualização para um Cluster de Cache do AppFabric (AppFabric 1.1).
Update-CacheConfigurationStore	Update-AFCacheConfigurationStore	Atualiza o armazenamento de configuração do cache após uma atualização do AppFabric. Ao atualizar para o Microsoft AppFabric 1.1 para Windows Server, causa-se o efeito visível da conversão dos nomes de host do cache para os seus nomes de domínio totalmente qualificados (FQDN) equivalentes.

Comandos relacionados ao host de cache

A tabela a seguir lista os comandos disponíveis para executar operações relacionadas ao host de cache no Windows PowerShell.

Comando (RTM)	Comando (QFE)	Descrição
Get-CacheHost	Get-AFCacheHost	Lista informações sobre o host de cache especificado. Se nenhum parâmetro for aprovado, todos os serviços de cache que são membros do cluster de cache serão listados. Observe que o status Shutting Down indica que há um encerramento normal em andamento. As descrições de parâmetro são: HostName: o nome do host de cache. CachePort: o número da porta de cache do host de cache. Exemplo: Get-CacheHost
Get-CacheHostConfig	Get-AFCacheHostConfiguration	Retorna as informações de configuração sobre o host de cache especificado. As descrições de parâmetro são: HostName: o nome do host de cache. CachePort: o número da porta de cache do host de cache. Exemplo: Get-CacheConfig -HostName CacheServer1 -CachePort 22233
Set-CacheHostConfig	Set-AFCacheHostConfiguration	Atualiza a configuração do host de cache para os valores especificados nos parâmetros de comando. Exceto para HostName e CachePort, todos os parâmetros são opcionais. Para obter mais informações, consulte Editar definições de configuração de cluster. As descrições de parâmetro são: HostName: o nome do host de cache. CachePort: o número atual da porta de cache do host de cache. ClusterPortNumber: o número da porta de cluster usado pelo host de cache. ArbitratorPortNumber: o novo número da porta de arbitragem. ReplicationPortNumber: o novo número da porta de replicação. CacheSize: a quantidade total de memória alocada para armazenar dados no host de cache, em unidades de megabytes (MB). IsLeadHost: o status do host principal para o host de cache ("true" ou "false"). HWM: a porcentagem de marca d' água alta de memória, quando a remoção deve começar a eliminar objetos que ainda não expiraram. LWM: a porcentagem de marca d' água baixa de memória, quando a remoção deve começar a eliminar objetos expirados. Depois de atingir HWM, quando a remoção deve parar de eliminar objetos que ainda não expiraram. Exemplo: Set-CacheConfig -HostName CacheServer1 -CachePort 22233 -LowWM 80
Start-CacheHost	Start-AFCacheHost	Inicia o serviço de cache especificado. Após a reinicialização do servidor de cache, esse comando é obrigatório para permitir que o serviço de cache inclua novamente um cluster de cache em execução. Observe que se o cluster de cache estiver desativado, você deverá usar o comando Start-CacheCluster. Além disso, os serviços de cache não são iniciados automaticamente após uma reinicialização e, sendo assim, Start-CacheHost ou Start-CacheCluster deve ser chamado para iniciar o serviço. As descrições de parâmetro são: HostName: o nome do host de cache. CachePort: o número da porta de cache do host de cache. HostTimeout: o valor de tempo limite em segundos para o host de cache especificado ser iniciado. O padrão é 60 segundos. Exemplo: Start-CacheHost -HostName CacheServer1 -CachePort 22233
Stop-CacheHost	Stop-AFCacheHost	Interrompe o serviço de cache especificado. Observação O comando Stop-CacheHost não interromperá um serviço do Windows de host de cache se ele estiver executando a função de gerenciamento de cluster. A interrupção do host de cache fará com que todo o cluster seja encerrado. Para obter mais informações, consulte Hosts principais e gerenciamento de cluster (Cache do AppFabric 1.1). As descrições de parâmetro são: HostName: o nome do host de cache. CachePort: o número da porta de cache do host de cache. HostTimeout: o valor de tempo limite em segundos para o host de cache especificado ser iniciado. Graceful: especifica que um encerramento normal deve ser iniciado. Um encerramento normal move os itens de cache para outros hosts de cache antes de interromper o Serviço de Cache. Isso evita a perda de dados e que o requisito de clientes de cache repopule esses itens. Observe que o cluster de cache pode ser criado usando o comando New-CacheCluster com a opção GracefulShutdownEnabled para tornar os desligamentos normais o comportamento padrão do comando Stop-CacheHost. Isto também exige que o cluster de cache especifique o GracefulShutdownTimeout. Aviso Apenas inicie um encerramento normal quando tiver certeza de que há servidores e memória restante suficientes para lidar com os itens de cache que são movidos para os servidores em execução. Caso contrário, o encerramento normal poderá travar e deverá ser cancelado. Exemplo: Stop-CacheHost -HostName CacheServer1 -CachePort 22233
Stop-CacheHostShutdown	Stop-AFCacheHostShutdown	Cancela um encerramento normal que está em progresso. O host do cache permanece em execução e nenhum dado é perdido. Balanceamento de carga regular pode ser executado em seguida, caso necessário. As descrições de parâmetro são: HostName: o nome do host de cache. CachePort: o número da porta de cache do host de cache.
Restart-CacheHost	Restart-AFCacheHost	Reinicia o serviço de cache especificado. As configurações são iguais às de Stop-CacheHost.
Get-CacheStatistics	Get-AFCacheStatistics	Mostra estatísticas do host de cache especificado, incluindo: tamanho total (em bytes) e o número de objetos armazenados em cache, regiões, caches nomeados, solicitações e perdas de cache. Observação Consulte a próxima tabela para obter informações sobre como usar esse comando com o parâmetro CacheName. As descrições de parâmetro são: HostName: o nome do host de cache. CachePort: o número da porta de cache do host de cache. Exemplo: Get-CacheStatistics -HostName CacheServer1 -CachePort 22233
Get-Cache	Get-AFCache	Lista todos os caches e regiões que residem no host de cache especificado. As descrições de parâmetro são: HostName: o nome do host de cache. CachePort: o número da porta de cache do host de cache. Exemplo: Get-Cache -HostName CacheServer1 -CachePort 22233
Get-CacheRegion	Get-AFCacheRegion	Retorna uma lista de todas as regiões contidas no cluster de cache. As regiões podem ser apenas criadas ou removidas pelo cliente de cache. Porém, o cluster de cache determina o host do cache em que elas residirão. Todos os parâmetros são opcionais. Observação Consulte a próxima tabela para obter informações sobre como usar esse comando com o parâmetro CacheName. As descrições de parâmetro são: MaxRegions: o número máximo de regiões a serem exibidas. Essa descrição não pode ser usada com o parâmetro MaxRegionsPerHost. MaxRegionsPerHost: o número máximo de regiões a serem exibidas de cada host no cluster de cache. Exemplo: Get-CacheRegion -MaxRegionsPerHost 4

Comandos relacionados ao cache

A tabela a seguir lista os comandos disponíveis para executar operações relacionadas ao cache usando o Windows PowerShell.

Comando (RTM)	Comando (QFE)	Descrição
New-Cache	New-AFCache	Cria um novo cache nomeado quando o cluster está em execução. Todos os valores, exceto para CacheName, são opcionais. Observação Há um limite de 128 caches nomeados. As descrições de parâmetro são: CacheName: o nome do cache. Secondaries: o valor 1 habilita o recurso de alta disponibilidade. O valor 0 desabilita o recurso de alta disponibilidade. O valor padrão é 0. NotificationsEnabled: um valor igual a True habilita o recurso de notificações de cache, enquanto um valor igual a False desabilita-o. Eviction: um valor igual a LRU habilita a remoção Menos Utilizado Recentemente. Um valor igual a None desabilita a remoção. O valor padrão é LRU. Aviso Um valor igual a None pode fazer com que um host de cache fique sem memória. TimeToLive: o tempo limite padrão dos objetos armazenados em cache antes da expiração, em minutos. O valor padrão é 10. Expirable: um valor igual a True habilita a expiração, enquanto False a desabilita. O padrão é Verdadeiro. MinSecondaries: número mínimo de cópias secundárias de um item necessárias para que gravações em tal item sejam bem-sucedidas. O padrão é 0. WriteBehindEnabled: habilita o recurso de escrita atrasada. O padrão é false. WriteBehindInterval: o número de segundos pelo qual um item de cache deve ser gravado no provedor após ser gravado no cache. O mínimo é 60 e o padrão é 300. WriteBehindRetryInterval: o intervalo de tentativas, em segundos, de espera entre tentativas de repetição no caso de uma falha de conexão com o provedor de escrita atrasada. O valor padrão é 60, que também é o valor mínimo. WriteBehindRetryCount: o número máximo de tentativas de conexão com o provedor de escrita atrasada. O padrão é -1, o que significa tentativas infinitas. ReadThroughEnabled: habilita o recurso de read-through. O padrão é false. Provider Type: o nome plenamente qualificado do tipo de montagem do provedor. Esse provedor implanta os recursos escrita atrasada e read-through. O nome diferencia maiúsculas e minúsculas. Por exemplo: RTProvider.Provider, RTProvider, Version=1.0.0.0, Culture=neutral, PublicKeyToken=80e2cb5f6ba933f0. ProviderSettings: um ou mais pares chave/valor que especificam as informações de conexão para o provedor. Por exemplo: @{"setting1"="value1";"setting2"="value2"}. Exemplo: New-Cache -CacheName NamedCache1 -Secondaries 1 -TimeToLive 15
Remove-Cache	Remove-AFCache	Remove um cache nomeado, como especificado pelo parâmetro CacheName. A descrição do parâmetro é: CacheName: o nome do cache. Exemplo: Remove-Cache -CacheName NamedCache1
Get-CacheConfig	Get-AFCacheConfiguration	Retorna os detalhes da configuração do cache nomeado especificado pelo parâmetro CacheName. A descrição do parâmetro é: CacheName: o nome do cache. Exemplo: Get-CacheConfig -CacheName NamedCache1
Set-CacheConfig	Set-AFCacheConfiguration	Atualiza as definições de configuração do cache nomeado, conforme especificado pelo parâmetro CacheName. O cluster de cache pode não estar sendo executado quando o parâmetro CacheName está sendo usado para fazer alterações de cache. Como alternativa, você pode desejar considerar o uso dos comandos Remove-Cache e New-Cache. Esses comandos podem ser usados para alterar uma configuração de cache nomeado sem impactar em outros caches nomeados no cluster, precisando interromper o cluster. Para obter mais informações, consulte Editar definições de configuração de cache com o Windows PowerShell. As descrições de parâmetro são: CacheName: o nome do cache. Secondaries: o valor 1 habilita o recurso de alta disponibilidade. O valor 0 desabilita o recurso de alta disponibilidade. O valor padrão é 0. Observe que apenas os hosts de cache que executam as edições Enterprise ou DataCenter do Windows Server dão suporte para esse recurso. NotificationsEnabled: um valor igual a True habilita o recurso de notificações de cache, enquanto um valor igual a False desabilita-o. Eviction: um valor igual a LRU habilita a remoção Menos Utilizado Recentemente. Um valor igual a None desabilita a remoção. O valor padrão é LRU. Aviso Um valor igual a None pode fazer com que um host de cache fique sem memória. TimeToLive: o tempo limite padrão dos objetos armazenados em cache antes da expiração, em minutos. O valor padrão é 10. Expirable: um valor igual a True habilita a expiração, enquanto False a desabilita. O padrão é Verdadeiro. MinSecondaries: número mínimo de cópias secundárias de um item necessárias para que gravações em tal item sejam bem-sucedidas. O padrão é 0. WriteBehindEnabled: habilita o recurso de escrita atrasada. O padrão é false. WriteBehindInterval: o número de segundos pelo qual um item de cache deve ser gravado no provedor após ser gravado no cache. O mínimo é 60 e o padrão é 300. WriteBehindRetryInterval: o intervalo de tentativas, em segundos, de espera entre tentativas de repetição no caso de uma falha de conexão com o provedor de escrita atrasada. O valor padrão é 60, que também é o valor mínimo. WriteBehindRetryCount: o número máximo de tentativas de conexão com o provedor de escrita atrasada. O padrão é -1, o que significa tentativas infinitas. ReadThroughEnabled: habilita o recurso de read-through. O padrão é false. Provider Type: o nome plenamente qualificado do tipo de montagem do provedor. Esse provedor implanta os recursos escrita atrasada e read-through. O nome diferencia maiúsculas e minúsculas. Por exemplo: RTProvider.Provider, RTProvider, Version=1.0.0.0, Culture=neutral, PublicKeyToken=80e2cb5f6ba933f0. ProviderSettings: um ou mais pares chave/valor que especificam as informações de conexão para o provedor. Por exemplo: @{"setting1"="value1";"setting2"="value2"}. RefreshNow: atualiza as configurações de read-through e escrita atrasada em um cluster de cache em execução. Outras configurações não podem ser atualizadas com este switch. Exemplo: Set-CacheConfig -CacheName NamedCache1 -TimeToLive 30
Get-CacheStatistics	Get-AFCacheStatistics	Retorna estatísticas de um cache nomeado, como especificado pelo parâmetro CacheName. Observação Consulte a tabela anterior para obter informações sobre como usar esse comando com os parâmetros HostName e CachePort. A descrição do parâmetro é: CacheName: o nome do cache. Exemplo: Get-CacheStatistics -CacheName NamedCache1
Get-CacheRegion	Get-AFCacheRegion	Retorna uma lista de todas as regiões em um cache nomeado, como especificado pelo parâmetro CacheName. As regiões podem ser apenas criadas ou removidas pelo cliente de cache. Os controles do cluster de cache em que o host de cache de cada região residirá. Observação Consulte a tabela anterior para obter informações sobre como usar esse comando com os parâmetros HostName e CachePort. A descrição do parâmetro é: CacheName: o nome do cache. Exemplo: Get-CacheRegion -CacheName NamedCache1

Comandos de Gerenciamento do Console

A tabela a seguir lista os comandos disponíveis para executar operações relacionadas ao gerenciamento da ferramenta de administração de cache baseada no Windows PowerShell.

Comando (RTM)	Comando (QFE)	Descrição
Set-CacheLogging	Set-AFCacheLogging	Esse comando habilita o log baseado em arquivo para a sessão de ferramenta de administração de cache baseada no Windows PowerShell. O rastreamento de eventos iniciado por esse comando tem duração apenas nas sessões do Windows PowerShell a partir das quais ele foi chamado. Por padrão, o log é habilitado no nível VERBOSE. O arquivo de log padrão está no diretório %temp% dos usuários com um nome formado pelo prefixo DCacheAdministration seguido pelo identificador do processo e o carimbo de data/hora de criação. Se já existir um arquivo com o mesmo nome, o Windows PowerShell tentará anexar ao arquivo de log. As descrições do parâmetro são: LogLevel: o nível de evento que especifica os tipos de eventos capturados pelo rastreamento. Os valores válidos são NONE, ERROR, WARNING, INFO e VERBOSE. File: um caminho absoluto de pasta ou arquivo em que os logs devem ser gravados. Se o nome do arquivo não for especificado, DCacheAdminTrace[<ProcessId>].log será assumido como padrão, em que <ProcessId> é o número da ID do processo do Windows da sessão do Windows PowerShell. ".log" é acrescentado em todos os nomes de arquivo especificados. Este exemplo cria o arquivo c:\WarningLog.log que captura mensagens de aviso e de erro: Set-CacheLogging -LogLevel WARNING -File c:\WarningLog Este comando rastreia eventos apenas para a sessão do Windows PowerShell, não para o cliente de cache ou o host de cache.
Clear-CacheLogging	Clear-AFCacheLogging	Interrompe o log iniciado por Set-CacheLogging.
Invoke-CacheGC	Invoke-AFCacheGarbageCollector	Chama manualmente a coleta de lixo no cluster de cache para liberar a memória não usada. Esse comando está disponível apenas para circunstâncias especiais. Geralmente, a coleta de lixo é gerenciada pelo .NET Framework e pelos recursos de gerenciamento de memória do cluster de cache do AppFabric.
exit	exit	Sai da sessão do Windows PowerShell.
cls	cls	Limpa a tela do Windows PowerShell.

Consulte também

Conceitos

Configuração de cache com Windows PowerShell (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