使用 Windows PowerShell 进行缓存管理 (AppFabric 1.1)

Use-CacheCluster

Connect-AFCacheClusterConfiguration

将 Windows PowerShell 会话的上下文设置为所需缓存群集。

启动 Windows PowerShell 会话时，必须首先运行此命令。如果此命令位于缓存主机上，则运行不含有参数的命令，因为参数从计算机上的缓存配置中获得。如果您从非主机运行此命令，则可以使用以下参数指定所需缓存群集。

参数描述如下：

• Provider：用于存储群集配置设置的提供程序。可以是 System.Data.SqlClient 或 XML，取决于存储配置信息的方式。
  
  
• ConnectionString：XML 配置文件的数据库或位置的连接字符串。
  
  

Stop-CacheCluster

Stop-AFCacheCluster

停止群集中所有缓存服务。此命令需要管理员特权。

Get-CacheClusterHealth

Get-AFCacheClusterHealth

返回有关缓存群集运行状况的统计信息。

Import-CacheClusterConfig

Import-AFCacheClusterConfiguration

旨在与 Export-CacheClusterConfig 配合使用，此命令使您可以编辑具有 XML 的群集配置设置。有关详细信息，请参阅编辑群集配置设置。

此命令导入群集配置设置，如指定的基于 XML 的配置文件中所述。无论选择将群集配置设置存储在哪个位置（SQL Server 或共享网络文件夹），都可以使用此命令。

必须使用 Restart-CacheCluster 重新启动群集才能使任何更改生效。

参数描述如下：

• File：基于 XML 的配置文件的完全限定路径和名称，描述应用于群集的缓存群集配置设置。
  
  
• Force：导入配置文件而不提示确认。
  
  
• RefreshNow：更改正在运行的群集的缓存群集配置设置。该项当前只对与内存管理有关的设置起作用。但是，若要使内存管理设置生效，必须重新启动或向群集中添加各个缓存主机。
  
  

示例：Import-CacheClusterConfig -File c:\CurrentClusterConfig.xml

Revoke-CacheAllowedClientAccount

Revoke-AFCacheAllowedClientAccount

吊销对缓存群集的 Windows 帐户访问权限。请注意，这将不会阻止缓存主机上的管理员访问缓存群集。

参数描述如下：

• Account：授予对缓存群集的访问权限的 Windows 帐户。
  
  

Update-CacheHostAllowedVersions

Update-AFCacheHostAllowedVersions

更新那些可以访问缓存群集的缓存主机及缓存客户端的版本范围。当前，版本号与运行版本有关：

• 1 = Windows Server AppFabric v1.0
  
  
• 3 = Microsoft AppFabric 1.1 for Windows Server
  
  

参数描述如下：

1. BeginClientVersion：缓存客户端版本范围的起始值。
   
   
2. EndClientVersion：缓存客户端版本范围的终止值。
   
   
3. BeginServerVersion：缓存主机版本范围的起始值。
   
   
4. EndServerVersion：缓存主机版本范围的终止值。
   
   

有关详细信息，请参阅AppFabric 缓存群集(AppFabric 1.1)的升级步骤。

Update-CacheConfigurationStore

Update-AFCacheConfigurationStore

在升级 AppFabric 之后，更新缓存配置存储。当升级到 Microsoft AppFabric 1.1 for Windows Server 时，该操作具有将缓存主机名称转换为其等效完全限定的域名 (FQDN) 的可视效果。

Get-CacheHost

Get-AFCacheHost

列出有关指定缓存主机的信息。如果未传递任何参数，则列出作为缓存群集成员的所有缓存服务。请注意，Shutting Down 的状态指示正在进行正常关闭。

参数描述如下：

• HostName：缓存主机的名称。
  
  
• CachePort：缓存主机的缓存端口号。
  
  

示例：Get-CacheHost

Set-CacheHostConfig

Set-AFCacheHostConfiguration

将缓存主机配置更新为命令参数中指定的值。除了 HostName 和 CachePort 之外，所有参数均为可选参数。有关详细信息，请参阅编辑群集配置设置。

参数描述如下：

• HostName：缓存主机的名称。
  
  
• CachePort：缓存主机的当前缓存端口号。
  
  
• ClusterPortNumber：缓存主机使用的群集端口号。
  
  
• ArbitratorPortNumber：新的仲裁程序端口号。
  
  
• ReplicationPortNumber：新的复制端口号。
  
  
• CacheSize：分配用于在缓存主机上存储数据的内存总量，单位兆字节 (MB)。
  
  
• IsLeadHost：缓存主机的主要主机状态（“true”或“false”）。
  
  
• HWM：内存高水印百分比（逐出应开始退出尚未过期的对象时）。
  
  
• LWM：内存低水印百分比（逐出应开始退出过期的对象时）。到达 HWM 之后，逐出应停止尚未过期的对象时。
  
  

示例：Set-CacheConfig -HostName CacheServer1 -CachePort 22233 -LowWM 80

Stop-CacheHost

Stop-AFCacheHost

停止指定缓存服务。

参数描述如下：

• HostName：缓存主机的名称。
  
  
• CachePort：缓存主机的缓存端口号。
  
  
• HostTimeout：启动指定缓存主机的超时值（以秒为单位）。
  
  

