共用方式為

使用 Windows PowerShell 來管理快取 (Windows Server AppFabric 快取)

  • 發行項

透過使用 Windows PowerShell，您可以管理快取叢集、快取主機以及快取本身。如果您使用的電腦已安裝「快取管理」功能，使用 Windows PowerShell 來管理 AppFabric 的快取功能共有兩種方法。移至 [開始] 功能表上的 [系統管理工具]，然後選取 [Windows PowerShell 模組]。或者，您可以移至 [開始] 功能表，依序按一下 [所有程式] 及 [Windows Server AppFabric]，然後按一下 [快取管理 Windows PowerShell]。

注意

在 Windows Vista、Windows 7 與 Windows Server 2008 作業系統上，您必須使用系統管理權限來執行 Windows PowerShell，某些系統管理命令才能正常運作。對於 [快取管理 Windows PowerShell] 捷徑，您必須在該捷徑上按一下滑鼠右鍵，然後選取 [以系統管理員身分執行]。

AppFabric 快取 PowerShell 命令有兩種主要類別：系統管理命令與設定命令。本主題著重於系統管理命令。如需有關設定命令的詳細資訊，請參閱使用 Windows PowerShell 來設定快取 (Windows Server AppFabric 快取)。此主題中的表格將管理命令細分成幾個類別。有些命令會出現在多個表格中，在應用於四種命令類別時顯示不同的參數：

  • 與快取叢集相關的命令

  • 與快取主機相關的命令

  • 與快取相關的命令

  • 主控台管理命令

在 Windows PowerShell 工作階段中取得說明

下面資訊提供 AppFabric 快取功能的管理命令摘要。請務必了解，您也能在 Windows PowerShell 工作階段內取得說明。例如，下列命令可顯示所有系統管理命令：

get-command -module DistributedCacheAdministration

如果您需要特定命令的說明，您可以使用 get-help 命令來這樣做。例如，下列命令可顯示 New-Cache 命令的完整說明：

get-help New-Cache -full

重要考量

使用此主題所述的 Windows PowerShell 命令時，請務必考量下列幾點：

  • 使用這些 Windows PowerShell 命令之人員的安全性身分識別，必須具有快取叢集中所有快取伺服器的系統管理員權限。

  • 命令的參數值區分大小寫。例如，若建立名為 NamedCache1 的快取，則 Get-CacheConfig -CacheName namedcache1 命令將沒有作用。大小寫必須相符，如同在 Get-CacheConfig -CacheName NamedCache1 中。

  • 使用 Export-CacheClusterConfig 與 Import-CacheClusterConfig 命令來變更 XML 型叢集組態時，您可以變更 XML 檔案中的叢集組態設定 (XML 屬性)，但不支援透過插入或移除 XML 元素來新增或移除具名快取與快取主機。

  • Start-CacheCluster、Stop-CacheCluster 與 Restart-CacheCluster 快取叢集命令涉及在叢集中所有快取主機上，協調快取主機 Windows 服務的狀態。由主要主機執行叢集管理角色時，這些命令可能要花費較久的時間；必須有絕大多數的主要主機持續執行，以讓其餘快取主機能夠停止和啟動。

  • 請一律使用 Start-CacheCluster、Stop-CacheCluster 及 Restart-CacheCluster 快取叢集命令來啟動及停止快取服務。從服務系統管理工具啟動及停止服務可能會導致發生懸置。此外，必須使用系統管理權限從提高權限的 Windows PowerShell 工作階段執行這些命令。

  • Stop-CacheCluster 或 Restart-CacheCluster 快取叢集命令會造成從叢集中所有快取主機的記憶體排清所有資料。

  • Set-CacheConfig 與 Import-CacheClusterConfig 命令需要您使用 Restart-CacheCluster 來重新啟動快取叢集，所做的變更才會生效。

  • Remove-Cache 與 New-Cache 命令可用來變更具名快取組態，而不會影響到叢集中的其他具名快取。

與快取叢集相關的命令

下表列出可用來執行與叢集相關之操作的「快取管理 Windows Powershell」命令。

命令 描述

Use-CacheCluster

將 Windows PowerShell 工作階段的內容設定至想要的快取叢集。

當您啟動 Windows PowerShell 工作階段時，您必須先執行此命令。如果是在快取主機執行，您可以不搭配參數來執行命令，因為系統已經從電腦上的快取組態取得參數。如果您是從非主機電腦執行命令，您可以使用以下參數來指定想要的快取叢集。

參數 (別名) 描述如下所示：

  • Provider (P)：用來儲存叢集組態設定的提供者。視組態資訊儲存方式而定，這可以是 System.Data.SqlClient 或 XML。

  • ConnectionString (C)：資料庫的連接字串或 XML 組態檔的位置。

