Administración de caché con Windows PowerShell (Almacenamiento en caché de Windows Server AppFabric)

Mediante el uso de Windows PowerShell, puede administrar el clúster de caché, los hosts de caché y la propia memoria caché. Si usa un equipo con la característica Administración de caché instalada, existen dos modos de usar Windows PowerShell para administrar las características de almacenamiento en caché de AppFabric. En el menú Inicio, vaya a Herramientas administrativas y seleccione Módulos de Windows PowerShell. También puede ir al menú Inicio, hacer clic en Todos los programas, Windows Server AppFabric y, a continuación, hacer clic en Administración de almacenamiento en caché de Windows PowerShell.

Nota

En los sistemas operativos Windows Vista, Windows 7 y Windows Server 2008, debe ejecutar Windows PowerShell con privilegios de administrador para que algunos comandos de administración funcionen correctamente. Para el acceso directo Administración de almacenamiento en caché de Windows PowerShell, debe hacer clic con el botón secundario y seleccionar Ejecutar como administrador.

Existen dos categorías principales de comandos de PowerShell para el almacenamiento en caché de AppFabric: de administración y de configuración. Este tema se centra en los comandos de administración. Para obtener más información acerca de los comandos de configuración, vea Configuración de caché con Windows PowerShell (Almacenamiento en caché de Windows Server AppFabric). Las tablas de este tema dividen los comandos de administración en categorías. Algunos comandos aparecen en más de una tabla, donde se muestran parámetros diferentes según se aplican a cada una de las cuatro categorías de comandos:

• Comandos relacionados con el clúster de caché

• Comandos relacionados con el host de caché

• Comandos relacionados con caché

• Comandos de administración de la consola

Obtención de ayuda en la sesión de Windows PowerShell

La información que aparece a continuación proporciona un resumen de los comandos de administración para las características de almacenamiento en caché de AppFabric. Es importante tener en cuenta que también puede obtener ayuda desde la sesión de Windows PowerShell. Por ejemplo, el comando siguiente muestra todos los comandos de administración:

get-command -module DistributedCacheAdministration

Si necesita ayuda sobre un comando en particular, puede usar el comando get-help para obtenerla. Por ejemplo, el comando siguiente muestra la ayuda completa del comando New-Cache:

get-help New-Cache -full

Consideraciones importantes

Al usar los comandos de Windows PowerShell que se describen en este tema, es importante tener en cuenta los aspectos siguientes:

• La identidad de seguridad de la persona que usa estos comandos de Windows PowerShell debe tener privilegios de administrador en todos los servidores de caché del clúster de caché.

• Los valores de parámetro para los comandos distinguen entre mayúsculas y minúsculas. Por ejemplo, si crea una memoria caché denominada NamedCache1, el comando Get-CacheConfig -CacheName namedcache1 no funcionará. Deberán coincidir las mayúsculas y minúsculas, como en Get-CacheConfig -CacheName NamedCache1.

• Al realizar cambios en la configuración XML del clúster mediante los comandos Export-CacheClusterConfig e Import-CacheClusterConfig, puede cambiar las opciones de configuración del clúster (atributos XML) del archivo XML, pero no se permite agregar o quitar cachés con nombre ni hosts de caché mediante la inserción o eliminación de elementos XML.

• Los comandos del clúster de caché Start-CacheCluster, Stop-CacheCluster y Restart-CacheCluster conllevan la coordinación del estado del servicio Windows de host de caché en todos los servidores de caché del clúster. Estos comandos pueden llevar más tiempo si los hosts principales desempeñan el rol de administración de clústeres; debe haber una mayoría de hosts principales en ejecución, mientras que el resto de hosts de caché se detienen e inician.

• Inicie y detenga siempre el servicio de almacenamiento en caché con los comandos Start-CacheCluster, Stop-CacheCluster y Restart-CacheCluster. Si inicia y detiene el servicio desde la herramienta administrativa de los servicios, puede quedar bloqueado. Asimismo, estos comandos deben ejecutarse desde una sesión de Windows PowerShell elevada, con privilegios de administrador.

• Los comandos del clúster de caché Stop-CacheCluster o Restart-CacheCluster hacen que todos los datos se vacíen de la memoria de todos los hosts de caché del clúster.

• Los comandos Set-CacheConfig e Import-CacheClusterConfig requieren el reinicio del clúster de caché con Restart-CacheCluster para que se apliquen los cambios.

