Administración de caché con Windows PowerShell (AppFabric 1.1)

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, puede ir al menú Inicio, hacer clic en Todos los programas, Microsoft AppFabric 1.1 para Windows Server y, a continuación, seleccionar Administración de almacenamiento en caché de Windows PowerShell.

Nota

Debe ejecutar Windows PowerShell con privilegios administrativos para que algunos comandos de administración funcionen correctamente. Para el acceso directo Administración de almacenamiento en caché de Windows PowerShell, haga 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 AppFabric 1.1). 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

Cambios de nombre de los comandos en Actualización de AppFabric 1.1 de marzo de 2012

La actualización Actualización de AppFabric 1.1 de marzo de 2012 incluía cambios de nombre de los comandos de Windows PowerShell para AppFabric. Estos cambios mejoran la comprensión y coherencia de los comandos. Las tablas siguientes incluyen el nombre original del comando (RTM) y el nombre del comando de marzo de 2012 (QFE).

Para conservar la compatibilidad retroactiva, se proporciona un script de PowerShell que aplica alias con los nombres de comando anteriores a los nuevos comandos. Todos los cambios en los nombres de parámetros tienen un alias en el propio módulo de PowerShell.

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 (RTM)	Comando (QFE)	Descripción
Use-CacheCluster	Connect-AFCacheClusterConfiguration	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 son las siguientes: Provider: 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: la cadena de conexión a la base de datos o ubicación del archivo XML de configuración.
Start-CacheCluster	Start-AFCacheCluster	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	Stop-AFCacheCluster	Detiene todos los servicios de caché del clúster. Este comando necesita privilegios de administrador.
Restart-CacheCluster	Restart-AFCacheCluster	Reinicia todos los servicios de caché del clúster en la secuencia correcta. Este comando necesita privilegios de administrador.
Get-CacheClusterHealth	Get-AFCacheClusterHealth	Devuelve estadísticas acerca del estado del clúster de caché.
Export-CacheClusterConfig	Export-AFCacheClusterConfiguration	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, consulte Edición de valores de configuración del clúster. 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 es: File: 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	Import-AFCacheClusterConfiguration	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, consulte Edición de valores de configuración del clúster. 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 es: File: 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: importa el archivo de configuración sin solicitar confirmación. RefreshNow: cambia los valores de configuración del clúster de caché del clúster en ejecución. Por el momento, esto solo funciona con los valores relacionados con la administración de la memoria. No obstante, incluso en estos casos, los hosts de caché individuales deben reiniciarse o agregarse al clúster para que los valores de configuración de la administración de la memoria surtan efecto. Ejemplo: Import-CacheClusterConfig -File c:\CurrentClusterConfig.xml
Grant-CacheAllowedClientAccount	Grant-AFCacheAllowedClientAccount	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 es: Account: la cuenta de Windows a la que se concede acceso al clúster de caché. Force: agrega la cuenta de cliente especificada sin validar que existe.
Revoke-CacheAllowedClientAccount	Revoke-AFCacheAllowedClientAccount	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 es: Account: la cuenta de Windows a la que se concede acceso al clúster de caché.
Get-Cache	Get-AFCache	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.
Update-CacheHostAllowedVersions	Update-AFCacheHostAllowedVersions	Actualiza el intervalo de versiones de hosts de caché y los clientes de caché con acceso permitido al clúster de caché. En este momento, los números de versión hacen referencia a las siguientes versiones: 1 = Windows Server AppFabric v1.0 3 = Microsoft AppFabric 1.1 para Windows Server Las descripciones de los parámetros son las siguientes: BeginClientVersion: valor inicial del intervalo de versiones del cliente de caché. EndClientVersion: valor final del intervalo de versiones del cliente de caché. BeginServerVersion: valor inicial del intervalo de versiones del host de caché. EndServerVersion: valor final del intervalo de versiones del host de caché. Para obtener más información, consulte Procedimiento de actualización para un clúster de caché de AppFabric (AppFabric 1.1).
Stop-CacheNonUpdatedHosts	Stop-AFCacheNonUpdatedHosts	Detiene los hosts de caché cuya versión difiere de los valores de versión especificados. Las descripciones de los parámetros son las siguientes: BeginServerVersion: valor inicial del intervalo de versiones del host de caché. EndServerVersion: valor final del intervalo de versiones del host de caché. HostTimeout: tiempo de espera, en segundos, para la detención de cada host. Version: versión del código del host de caché. Para obtener más información, consulte Procedimiento de actualización para un clúster de caché de AppFabric (AppFabric 1.1).
Update-CacheConfigurationStore	Update-AFCacheConfigurationStore	Actualiza el almacén de configuración de la caché tras la actualización de AppFabric. Al actualizar a Microsoft AppFabric 1.1 para Windows Server, el efecto visual resultante es la traducción de los nombres de host de caché a su nombre de dominio completo (FQDN) equivalente.

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 (RTM)	Comando (QFE)	Descripción
Get-CacheHost	Get-AFCacheHost	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é. Observe que el estado de Shutting Down indica que un cierre estable está en curso. Las descripciones de los parámetros son las siguientes: HostName: el nombre del host de caché. CachePort: el número de puerto de caché del host de caché. Ejemplo: Get-CacheHost
Get-CacheHostConfig	Get-AFCacheHostConfiguration	Devuelve información de configuración acerca del host de caché especificado. Las descripciones de los parámetros son las siguientes: HostName: el nombre del host de caché. CachePort: el número de puerto de caché del host de caché. Ejemplo: Get-CacheConfig -HostName CacheServer1 -CachePort 22233
Set-CacheHostConfig	Set-AFCacheHostConfiguration	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, consulte Edición de valores de configuración del clúster. Las descripciones de los parámetros son las siguientes: HostName: el nombre del host de caché. CachePort: el número de puerto de caché actual del host de caché. ClusterPortNumber: el número de puerto del clúster que usa el host de caché. ArbitratorPortNumber: el nuevo número de puerto de árbitro. ReplicationPortNumber: el nuevo número de puerto de replicación. CacheSize: la cantidad total de memoria asignada para almacenar datos en el host de caché, en unidades de megabytes (MB). IsLeadHost: estado del host principal con respecto al host de caché ("verdadero" o "falso"). 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: 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	Start-AFCacheHost	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 son las siguientes: HostName: el nombre del host de caché. CachePort: el número de puerto de caché del host de caché. HostTimeout: 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	Stop-AFCacheHost	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 AppFabric 1.1). Las descripciones de los parámetros son las siguientes: HostName: el nombre del host de caché. CachePort: el número de puerto de caché del host de caché. HostTimeout: el valor del tiempo de espera, en segundos, para iniciar el host de caché especificado. Graceful: especifica la inicialización de un cierre estable. Un cierre estable traslada los elementos de la caché a otros host de caché antes de detener el Servicio de almacenamiento en caché. Esto evita la pérdida de datos y el requisito de los clientes de la caché de repoblar dichos elementos. Tenga en cuenta que todo el clúster de caché se puede crear mediante el comando New-CacheCluster con la opción GracefulShutdownEnabled para que el comportamiento predeterminado del comando Stop-CacheHost sea el cierre estable. Para ello también es necesario que el clúster de caché especifique el GracefulShutdownTimeout. Advertencia Inicie un cierre estable solamente cuando haya comprobado que hay servidores y memoria restante suficientes como para gestionar los elementos de caché que se traslada a los servidores en ejecución. De lo contrario, el cierre estable podría bloquearse y deberá cancelarse. Ejemplo: Stop-CacheHost -HostName CacheServer1 -CachePort 22233
Stop-CacheHostShutdown	Stop-AFCacheHostShutdown	Cancela un cierre estable en curso. El host de caché sigue ejecutándose. Los datos no se pierden. Si es necesario, puede ir seguido de un equilibrio de carga regular. Las descripciones de los parámetros son las siguientes: HostName: el nombre del host de caché. CachePort: el número de puerto de caché del host de caché.
Restart-CacheHost	Restart-AFCacheHost	Reinicia el servicio de caché especificado. Los valores de configuración son los mismos que para Stop-CacheHost.
Get-CacheStatistics	Get-AFCacheStatistics	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 son las siguientes: HostName: el nombre del host de caché. CachePort: el número de puerto de caché del host de caché. Ejemplo: Get-CacheStatistics -HostName CacheServer1 -CachePort 22233
Get-Cache	Get-AFCache	Muestra todas las memorias caché y regiones que residen en el host de caché especificado. Las descripciones de los parámetros son las siguientes: HostName: el nombre del host de caché. CachePort: el número de puerto de caché del host de caché. Ejemplo: Get-Cache -HostName CacheServer1 -CachePort 22233
Get-CacheRegion	Get-AFCacheRegion	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 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 (RTM)	Comando (QFE)	Descripción
New-Cache	New-AFCache	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 son las siguientes: CacheName: el nombre de la memoria caché. Secondaries: 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: el valor True habilita la característica de notificaciones de caché, mientras que el valor False la deshabilita. Eviction: 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: 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. MinSecondaries: número mínimo de copias secundarias de un elemento necesarias para que las operaciones de escritura se realicen correctamente. El valor predeterminado es 0. WriteBehindEnabled: habilita la característica de escritura en segundo plano. El valor predeterminado es false. WriteBehindInterval: el número de segundos durante los cuales se escribe un elemento de caché para el proveedor, una vez se ha escrito en la caché. El valor mínimo es 60 y el valor predeterminado es 300. WriteBehindRetryInterval: el intervalo de reintento, en segundos, que debe esperarse entre cada reintento en caso de que falle la conexión al proveedor de escritura en segundo plano. El valor predeterminado es 60, que es también el valor mínimo. WriteBehindRetryCount: el número máximo de reintentos de conexión con el proveedor de escritura en segundo plano. El valor predeterminado es -1, que significa un número infinito de reintentos. ReadThroughEnabled: habilita la característica de escritura en primer plano. El valor predeterminado es false. Provider Type: nombre completo del tipo de ensamblado del proveedor. Este proveedor implementa las características de escritura en segundo plano y de lectura en primer plano. El nombre distingue entre mayúsculas y minúsculas. Por ejemplo: RTProvider.Provider, RTProvider, Version=1.0.0.0, Culture=neutral, PublicKeyToken=80e2cb5f6ba933f0. ProviderSettings: uno o más pares de clave/valor que especifican la información de conexión del proveedor. Por ejemplo: @{"setting1"="value1";"setting2"="value2"}. Ejemplo: New-Cache -CacheName NamedCache1 -Secondaries 1 -TimeToLive 15
Remove-Cache	Remove-AFCache	Quita una memoria caché con nombre, según especifica el parámetro CacheName. La descripción del parámetro es: CacheName: el nombre de la memoria caché. Ejemplo: Remove-Cache -CacheName NamedCache1
Get-CacheConfig	Get-AFCacheConfiguration	Devuelve los detalles de configuración para la memoria caché con nombre que especifica el parámetro CacheName. La descripción del parámetro es: CacheName: el nombre de la memoria caché. Ejemplo: Get-CacheConfig -CacheName NamedCache1
Set-CacheConfig	Set-AFCacheConfiguration	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, consulte Edición de valores de configuración de caché con Windows PowerShell. Las descripciones de los parámetros son las siguientes: CacheName: el nombre de la memoria caché. Secondaries: 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: el valor True habilita la característica de notificaciones de caché, mientras que el valor False la deshabilita. Eviction: 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: 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. MinSecondaries: número mínimo de copias secundarias de un elemento necesarias para que las operaciones de escritura se realicen correctamente. El valor predeterminado es 0. WriteBehindEnabled: habilita la característica de escritura en segundo plano. El valor predeterminado es false. WriteBehindInterval: el número de segundos durante los cuales se escribe un elemento de caché para el proveedor, una vez se ha escrito en la caché. El valor mínimo es 60 y el valor predeterminado es 300. WriteBehindRetryInterval: el intervalo de reintento, en segundos, que debe esperarse entre cada reintento en caso de que falle la conexión al proveedor de escritura en segundo plano. El valor predeterminado es 60, que es también el valor mínimo. WriteBehindRetryCount: el número máximo de reintentos de conexión con el proveedor de escritura en segundo plano. El valor predeterminado es -1, que significa un número infinito de reintentos. ReadThroughEnabled: habilita la característica de escritura en primer plano. El valor predeterminado es false. Provider Type: nombre completo del tipo de ensamblado del proveedor. Este proveedor implementa las características de escritura en segundo plano y de lectura en primer plano. El nombre distingue entre mayúsculas y minúsculas. Por ejemplo: RTProvider.Provider, RTProvider, Version=1.0.0.0, Culture=neutral, PublicKeyToken=80e2cb5f6ba933f0. ProviderSettings: uno o más pares de clave/valor que especifican la información de conexión del proveedor. Por ejemplo: @{"setting1"="value1";"setting2"="value2"}. RefreshNow: actualiza los valores de configuración de escritura en primer y segundo plano en un clúster de caché en ejecución. Con este botón no se pueden actualizar otros valores de configuración. Ejemplo: Set-CacheConfig -CacheName NamedCache1 -TimeToLive 30
Get-CacheStatistics	Get-AFCacheStatistics	Devuelve estadísticas de una memoria caché con nombre, según especifica el parámetro CacheName. Nota Consulte la tabla anterior para obtener información sobre el procedimiento para usar este comando con los parámetros HostName y CachePort. La descripción del parámetro es: CacheName: el nombre de la memoria caché. Ejemplo: Get-CacheStatistics -CacheName NamedCache1
Get-CacheRegion	Get-AFCacheRegion	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 Consulte la tabla anterior para obtener información sobre el procedimiento para usar este comando con los parámetros HostName y CachePort. La descripción del parámetro es: CacheName: 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 (RTM)	Comando (QFE)	Descripción
Set-CacheLogging	Set-AFCacheLogging	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 son: LogLevel: 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: 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é.
Clear-CacheLogging	Clear-AFCacheLogging	Detiene el registro iniciado por Set-CacheLogging.
Invoke-CacheGC	Invoke-AFCacheGarbageCollector	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.
exit	exit	Cierra la sesión de Windows PowerShell.
cls	cls	Borra la pantalla de Windows PowerShell.

Vea también

Conceptos

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

  2012-04-05