Start-CacheCluster

啟動叢集中的所有快取服務。會先啟動主要主機。請注意，在重新開機之後不會自動啟動快取服務，因此必須呼叫 Start-CacheCluster 或 Start-CacheHost 來啟動服務。需要系統管理員權限才能執行此命令。

Stop-CacheCluster

停止叢集中的所有快取服務。需要系統管理員權限才能執行此命令。

Restart-CacheCluster

以正確的順序重新啟動叢集中所有快取服務。需要系統管理員權限才能執行此命令。

Get-CacheClusterHealth

傳回快取叢集健康情況的統計資料。

Export-CacheClusterConfig

設計來搭配 Import-CacheClusterConfig 使用，此命令可讓您使用 XML 來編輯叢集組態設定。如需詳細資訊，請參閱編輯叢集組態設定 (Windows Server AppFabric 快取)。

此命令會將目前存在於叢集中的叢集組態設定匯出至指定的 XML 型組態檔。不論您選擇將叢集組態設定儲存至何處 (SQL Server 或共用的網路資料夾)，都可以使用此命令。

參數 (別名) 描述如下所示：

  • File (F)：要建立之 XML 型組態檔的完整路徑與名稱，描述目前的快取叢集組態設定。

範例：Export-CacheClusterConfig -File c:\Temp\CurrentClusterConfig.xml

Import-CacheClusterConfig

設計來搭配 Export-CacheClusterConfig 使用，此命令可讓您使用 XML 來編輯叢集組態設定。如需詳細資訊，請參閱編輯叢集組態設定 (Windows Server AppFabric 快取)。

此命令會從指定的 XML 型組態檔匯入叢集組態設定。不論您選擇將叢集組態設定儲存至何處 (SQL Server 或共用的網路資料夾)，都可以使用此命令。

您必須使用 Restart-CacheCluster 重新啟動叢集，所做的變更才會生效。

參數 (別名) 描述如下所示：

  • File (Fi)：XML 型組態檔的完整路徑與名稱，描述要套用到叢集的快取叢集組態設定。

  • Force (Fo)：不提示您確認，就匯入組態檔。

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

Grant-CacheAllowedClientAccount

授與 Windows 帳戶存取快取叢集的權限。根據預設值，快取主機上的任何系統管理員帳戶都擁有快取叢集的存取權。您必須使用此命令，將其他帳戶明確地新增至允許的用戶端帳戶清單。

參數 (別名) 描述如下所示：

  • Account (A)：要為其授與快取叢集存取權的 Windows 帳戶。

  • Force (F)：不事先驗證帳戶是否存在，便新增指定的用戶端帳戶。

Revoke-CacheAllowedClientAccount

撤銷 Windows 帳戶存取快取叢集的權限。請注意，這將不會禁止快取主機上的系統管理員存取快取叢集。

參數 (別名) 描述如下所示：

  • Account (A)：要為其授與快取叢集存取權的 Windows 帳戶。

Get-Cache

未搭配任何參數使用時，會列出快取叢集內所有快取的相關資訊。

注意

如需有關如何使用此命令來搭配 HostName 參數的詳細資訊，請參閱下表。

與快取主機相關的命令

下表列出的命令可用來在 Windows PowerShell 中執行與快取主機相關的操作。

命令 描述

Get-CacheHost

列出所指定快取主機的相關資訊。如果未傳遞任何參數，會列出屬於快取叢集成員的所有快取服務。

參數 (別名) 描述如下所示：

  • HostName (H)：快取主機的名稱。

  • CachePort (P)：快取主機的連接埠號碼。

範例：Get-CacheHost

Get-CacheHostConfig

傳回所指定快取主機的相關組態資訊。

參數 (別名) 描述如下所示：

  • HostName (H)：快取主機的名稱。

  • CachePort (P)：快取主機的連接埠號碼。

範例：Get-CacheConfig -HostName CacheServer1 -CachePort 22233

Set-CacheHostConfig

將快取主機組態更新為命令參數中指定的值。所有參數都可以省略，但 HostName 與 CachePort 除外。如需詳細資訊，請參閱編輯叢集組態設定 (Windows Server AppFabric 快取)。