• Los comandos Remove-Cache y New-Cache pueden usarse para cambiar la configuración de una memoria caché con nombre sin afectar a otras memorias caché con nombre del clúster.

Comandos relacionados con el clúster de caché

En la siguiente tabla se muestran los comandos de administración de caché de Windows Powershell disponibles para realizar operaciones relacionadas con clústeres.

Comando	Descripción
Use-CacheCluster	Configura el contexto de la sesión de Windows PowerShell en el clúster de caché deseado. Al iniciar una sesión de Windows PowerShell, primero debe ejecutar este comando. Si se encuentra en un host de caché, puede ejecutar el comando sin parámetros, pues estos se obtienen de la configuración de caché del equipo. Si lo ejecuta desde un equipo que no es un host, puede usar estos parámetros para especificar el clúster de caché deseado. Las descripciones de los parámetros (alias) son las siguientes: Provider (P): el proveedor que se usa para almacenar la configuración del clúster. Puede ser System.Data.SqlClient o XML, en función de cómo se almacene la información de configuración. ConnectionString (C): la cadena de conexión a la base de datos o ubicación del archivo XML de configuración.
Start-CacheCluster	Inicia todos los servicios de caché del clúster. Los hosts principales son los primeros en iniciarse. Tenga en cuenta que los servicios de caché no se inician automáticamente después de un reinicio, por lo que debe llamarse a Start-CacheCluster o a Start-CacheHost para iniciar el servicio. Este comando necesita privilegios de administrador.
Stop-CacheCluster	Detiene todos los servicios de caché del clúster. Este comando necesita privilegios de administrador.
Restart-CacheCluster	Reinicia todos los servicios de caché del clúster en la secuencia correcta. Este comando necesita privilegios de administrador.
Get-CacheClusterHealth	Devuelve estadísticas acerca del estado del clúster de caché.
Export-CacheClusterConfig	Este comando está diseñado para usarse junto con Import-CacheClusterConfig y permite editar la configuración del clúster mediante XML. Para obtener más información, vea Edición de valores de configuración del clúster (Almacenamiento en caché de Windows Server AppFabric). Este comando exporta al archivo XML de configuración especificado los parámetros de configuración del clúster, tal y como existen actualmente en él. Este comando puede usarse independientemente de dónde haya elegido almacenar los parámetros de configuración del clúster (en SQL Server o en una carpeta de red compartida). La descripción del parámetro (alias) es: File (F): ruta de acceso completa y nombre del archivo XML de configuración que se debe crear y que describe la configuración actual del clúster de caché. Ejemplo: Export-CacheClusterConfig -File c:\Temp\CurrentClusterConfig.xml
Import-CacheClusterConfig	Este comando está diseñado para usarse junto con Export-CacheClusterConfig y permite editar la configuración del clúster mediante XML. Para obtener más información, vea Edición de valores de configuración del clúster (Almacenamiento en caché de Windows Server AppFabric). Este comando importa la configuración del clúster, tal y como se describe en el archivo XML de configuración especificado. Este comando puede usarse independientemente de dónde haya elegido almacenar los parámetros de configuración del clúster (en SQL Server o en una carpeta de red compartida). Debe reiniciar el clúster mediante Restart-CacheCluster para que los cambios surtan efecto. La descripción del parámetro (alias) es: File (Fi): ruta de acceso completa y nombre del archivo XML de configuración que describe los parámetros de configuración del clúster de caché que deben aplicarse al clúster. Force (Fo): importa el archivo de configuración sin solicitar confirmación. Ejemplo: Import-CacheClusterConfig -File c:\CurrentClusterConfig.xml
Grant-CacheAllowedClientAccount	Concede a una cuenta de Windows acceso al clúster de caché. De forma predeterminada, cualquier cuenta de administrador de los hosts de caché tiene acceso al clúster de caché. Otras cuentas deben agregarse explícitamente a la lista de cuentas de clientes permitidas mediante el uso de este comando. La descripción del parámetro (alias) es: Account (A): la cuenta de Windows a la que se concede acceso al clúster de caché. Force (F): agrega la cuenta de cliente especificada sin validar que existe.
Revoke-CacheAllowedClientAccount	Revoca el acceso al clúster de caché de una cuenta de Windows. Tenga en cuenta que este parámetro no impide que los administradores de los hosts de caché obtengan acceso al clúster de caché. La descripción del parámetro (alias) es: Account (A): la cuenta de Windows a la que se concede acceso al clúster de caché.
Get-Cache	Cuando se usa sin parámetros, muestra información acerca de todas las memorias caché del clúster de caché. Nota Para obtener información sobre el procedimiento para usar este comando con el parámetro HostName, vea la tabla siguiente.

