Compartir vía


Configuración de caché con Windows PowerShell (Almacenamiento en caché de AppFabric 1.1)

Existen dos formas de configurar el servicio de Microsoft AppFabric 1.1 para el almacenamiento en caché de Windows Server: la interfaz de usuario del asistente para configuración de AppFabric y un conjunto de comandos de Windows PowerShell para el Almacenamiento en caché de AppFabric. En este tema se describen los comandos de Windows PowerShell. Para obtener más información acerca del uso del Asistente para configuración de AppFabric, consulte Configuración del AppFabric.

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. A continuación, deberá importar manualmente el módulo de Windows PowerShell que contiene los comandos de configuración. Esto se muestra en el siguiente ejemplo:

Import-Module DistributedCacheConfiguration

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.

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 configuración:

get-command -module DistributedCacheConfiguration

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 Add-CacheHost:

get-help Add-CacheHost -full

Comandos de configuración

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 configuración. Para obtener más información sobre los comandos de administración, vea Uso de Windows PowerShell para administrar características de almacenamiento en caché de AppFabric 1.1. En la tabla siguiente se muestran los comandos de Windows Powershell disponibles para configurar el Servicio de almacenamiento en caché.

Comando (RTM) Comando (QFE) Descripción

Add-CacheAdmin

Add-AFCacheAdminLocalConfiguration

Configura la administración de caché en el host de caché. Este comando funciona en el servidor localmente.

Add-CacheHost

Add-AFCacheHostLocalConfiguration

Configura un host de caché para habilitarlo de modo que forme parte de un clúster existente. Este comando funciona en el servidor localmente.

Get-CacheClusterInfo

Get-AFCacheCluster

Devuelve información del clúster de caché, incluidos los detalles de su estado de inicialización y su tamaño.

Get-CacheConnectionString

Get-AFCacheTemporaryConnectionString

Devuelve la cadena de conexión temporal que se estableció con el comando Set-CacheConnectionString. Tenga en cuenta que este comando no refleja necesariamente la cadena de conexión que usa el almacén de configuración del clúster de caché.

Nota

Microsoft AppFabric 1.1 para Windows Server usa este comando internamente. No se conoce ningún escenario de usuario que necesite su uso.

New-CacheCluster

New-AFCacheClusterConfiguration

Crea e inicializa un nuevo almacén de configuración de clúster de caché.

Register-CacheHost

Register-AFCacheHost

Agrega un host de caché al almacén de configuración de clúster de caché especificado.

Remove-CacheAdmin

Remove-AFCacheAdminLocalConfiguration

Cancela la configuración de la administración de caché del host de caché. Este comando funciona en el servidor localmente.

Remove-CacheCluster

Remove-AFCacheClusterConfiguration

Quita una configuración de clúster existente.

Remove-CacheHost

Remove-AFCacheHost

Cancela la configuración de un host de caché que actualmente no es miembro de un clúster de caché. Este comando funciona en el servidor localmente.

Set-CacheConfigurationLog

Set-AFCacheConfigurationLogging

Establece una ubicación de archivo de registro personalizada para el registro de comandos de configuración. De forma predeterminada, los registros residen en la carpeta Temp.

Set-CacheConnectionString

Set-AFCacheTemporaryConnectionString

Conserva la cadena de conexión para uso temporal. La cadena se podrá recuperar con Get-CacheConnectionString. Tenga en cuenta que este comando no cambia la cadena de conexión que usa el almacén de configuración de clúster de caché.

Nota

Microsoft AppFabric 1.1 para Windows Server usa este comando internamente. No se conoce ningún escenario de usuario que necesite su uso.

Test-CacheClusterConnection

Test-AFCacheClusterConnection

Prueba la conexión con un almacén de configuración de clúster de caché.

Unregister-CacheHost

Unregister-AFCacheHost

Quita una entrada de host de caché de un almacén de configuración de clúster de caché. Si se está anulando el registro del host actual, el parámetro HostName no es necesario. En este caso, los parámetros Provide y ConnectionString también son opcionales, siempre y cuando el host de caché actual esté configurado y el comando Remove-CacheHost no se haya llamado en el host de caché.

WarningAdvertencia
Para detener un host de caché antes de anular sus registro, es necesario llamar a Stop-CacheHost. Si no se hace esto, se puede producir un bloqueo del servicio.

Vea también

Conceptos

Uso de Windows PowerShell para administrar características de 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