參數 (別名) 描述如下所示：

  • HostName (H)：快取主機的名稱。

  • CachePort (P)：快取主機目前的快取連接埠號碼。

  • ClusterPortNumber (CPort)：由快取主機使用的叢集連接埠號碼。

  • ArbitratorPortNumber (APort)：新的仲裁程式連接埠號碼。

  • ReplicationPortNumber (RPort)：新的複寫連接埠號碼。

  • CacheSize (Size)：所配置以供在快取主機上儲存資料的總記憶體數量，單位為 MB。

  • HWM (HWM)：回收作業應開始將尚未到期的物件移出記憶體的記憶體高水位線百分比。

  • LWM (LWM)：回收作業應開始將已到期的物件移出記憶體的記憶體低水位線百分比。在達到 HWM 之後，回收作業應停止將尚未到期的物件移出記憶體。

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

Start-CacheHost

啟動指定的快取服務。在快取伺服器重新開機之後，需要執行此命令以允許快取服務重新加入執行中的快取叢集。請注意，如果快取叢集當機，則您應該改用 Start-CacheCluster 命令。此外，在重新開機之後不會自動啟動快取服務，因此必須呼叫 Start-CacheHost 或 Start-CacheCluster 來啟動服務。

參數 (別名) 描述如下所示：

  • HostName (HostN)：快取主機的名稱。

  • CachePort (P)：快取主機的連接埠號碼。

  • HostTimeout(T)：啟動指定之快取主機的逾時值 (秒)。預設是 60 秒。

範例：Start-CacheHost -HostName CacheServer1 -CachePort 22233

Stop-CacheHost

停止指定的快取服務。

注意

如果快取主機 Windows 服務正在執行叢集管理角色，且停止該快取主機會造成整個叢集關閉，Stop-CacheHost 命令就不會停止該快取主機。如需詳細資訊，請參閱主要主機與叢集管理 (Windows Server AppFabric 快取)。

參數 (別名) 描述如下所示：

  • HostName (HostN)：快取主機的名稱。

  • CachePort (P)：快取主機的連接埠號碼。

  • HostTimeout(T)：啟動指定之快取主機的逾時值 (秒)。

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

Get-CacheStatistics

顯示所指定快取主機的統計資料，包括：總大小 (位元組) 以及快取物件、區域、具名快取、要求與遺漏的快取數目。

注意

如需有關如何使用此命令來搭配 CacheName 參數的詳細資訊，請參閱下表。

參數 (別名) 描述如下所示：

  • HostName (H)：快取主機的名稱。

  • CachePort (P)：快取主機的連接埠號碼。

範例：Get-CacheStatistics -HostName CacheServer1 -CachePort 22233

Get-Cache

列出位於所指定快取主機上的所有快取與區域。

參數 (別名) 描述如下所示：

  • HostName (H)：快取主機的名稱。

  • CachePort (C)：快取主機的連接埠號碼。

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

Get-CacheRegion

傳回快取叢集中所有區域的清單。區域只能由快取用戶端建立或移除。但快取叢集會決定其位在哪部快取主機。所有參數都可以省略。

注意

如需有關如何使用此命令來搭配 CacheName 參數的詳細資訊，請參閱下表。

參數 (別名) 描述如下所示：

  • MaxRegions：要顯示的區域數目上限。這無法與 MaxRegionsPerHost 參數搭配使用。

  • MaxRegionsPerHost：快取叢集中的每部主機要顯示的區域數目上限。

範例：Get-CacheRegion -MaxRegionsPerHost 4

與快取相關的命令

下表列出的命令可用來在 Windows PowerShell 中執行與快取相關的操作。

命令 描述

New-Cache

在叢集執行時建立新的具名快取。所有值都可以省略，但 CacheName 除外。

注意

具名快取限制為 128 個。

參數 (別名) 描述如下所示：

  • CacheName (N)：快取的名稱。

  • Secondaries (S)：值為 1 可以啟用高可用性功能。值為 0 可以停用高可用性功能。預設值為 0。

  • NotificationsEnabled (Notif)：True 值可啟用快取通知功能，而 False 值可將它停用。

  • Eviction (Evict)：LRU 值可啟用「最近最少使用」收回。None 值可停用收回。預設值為 LRU。

    警告

    None 值可能會導致快取主機發生記憶體不足的情形。

  • TimeToLive (T)：快取中儲存之物件在過期前的預設逾時值 (分鐘)。預設值為 10。

  • Expirable：True 值會啟用過期，而 False 會停用過期。預設值為 True。

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

Remove-Cache

移除具名快取，如 CacheName 參數所指定。

參數 (別名) 描述如下所示：

  • CacheName (N)：快取的名稱。

範例：Remove-Cache -CacheName NamedCache1

Get-CacheConfig

傳回 CacheName 參數所指定具名快取的組態詳細資料。

參數 (別名) 描述如下所示：

  • CacheName (N)：快取的名稱。

範例：Get-CacheConfig -CacheName NamedCache1

Set-CacheConfig

更新具名快取的組態設定，如 CacheName 參數所指定。