Comandos relacionados con el host de caché

En la siguiente tabla se muestran los comandos disponibles para realizar operaciones relacionadas con el host de caché en Windows PowerShell.

Comando	Descripción
Get-CacheHost	Muestra información acerca del host de caché especificado. Si no se transfieren parámetros, muestra todos los servicios de caché que son miembros del clúster de caché. Las descripciones de los parámetros (alias) son las siguientes: HostName (H): el nombre del host de caché. CachePort (P): el número de puerto de caché del host de caché. Ejemplo: Get-CacheHost
Get-CacheHostConfig	Devuelve información de configuración acerca del host de caché especificado. Las descripciones de los parámetros (alias) son las siguientes: HostName (H): el nombre del host de caché. CachePort (P): el número de puerto de caché del host de caché. Ejemplo: Get-CacheConfig -HostName CacheServer1 -CachePort 22233
Set-CacheHostConfig	Actualiza la configuración del host de caché a los valores especificados en los parámetros del comando. Todos los parámetros son opcionales, salvo HostName y CachePort. Para obtener más información, vea Edición de valores de configuración del clúster (Almacenamiento en caché de Windows Server AppFabric). Las descripciones de los parámetros (alias) son las siguientes: HostName (H): el nombre del host de caché. CachePort (P): el número de puerto de caché actual del host de caché. ClusterPortNumber (CPort): el número de puerto del clúster que usa el host de caché. ArbitratorPortNumber (APort): el nuevo número de puerto de árbitro. ReplicationPortNumber (RPort): el nuevo número de puerto de replicación. CacheSize (Size): la cantidad total de memoria asignada para almacenar datos en el host de caché, en unidades de megabytes (MB). HWM (HWM): el límite superior del porcentaje de memoria, cuando la expulsión debe comenzar a expulsar objetos que aún no han expirado. LWM (LWM): el límite inferior del porcentaje de memoria, cuando la expulsión debe comenzar a expulsar objetos expirados. Después de alcanzar HWM, cuando la expulsión debe dejar de expulsar objetos que no hayan expirado. Ejemplo: Set-CacheConfig -HostName CacheServer1 -CachePort 22233 -LowWM 80
Start-CacheHost	Inicia el servicio de caché especificado. Después de un reinicio del servidor de caché, este comando es necesario para permitir que el servicio de caché vuelva a unirse a un clúster de caché en ejecución. Tenga en cuenta que, si el clúster está apagado, debe usar el comando Start-CacheCluster en su lugar. Asimismo, los servicios de caché no se inician automáticamente después de un reinicio, por lo que debe llamarse a Start-CacheHost o a Start-CacheCluster para iniciar el servicio. Las descripciones de los parámetros (alias) son las siguientes: HostName (HostN): el nombre del host de caché. CachePort (P): el número de puerto de caché del host de caché. HostTimeout(T): el valor del tiempo de espera, en segundos, para iniciar el host de caché especificado. El valor predeterminado es 60 segundos. Ejemplo: Start-CacheHost -HostName CacheServer1 -CachePort 22233
Stop-CacheHost	Detiene el servicio de caché especificado. Nota El comando Stop-CacheHost no detiene un servicio de Windows en el host de caché si desempeña el rol de administración de clústeres y la detención provocaría el apagado de todo el clúster. Para obtener más información, vea Administración de clústeres y hosts principales (Almacenamiento en caché de Windows Server AppFabric). Las descripciones de los parámetros (alias) son las siguientes: HostName (HostN): el nombre del host de caché. CachePort (P): el número de puerto de caché del host de caché. HostTimeout(T): el valor del tiempo de espera, en segundos, para iniciar el host de caché especificado. Ejemplo: Stop-CacheHost -HostName CacheServer1 -CachePort 22233
Get-CacheStatistics	Muestra estadísticas para el host de caché especificado, incluido: tamaño total (en bytes) y número de objetos en caché, regiones, cachés con nombre, solicitudes y perdidas de caché. Nota Para obtener información sobre el procedimiento para usar este comando con el parámetro CacheName, vea la tabla siguiente. Las descripciones de los parámetros (alias) son las siguientes: HostName (H): el nombre del host de caché. CachePort (P): el número de puerto de caché del host de caché. Ejemplo: Get-CacheStatistics -HostName CacheServer1 -CachePort 22233
Get-Cache	Muestra todas las memorias caché y regiones que residen en el host de caché especificado. Las descripciones de los parámetros (alias) son las siguientes: HostName (H): el nombre del host de caché. CachePort (C): el número de puerto de caché del host de caché. Ejemplo: Get-Cache -HostName CacheServer1 -CachePort 22233
Get-CacheRegion	Devuelve una lista de todas las regiones en el clúster de caché. Solo el cliente de caché puede crear o quitar regiones. Sin embargo, el clúster de caché determina el host de caché en el que van a residir. Todos los parámetros son opcionales. Nota Para obtener información sobre el procedimiento para usar este comando con el parámetro CacheName, vea la tabla siguiente. Las descripciones de los parámetros (alias) son las siguientes: MaxRegions: el número máximo de regiones que se deben mostrar. No se puede usar con el parámetro MaxRegionsPerHost. MaxRegionsPerHost: el número máximo de regiones que se deben mostrar desde cada host en el clúster de caché. Ejemplo: Get-CacheRegion -MaxRegionsPerHost 4