• Graceful：指定应启动正常关闭。正常关闭会在停止缓存服务之前，将缓存项目移至其他缓存主机。此行为既可避免数据丢失，又可以避免缓存客户端重新填充这些项目。注意缓存群集可以使用 New-CacheCluster 命令和 GracefulShutdownEnabled 选项创建，后者用于使 Stop-CacheHost 命令的默认行为正常关闭。该操作还需要缓存群集以指定 GracefulShutdownTimeout。
  
  

  警告

  仅当您已验证有足够的服务器和剩余内存来处理移至正在运行的服务器的缓存项目时，才启动正常关闭。否则，正常关闭可能挂起，因而必须取消。

示例：Stop-CacheHost -HostName CacheServer1 -CachePort 22233

Restart-CacheHost

Restart-AFCacheHost

重新启动指定的缓存服务。这些设置与 Stop-CacheHost 的设置相同。

Get-Cache

Get-AFCache

列出驻留在指定缓存主机上的所有缓存和区域。

参数描述如下：

• HostName：缓存主机的名称。
  
  
• CachePort：缓存主机的缓存端口号。
  
  

示例：Get-Cache -HostName CacheServer1 -CachePort 22233

New-Cache

New-AFCache

在群集运行时，创建新的命名缓存。除 CacheName 以外的所有值均为可选。

参数描述如下：

• CacheName：缓存的名称。
  
  
• Secondaries：值 1 启用高可用性功能。值 0 禁用高可用性功能。默认值为 0。
  
  
• NotificationsEnabled：True 值启用缓存通知功能，而 False 值禁用该功能。
  
  

• Eviction：值 LRU 启用“最近最少使用的”逐出。值 None 禁用逐出。默认值为 LRU。
  
  

  警告

  值 None 可能导致缓存主机内存不足。

• TimeToLive：缓存中存储的对象在过期之前的默认超时值（以分钟为单位）。默认值为 10。
  
  
• Expirable：值 True 启用过期，而 False 禁用过期。默认值为 True。
  
  
• MinSecondaries：为了在项目上成功执行写入操作，必须为此项目提供的最小辅助副本数量。默认值为 0。
  
  
• WriteBehindEnabled：启用 write-behind（事后写入）功能。默认值为 false。
  
  
• WriteBehindInterval：当缓存项写入缓存后，将其写入到提供程序时所需要的时间（以秒为单位）。最小值为 60，默认值为 300。
  
  
• WriteBehindRetryInterval：与 write-behind（事后写入）提供程序的连接失败时，每两次重试之间需等待的时间间隔（以秒为单位）。默认值为 60，该值也是最小值。
  
  
• WriteBehindRetryCount：重新尝试连接 write-behind（事后写入）提供程序的最大次数。默认值为 -1，表示可以无限次重新尝试。
  
  
• ReadThroughEnabled：启用 read-through（同步读取）功能。默认值为 false。
  
  
• Provider Type：提供程序程序集类型的完全限定的名称。此提供程序可实现 write-behind（事后写入）和 read-through（同步读取）功能。名称区分大小写。例如：RTProvider.Provider, RTProvider, Version=1.0.0.0, Culture=neutral, PublicKeyToken=80e2cb5f6ba933f0.
  
  
• ProviderSettings：一个或多个指定提供程序连接信息的键/值对。例如：@{"setting1"="value1";"setting2"="value2"}.
  
  

示例：New-Cache -CacheName NamedCache1 -Secondaries 1 -TimeToLive 15

Get-CacheConfig

Get-AFCacheConfiguration

返回由 CacheName 参数指定的命名缓存的配置详细信息。

参数描述如下：

• CacheName：缓存的名称。
  
  

示例：Get-CacheConfig -CacheName NamedCache1

Get-CacheStatistics

Get-AFCacheStatistics

返回命名缓存的统计信息（由 CacheName 参数指定）。

参数描述如下：

• CacheName：缓存的名称。
  
  

示例：Get-CacheStatistics -CacheName NamedCache1

Set-CacheLogging

Set-AFCacheLogging

此命令对基于 Windows PowerShell 的缓存管理工具会话启用基于文件的日志记录。此命令初始化的事件跟踪只持续调用 Windows PowerShell 会话时的一段时间。

默认情况下，在 VERBOSE 级别启用日志记录。默认日志文件位于用户 %temp% 目录中，名称前缀为 DCacheAdministration，其后跟进程标识符和创建时间戳。

如果同名文件已存在，Windows PowerShell 将尝试附加到日志文件。

参数描述如下：

• LogLevel：用于指定跟踪所捕获的事件类型的事件级别。有效值为 NONE、ERROR、WARNING、INFO 和 VERBOSE。
  
  
• File：日志应写入的文件夹或文件的绝对路径。如果未指定文件名，则默认为 DCacheAdminTrace[<ProcessId>].log，其中 <ProcessId> 为 Windows PowerShell 会话的 Windows 进程 ID 号。".log" 附加到指定的所有文件名称。
  
  

本示例创建捕获警告和错误消息的文件 c:\WarningLog.log：

Set-CacheLogging -LogLevel WARNING -File c:\WarningLog

此命令只跟踪 Windows PowerShell 会话（而非缓存客户端或缓存主机）的事件。

Invoke-CacheGC

Invoke-AFCacheGarbageCollector

手动调用缓存群集上的垃圾回收以释放未使用的内存。此操作只可用于特殊情况。通常，垃圾回收由 .NET Framework 和 AppFabric 缓存群集的内存管理功能进行管理。

cls

cls

清除 Windows PowerShell 屏幕。