使用 CacheName 參數來變更快取時，快取叢集不能是執行中狀態。或者，您可能想要考慮使用 Remove-Cache 與 New-Cache 命令。這些命令可以用來變更具名快取組態，而不會因為需要停止叢集而影響到叢集中的其他具名快取。

如需詳細資訊，請參閱使用 Windows PowerShell 來編輯快取組態設定 (Windows Server AppFabric 快取)。

參數 (別名) 描述如下所示：

  • CacheName (N)：快取的名稱。

  • Secondaries (S)：值為 1 可以啟用高可用性功能。值為 0 可以停用高可用性功能。預設值為 0。請注意，此功能只支援執行 Windows Server Enterprise Edition 或 DataCenter Edition 的快取主機。

  • NotificationsEnabled (Notif)：True 值可啟用快取通知功能，而 False 值可將它停用。

  • Eviction (Evict)：LRU 值可啟用「最近最少使用」收回。None 值可停用收回。預設值為 LRU。

    警告

    None 值可能會導致快取主機發生記憶體不足的情形。

  • TimeToLive (T)：快取中儲存之物件在過期前的預設逾時值 (分鐘)。預設值為 10。

  • Expirable：True 值會啟用過期，而 False 會停用過期。預設值為 True。

範例：Set-CacheConfig -CacheName NamedCache1 -TimeToLive 30

Get-CacheStatistics

傳回具名快取的統計資料，如 CacheName 參數所指定。

注意

如需有關如何使用此命令來搭配 HostName 與 CachePort 參數的詳細資訊，請參閱上表。

參數 (別名) 描述如下所示：

  • CacheName (N)：快取的名稱。

範例：Get-CacheStatistics -CacheName NamedCache1

Get-CacheRegion

傳回具名快取中所有區域的清單，如 CacheName 參數所指定。區域只能由快取用戶端建立或移除。快取叢集可控制每個區域會位在哪部快取主機。

注意

如需有關如何使用此命令來搭配 HostName 與 CachePort 參數的詳細資訊，請參閱上表。

參數 (別名) 描述如下所示：

  • CacheName (N)：快取的名稱。

範例：Get-CacheRegion -CacheName NamedCache1

主控台管理命令

下表列出的命令可用來執行與管理 Windows PowerShell 快取管理工具相關的操作。

命令 描述

Set-CacheLogging

此命令可為 Windows PowerShell 快取管理工具工作階段啟用檔案型記錄功能。使用此命令初始化的事件追蹤功能，只會從呼叫時開始持續至 Windows PowerShell 工作階段期間結束。

根據預設值，記錄功能是在 VERBOSE 等級啟用。預設記錄檔位於使用者的 %temp% 目錄，名稱含有前置詞 DCacheAdministration，後面接著處理序識別碼與建立時間戳記。

如果已有名稱相同的檔案，Windows PowerShell 會嘗試附加到該記錄檔。

參數 (別名) 描述如下所示：

  • LogLevel (L)：指定追蹤所擷取之事件類型的事件等級。有效值為 NONE、ERROR、WARNING、INFO 與 VERBOSE。

  • File (F)：應寫入記錄的絕對資料夾或檔案路徑。如果未指定檔案名稱，檔名將會預設為 DCacheAdminTrace[<ProcessId>].log，其中 <ProcessId> 是 Windows PowerShell 工作階段的 Windows 處理序識別碼 。指定的所有檔案名稱都會附加 ".log"。

此範例建立會擷取警告與錯誤訊息的檔案 c:\WarningLog.log。

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

此命令只會追蹤 Windows PowerShell 工作階段的事件，不會追蹤快取用戶端或快取主機的事件。

Invoke-GC

在快取叢集上手動叫用記憶體回收功能，以釋放未使用的記憶體。這只適用於特殊情況。記憶體回收功能一般是由 .NET Framework 與 AppFabric 快取叢集的記憶體管理功能管理。

Get-Help

提供所有支援命令的說明資訊。此關鍵字也可以搭配 "*" 字元使用，以篩選顯示的說明資訊量，例如：

Get-Help new*

Get-Help Start*

Get-Help *cache

Get-Help *cachehost

exit

結束 Windows PowerShell 工作階段。

cls

清除 Windows PowerShell 畫面。

另請參閱

概念

使用 Windows PowerShell 來設定快取 (Windows Server AppFabric 快取)
組態設定 (Windows Server AppFabric 快取)
Windows Server AppFabric 快取組態選項
針對 Windows Server AppFabric 快取功能進行疑難排解
Windows Server AppFabric 快取概念
開發快取用戶端 (Windows Server AppFabric 快取)

  2011-12-05