Comandos relacionados con caché

En la siguiente tabla se muestran los comandos disponibles para realizar operaciones relacionadas con caché en Windows PowerShell.

Comando	Descripción
New-Cache	Crea una nueva memoria caché con nombre cuando el clúster está en ejecución. Son opcionales todos los valores salvo CacheName. Nota Hay un límite de 128 cachés con nombre. Las descripciones de los parámetros (alias) son las siguientes: CacheName (N): el nombre de la memoria caché. Secondaries (S): el valor 1 habilita la característica de alta disponibilidad. el valor 0 deshabilita la característica de alta disponibilidad. El valor predeterminado es 0. NotificationsEnabled (Notif): el valor True habilita la característica de notificaciones de caché, mientras que el valor False la deshabilita. Eviction (Evict): el valor LRU habilita la expulsión de los usados hace más tiempo. El valor None deshabilita la expulsión. El valor predeterminado es LRU. Advertencia El valor None puede provocar que un host de caché se quede sin memoria. TimeToLive (T): el tiempo de espera predeterminado, en minutos, para los objetos almacenados en caché antes de que expiren. El valor predeterminado es 10. Expirable: el valor True habilita la expiración, mientras que False la deshabilita. El valor predeterminado es True. Ejemplo: New-Cache -CacheName NamedCache1 -Secondaries 1 -TimeToLive 15
Remove-Cache	Quita una memoria caché con nombre, según especifica el parámetro CacheName. La descripción del parámetro (alias) es: CacheName (N): el nombre de la memoria caché. Ejemplo: Remove-Cache -CacheName NamedCache1
Get-CacheConfig	Devuelve los detalles de configuración para la memoria caché con nombre que especifica el parámetro CacheName. La descripción del parámetro (alias) es: CacheName (N): el nombre de la memoria caché. Ejemplo: Get-CacheConfig -CacheName NamedCache1
Set-CacheConfig	Actualiza la configuración de la memoria caché con nombre, según especifica el parámetro CacheName. Es posible que el clúster de caché no esté en ejecución al usar el parámetro CacheName para realizar cambios de caché. De manera alternativa, puede considerar el uso de los comandos Remove-Cache y New-Cache. Estos comandos pueden usarse para cambiar la configuración de una memoria caché con nombre sin afectar a otras memorias caché con nombre del clúster por tener que detener el clúster. Para obtener más información, vea Edición de valores de configuración de caché con Windows PowerShell (Almacenamiento en caché de Windows Server AppFabric). Las descripciones de los parámetros (alias) son las siguientes: CacheName (N): el nombre de la memoria caché. Secondaries (S): el valor 1 habilita la característica de alta disponibilidad. El valor 0 deshabilita la característica de alta disponibilidad. El valor predeterminado es 0. Tenga en cuenta que esta característica solo se admite para los hosts de caché que ejecutan las ediciones Enterprise o DataCenter de Windows Server. NotificationsEnabled (Notif): el valor True habilita la característica de notificaciones de caché, mientras que el valor False la deshabilita. Eviction (Evict): el valor LRU habilita la expulsión de los usados hace más tiempo. El valor None deshabilita la expulsión. El valor predeterminado es LRU. Advertencia El valor None puede provocar que un host de caché se quede sin memoria. TimeToLive (T): el tiempo de espera predeterminado, en minutos, para los objetos almacenados en caché antes de que expiren. El valor predeterminado es 10. Expirable: el valor True habilita la expiración, mientras que False la deshabilita. El valor predeterminado es True. Ejemplo: Set-CacheConfig -CacheName NamedCache1 -TimeToLive 30
Get-CacheStatistics	Devuelve estadísticas de una memoria caché con nombre, según especifica el parámetro CacheName. Nota Para obtener información sobre el procedimiento para usar este comando con los parámetros HostName y CachePort, vea la tabla anterior. La descripción del parámetro (alias) es: CacheName (N): el nombre de la memoria caché. Ejemplo: Get-CacheStatistics -CacheName NamedCache1
Get-CacheRegion	Devuelve una lista de todas las regiones de una memoria caché con nombre, según especifica el parámetro CacheName. Solo el cliente de caché puede crear o quitar regiones. El clúster de caché controla en qué host de caché residirá cada región. Nota Para obtener información sobre el procedimiento para usar este comando con los parámetros HostName y CachePort, vea la tabla anterior. La descripción del parámetro (alias) es: CacheName (N): el nombre de la memoria caché. Ejemplo: Get-CacheRegion -CacheName NamedCache1

Comandos de administración de la consola

En la siguiente tabla se muestran los comandos disponibles para realizar operaciones relacionadas con la administración de la herramienta de administración de caché basada en Windows PowerShell.

Comando	Descripción
Set-CacheLogging	Este comando habilita el registro en archivos para la sesión de herramientas de administración de caché basada en Windows PowerShell. El seguimiento de eventos que se inicia mediante este comando dura únicamente lo que duren las sesiones de Windows PowerShell desde las cuales se llamó. De forma predeterminada, el registro está habilitado en el nivel VERBOSE. El archivo de registro predeterminado se encuentra en el directorio %temp% de los usuarios con un nombre que consta del prefijo DCacheAdministration seguido del identificador del proceso y la marca de hora de creación. Si ya existe un archivo con el mismo nombre, Windows PowerShell intenta anexarlo al archivo de registro. Las descripciones de los parámetros (alias) son: LogLevel (L): el nivel de evento que especifica los tipos de eventos que captura el seguimiento. Los valores válidos son NONE, ERROR, WARNING, INFO y VERBOSE. File (F): una ruta de acceso absoluta a la carpeta o archivo donde deben almacenarse los registros. Si no se especifica el nombre de archivo, tomará de forma predeterminada el valor DCacheAdminTrace[<ProcessId>].log, donde <ProcessId> es el número del identificador de proceso de Windows de la sesión de Windows PowerShell. ".log" se anexa a todos los nombres de archivo que se especifiquen. Este ejemplo crea el archivo c:\WarningLog.log, que captura mensajes de advertencia y error: Set-CacheLogging -LogLevel WARNING -File c:\WarningLog Este comando realiza un seguimiento de eventos solo para la sesión de Windows PowerShell, y no para el cliente de caché o el host de caché.
Invoke-GC	Invoca manualmente la recopilación de elementos sin usar en el clúster de caché para liberar la memoria sin usar. Esto solamente está disponible para circunstancias especiales. La recopilación de elementos sin usar suele ser administrada por .NET Framework y las características de administración de memoria del clúster de caché de AppFabric.
Get-Help	Proporciona información de ayuda para todos los comandos admitidos. Esta palabra clave también puede usarse con un carácter "*" para filtrar la cantidad de información de ayuda mostrada, como por ejemplo: Get-Help new* Get-Help Start* Get-Help *cache Get-Help *cachehost
exit	Cierra la sesión de Windows PowerShell.
cls	Borra la pantalla de Windows PowerShell.

Vea también

Conceptos

Configuración de caché con Windows PowerShell (Almacenamiento en caché de Windows Server AppFabric)
Valores de configuración (Almacenamiento en caché de Windows Server AppFabric)
Opciones de configuración de almacenamiento en caché de Windows Server AppFabric
Solución de problemas de almacenamiento en caché de Windows Server AppFabric
Conceptos de almacenamiento en caché de Windows Server AppFabric
Desarrollo de un cliente de caché (Almacenamiento en caché de Windows Server AppFabric)

  2011-12-05