Správa mezipamětí pomocí prostředí Windows PowerShell (ukládání do mezipaměti technologie Windows Server AppFabric)

Pomocí prostředí Windows PowerShell můžete spravovat cluster mezipamětí, hostitele mezipaměti i samotnou mezipaměť. Pokud používáte počítač s nainstalovanou funkcí Správa mezipamětí, existují dva způsoby použití prostředí Windows PowerShell ke správě funkcí ukládání do mezipaměti technologie AppFabric. V nabídce Start přejděte na příkaz Nástroje pro správu a potom klikněte na položku Moduly prostředí Windows PowerShell. Můžete však také otevřít nabídku Start, kliknout na příkaz Všechny programy, na položku Windows Server AppFabric a potom na položku Správa ukládání do mezipaměti – Windows PowerShell.

Poznámka

V operačních systémech Windows Vista, Windows 7 a Windows Server 2008 je ke správnému fungování některých příkazů pro správu nutné spustit prostředí Windows PowerShell s oprávněními správce. Je třeba kliknout pravým tlačítkem myši na zástupce Správa ukládání do mezipaměti – Windows PowerShell a kliknout na příkaz Spustit jako správce.

Existují dvě hlavní kategorie příkazů prostředí PowerShell pro ukládání do mezipaměti technologie AppFabric: příkazy pro správu a příkazy pro konfiguraci. Toto téma se zaměřuje na příkazy pro správu. Další informace o příkazech pro konfiguraci naleznete v tématu Konfigurace mezipaměti pomocí prostředí Windows PowerShell (ukládání do mezipaměti technologie Windows Server AppFabric). Tabulky v tomto tématu rozdělují příkazy pro správu do kategorií. Některé příkazy se objevují ve více tabulkách s různými parametry, které jsou platné vždy pro každou ze čtyř kategorií příkazů:

• Příkazy související s clusterem mezipamětí

• Příkazy související s hostitelem mezipaměti

• Příkazy související s mezipamětí

• Příkazy pro správu konzoly

Získání nápovědy v relaci prostředí Windows PowerShell

Níže uvedené informace obsahují souhrn příkazů pro správu týkajících se funkcí ukládání do mezipaměti technologie AppFabric. Je důležité vědět, že nápovědu lze získat také v relaci prostředí Windows PowerShell. Následující příkaz například zobrazí všechny příkazy pro správu:

get-command -module DistributedCacheAdministration

Potřebujete-li nápovědu ke konkrétnímu příkazu, můžete k tomuto účelu použít příkaz get-help. Následující příkaz například zobrazí úplnou nápovědu k příkazu New-Cache:

get-help New-Cache -full

Důležité informace

Při použití příkazů prostředí Windows PowerShell popsaných v tomto tématu je důležité vzít v úvahu následující informace:

• Identita zabezpečení osoby používající tyto příkazy prostředí Windows PowerShell musí mít oprávnění správce na všech serverech mezipaměti v clusteru mezipamětí.

• V hodnotách parametrů pro příkazy jsou rozlišována malá a velká písmena. Pokud jste vytvořili mezipaměť s názvem NamedCache1, nebude například fungovat příkaz Get-CacheConfig -CacheName namedcache1. Velikost písmen názvu musí odpovídat, například: Get-CacheConfig -CacheName NamedCache1.

• Budete-li měnit konfiguraci clusteru založenou na souboru XML pomocí příkazů Export-CacheClusterConfig a Import-CacheClusterConfig, můžete změnit nastavení konfigurace clusteru (atributy XML) v souboru XML, avšak přidávání a odebírání pojmenovaných mezipamětí a hostitelů mezipamětí vkládáním a odebíráním elementů XML není podporováno.

• Příkazy Start-CacheCluster, Stop-CacheCluster a Restart-CacheCluster pro práci s clusterem mezipamětí zahrnují koordinaci stavu služby systému Windows pro hostitele mezipaměti na všech serverech mezipaměti v clusteru. Pokud hlavní hostitelé plní roli správy clusterů, mohou tyto příkazy trvat delší dobu – většina hlavních hostitelů musí být spuštěna, zatímco zbytek hostitelů mezipaměti je zastavován a spouštěn.

• Službu Ukládání do mezipaměti vždy spouštějte a zastavujte pomocí příkazů clusteru mezipamětí Start-CacheCluster, Stop-CacheCluster a Restart-CacheCluster. Spouštění a zastavování služby z nástroje pro správu služeb může vést k tomu, že přestane reagovat. Tyto příkazy musí být také spouštěny z relace prostředí Windows PowerShell s rozšířenými oprávněními, a to s oprávněními pro správu.

• Příkazy Stop-CacheCluster a Restart-CacheCluster pro práci s clusterem mezipamětí způsobí, že z paměti všech hostitelů mezipaměti v clusteru budou odstraněna veškerá data.

• Příkazy Set-CacheConfig a Import-CacheClusterConfig vyžadují k uplatnění změn, abyste restartovali cluster mezipamětí pomocí příkazu Restart-CacheCluster.

• Příkazy Remove-Cache a New-Cache lze použít ke změně konfigurace pojmenované mezipaměti, aniž by došlo k ovlivnění dalších pojmenovaných mezipamětí v clusteru.

Příkazy související s clusterem mezipamětí

V následující tabulce jsou uvedeny příkazy prostředí Windows PowerShell pro správu mezipaměti, které slouží k provádění operací souvisejících s clusterem.

Příkaz	Popis
Use-CacheCluster	Nastaví kontext relace prostředí Windows PowerShell na požadovaný cluster mezipamětí. Při spuštění relace prostředí Windows PowerShell je nutné nejdříve spustit tento příkaz. V hostiteli mezipaměti se tento příkaz spouští bez parametrů, protože parametry jsou převzaty z konfigurace mezipaměti v počítači. Pokud tento příkaz spouštíte z jiného než hostitelského počítače, můžete pomocí níže uvedených parametrů zadat požadovaný cluster mezipamětí. Zde je popis parametrů (v závorkách je alias parametru): Provider (P): Zprostředkovatel použitý k uložení nastavení konfigurace clusteru. V závislosti na způsobu uložení konfiguračních informací to může být System.Data.SqlClient nebo XML. ConnectionString (C): Připojovací řetězec k databázi nebo umístění konfiguračního souboru XML.
Start-CacheCluster	Spustí všechny služby mezipaměti v clusteru. Nejdříve jsou spuštěni hlavní hostitelé. Pamatujte, že služby mezipaměti nejsou po restartu spuštěny automaticky. Za účelem spuštění služby tedy musí být volána rutina Start-CacheCluster nebo Start-CacheHost. Tento příkaz vyžaduje oprávnění správce.
Stop-CacheCluster	Zastaví všechny služby mezipaměti v clusteru. Tento příkaz vyžaduje oprávnění správce.
Restart-CacheCluster	Restartuje ve správném pořadí všechny služby mezipaměti v clusteru. Tento příkaz vyžaduje oprávnění správce.
Get-CacheClusterHealth	Vrátí statistické údaje o stavu clusteru mezipamětí.
Export-CacheClusterConfig	Tento příkaz, který se používá spolu s příkazem Import-CacheClusterConfig, umožňuje upravit nastavení konfigurace clusteru pomocí souboru XML. Další informace naleznete v tématu Úprava nastavení konfigurace clusteru (ukládání do mezipaměti technologie Windows Server AppFabric). Tento příkaz exportuje aktuální nastavení konfigurace clusteru do zadaného konfiguračního souboru XML. Tento příkaz lze použít bez ohledu na to, kam jste se rozhodli uložit nastavení konfigurace clusteru (do systému SQL Server nebo do sdílené síťové složky). Zde je popis parametrů (v závorkách je alias parametru): File (F): Plně kvalifikovaná název konfiguračního souboru XML (včetně cesty), který má být vytvořen a do kterého má být exportováno aktuální nastavení konfigurace clusteru mezipamětí. Příklad: Export-CacheClusterConfig -File c:\Temp\CurrentClusterConfig.xml
Import-CacheClusterConfig	Tento příkaz, který se používá spolu s příkazem Export-CacheClusterConfig, umožňuje upravit nastavení konfigurace clusteru pomocí souboru XML. Další informace naleznete v tématu Úprava nastavení konfigurace clusteru (ukládání do mezipaměti technologie Windows Server AppFabric). Tento příkaz importuje nastavení konfigurace clusteru ze zadaného konfiguračního souboru XML. Tento příkaz lze použít bez ohledu na to, kam jste se rozhodli uložit nastavení konfigurace clusteru (do systému SQL Server nebo do sdílené síťové složky). Změny se projeví až po restartování clusteru pomocí příkazu Restart-CacheCluster. Zde je popis parametrů (v závorkách je alias parametru): File (Fi): Plně kvalifikovaný název konfiguračního souboru XML (včetně cesty), který obsahuje nastavení konfigurace clusteru mezipamětí, jež má být použito v clusteru. Force (Fo): Importuje konfigurační soubor, aniž by byla zobrazena výzva k potvrzení. Příklad: Import-CacheClusterConfig -File c:\CurrentClusterConfig.xml
Grant-CacheAllowedClientAccount	Udělí účtu systému Windows oprávnění pro přístup ke clusteru mezipamětí. Ve výchozím nastavení mají ke clusteru mezipamětí přístup všechny účty správce v hostitelích mezipaměti. Jiné účty je nutné explicitně přidat do seznamu povolených klientských účtů pomocí tohoto příkazu. Zde je popis parametrů (v závorkách je alias parametru): Account (A): Účet systému Windows, kterému má být uděleno oprávnění k přístupu ke clusteru mezipamětí. Force (F): Přidá zadaný klientský účet, aniž by bylo ověřeno, zda existuje.
Revoke-CacheAllowedClientAccount	Odebere účtu systému Windows oprávnění pro přístup ke clusteru mezipamětí. Správcům v hostitelích mezipamětí to nebude bránit v přístupu ke clusteru mezipamětí. Zde je popis parametrů (v závorkách je alias parametru): Account (A): Účet systému Windows, kterému má být uděleno oprávnění k přístupu ke clusteru mezipamětí.
Get-Cache	Pokud tento příkaz použijete bez parametrů, zobrazí informace o všech mezipamětích v clusteru mezipamětí. Poznámka Informace o použití tohoto příkazu s parametrem HostName naleznete v následující tabulce.

Příkazy související s hostitelem mezipaměti

V následující tabulce jsou uvedeny příkazy prostředí Windows PowerShell, které slouží k provádění operací souvisejících s hostitelem mezipaměti.

Příkaz	Popis
Get-CacheHost	Vypíše informace o zadaném hostiteli mezipaměti. Pokud nejsou příkazu předány žádné parametry, vypíše všechny služby mezipaměti, které jsou členy clusteru mezipamětí. Zde je popis parametrů (v závorkách je alias parametru): HostName (H): Název hostitele mezipaměti. CachePort (P): Číslo portu mezipaměti pro hostitele mezipaměti. Příklad: Get-CacheHost
Get-CacheHostConfig	Vrátí konfigurační informace o zadaném hostiteli mezipaměti. Zde je popis parametrů (v závorkách je alias parametru): HostName (H): Název hostitele mezipaměti. CachePort (P): Číslo portu mezipaměti pro hostitele mezipaměti. Příklad: Get-CacheConfig -HostName CacheServer1 -CachePort 22233
Set-CacheHostConfig	Aktualizuje konfiguraci hostitele mezipaměti na hodnoty zadané v parametrech příkazu. S výjimkou parametrů HostName a CachePort jsou všechny parametry nepovinné. Další informace naleznete v tématu Úprava nastavení konfigurace clusteru (ukládání do mezipaměti technologie Windows Server AppFabric). Zde je popis parametrů (v závorkách je alias parametru): HostName (H): Název hostitele mezipaměti. CachePort (P): Aktuální číslo portu mezipaměti pro hostitele mezipaměti. ClusterPortNumber (CPort): Číslo portu clusteru používané hostitelem mezipaměti. ArbitratorPortNumber (APort): Nové číslo arbitrážního portu. ReplicationPortNumber (RPort): Nové číslo portu pro replikaci. CacheSize (Size): Celkové množství paměti v megabajtech (MB) přidělené za účelem ukládání dat v hostiteli mezipaměti. HWM (HWM): Horní mezní procento paměti, při kterém mají začít být vyřazovány objekty, jejichž platnost dosud nevypršela. LWM (LWM): Dolní mezní procento paměti, při kterém mají začít být vyřazovány objekty, jejichž platnost vypršela. Po dosažení hodnoty HWM tato dolní mez určuje procento paměti, při kterém má být zastaveno vyřazování objektů, jejichž platnost dosud nevypršela. Příklad: Set-CacheConfig -HostName CacheServer1 -CachePort 22233 -LowWM 80
Start-CacheHost	Spustí zadanou službu mezipaměti. Po restartování serveru mezipaměti je tento příkaz vyžadován k tomu, aby se služba mezipaměti mohla znovu připojit ke spuštěnému clusteru mezipamětí. Pokud je cluster mezipamětí mimo provoz, měli byste místo toho použít příkaz Start-CacheCluster. Služby mezipaměti nejsou po restartu spuštěny automaticky. Za účelem spuštění služby tedy musí být volána rutina Start-CacheHost nebo Start-CacheCluster. Zde je popis parametrů (v závorkách je alias parametru): HostName (HostN): Název hostitele mezipaměti. CachePort (P): Číslo portu mezipaměti pro hostitele mezipaměti. HostTimeout(T): Časový limit (v sekundách) pro spuštění zadaného hostitele mezipaměti. Výchozí hodnota je 60 sekund. Příklad: Start-CacheHost -HostName CacheServer1 -CachePort 22233
Stop-CacheHost	Zastaví zadanou službu mezipaměti. Poznámka Příkaz Stop-CacheHost nezastaví službu systému Windows pro hostitele mezipaměti v případě, že plní roli správy clusteru a zastavení hostitele mezipaměti by způsobilo vypnutí celého clusteru. Další informace naleznete v tématu Správa hlavních hostitelů a clusteru (ukládání do mezipaměti technologie Windows Server AppFabric). Zde je popis parametrů (v závorkách je alias parametru): HostName (HostN): Název hostitele mezipaměti. CachePort (P): Číslo portu mezipaměti pro hostitele mezipaměti. HostTimeout(T): Časový limit (v sekundách) pro spuštění zadaného hostitele mezipaměti. Příklad: Stop-CacheHost -HostName CacheServer1 -CachePort 22233
Get-CacheStatistics	Zobrazí statistické informace o zadaném hostiteli mezipaměti včetně těchto údajů: celková velikost (v bajtech) a počet objektů uložených v mezipaměti, oblastí, pojmenovaných mezipamětí, žádostí a neúspěšných přístupů do mezipaměti. Poznámka Informace o použití tohoto příkazu s parametrem CacheName naleznete v následující tabulce. Zde je popis parametrů (v závorkách je alias parametru): HostName (H): Název hostitele mezipaměti. CachePort (P): Číslo portu mezipaměti pro hostitele mezipaměti. Příklad: Get-CacheStatistics -HostName CacheServer1 -CachePort 22233
Get-Cache	Vypíše všechny mezipaměti a oblasti, které se nacházejí v zadaném hostiteli mezipaměti. Zde je popis parametrů (v závorkách je alias parametru): HostName (H): Název hostitele mezipaměti. CachePort (C): Číslo portu mezipaměti pro hostitele mezipaměti. Příklad: Get-Cache -HostName CacheServer1 -CachePort 22233
Get-CacheRegion	Vrátí seznam všech oblastí v clusteru mezipamětí. Oblasti může vytvářet a odebírat pouze klient mezipaměti. Cluster mezipamětí však určí hostitele mezipaměti, ve kterém budou oblasti umístěny. Všechny parametry jsou nepovinné. Poznámka Informace o použití tohoto příkazu s parametrem CacheName naleznete v následující tabulce. Zde je popis parametrů (v závorkách je alias parametru): MaxRegions: Maximální počet oblastí, které mají být zobrazeny. Tento parametr nemůže být použit spolu s parametrem MaxRegionsPerHost. MaxRegionsPerHost: Maximální počet oblastí, které mají být zobrazeny z každého hostitele v clusteru mezipamětí. Příklad: Get-CacheRegion -MaxRegionsPerHost 4

Příkazy související s mezipamětí

V následující tabulce jsou uvedeny příkazy prostředí Windows PowerShell, které slouží k provádění operací souvisejících s mezipamětí.

Příkaz	Popis
New-Cache	Vytvoří novou pojmenovanou mezipaměť – pokud je cluster spuštěn. Všechny parametry s výjimkou parametru CacheName jsou nepovinné. Poznámka Počet pojmenovaných mezipamětí je omezen na 128. Zde je popis parametrů (v závorkách je alias parametru): CacheName (N): Název mezipaměti. Secondaries (S): Hodnota 1 povolí funkci vysoké dostupnosti. Hodnota 0 zakáže funkci vysoké dostupnosti. Výchozí hodnota je 0. NotificationsEnabled (Notif): Hodnota True povolí funkci oznámení mezipaměti, zatímco hodnota False tuto funkci zakáže. Eviction (Evict): Hodnota LRU povolí vyřazování nejdéle nepoužitých objektů. Hodnota None vyřazování zakáže. Výchozí hodnota je LRU. Upozornění Hodnota None může způsobit, že hostiteli mezipaměti dojde paměť. TimeToLive (T): Výchozí časový limit (v minutách) pro vypršení platnosti objektů uložených v mezipaměti. Výchozí hodnota je 10. Expirable: Hodnota True povolí vypršení platnosti, zatímco hodnota False je zakáže. Výchozí hodnota je True. Příklad: New-Cache -CacheName NamedCache1 -Secondaries 1 -TimeToLive 15
Remove-Cache	Odebere pojmenovanou mezipaměť zadanou pomocí parametru CacheName. Zde je popis parametrů (v závorkách je alias parametru): CacheName (N): Název mezipaměti. Příklad: Remove-Cache -CacheName NamedCache1
Get-CacheConfig	Vrátí podrobnosti o konfiguraci pojmenované mezipaměti zadané pomocí parametru CacheName. Zde je popis parametrů (v závorkách je alias parametru): CacheName (N): Název mezipaměti. Příklad: Get-CacheConfig -CacheName NamedCache1
Set-CacheConfig	Aktualizuje nastavení konfigurace pojmenované mezipaměti zadané pomocí parametru CacheName. Pokud je ke změnám mezipaměti použit parametr CacheName, nesmí být spuštěn cluster mezipamětí. Vhodnou alternativou může být použití příkazů Remove-Cache a New-Cache. Tyto příkazy lze použít ke změně konfigurace pojmenované mezipaměti, aniž by došlo k ovlivnění dalších pojmenovaných mezipamětí v clusteru nuceným zastavením clusteru. Další informace naleznete v tématu Úprava nastavení konfigurace mezipaměti v prostředí Windows PowerShell (ukládání do mezipaměti technologie Windows Server AppFabric). Zde je popis parametrů (v závorkách je alias parametru): CacheName (N): Název mezipaměti. Secondaries (S): Hodnota 1 povolí funkci vysoké dostupnosti. Hodnota 0 zakáže funkci vysoké dostupnosti. Výchozí hodnota je 0. Tato funkce je podporována pouze u hostitelů mezipaměti, ve kterých je spuštěn systém Windows Server verze Enterprise nebo DataCenter. NotificationsEnabled (Notif): Hodnota True povolí funkci oznámení mezipaměti, zatímco hodnota False tuto funkci zakáže. Eviction (Evict): Hodnota LRU povolí vyřazování nejdéle nepoužitých objektů. Hodnota None vyřazování zakáže. Výchozí hodnota je LRU. Upozornění Hodnota None může způsobit, že hostiteli mezipaměti dojde paměť. TimeToLive (T): Výchozí časový limit (v minutách) pro vypršení platnosti objektů uložených v mezipaměti. Výchozí hodnota je 10. Expirable: Hodnota True povolí vypršení platnosti, zatímco hodnota False je zakáže. Výchozí hodnota je True. Příklad: Set-CacheConfig -CacheName NamedCache1 -TimeToLive 30
Get-CacheStatistics	Vrátí statistické informace o pojmenované mezipaměti zadané pomocí parametru CacheName. Poznámka Informace o použití tohoto příkazu s parametrem HostName a CachePort naleznete v předchozí tabulce. Zde je popis parametrů (v závorkách je alias parametru): CacheName (N): Název mezipaměti. Příklad: Get-CacheStatistics -CacheName NamedCache1
Get-CacheRegion	Vrátí seznam všech oblastí v pojmenované mezipaměti zadané pomocí parametru CacheName. Oblasti může vytvářet a odebírat pouze klient mezipaměti. Cluster mezipamětí určí hostitele mezipaměti, ve kterém budou jednotlivé oblasti umístěny. Poznámka Informace o použití tohoto příkazu s parametrem HostName a CachePort naleznete v předchozí tabulce. Zde je popis parametrů (v závorkách je alias parametru): CacheName (N): Název mezipaměti. Příklad: Get-CacheRegion -CacheName NamedCache1

Příkazy pro správu konzoly

V následující tabulce jsou uvedeny příkazy, které slouží k provádění operací souvisejících se správou nástrojů pro správu mezipamětí založených na prostředí Windows PowerShell.

Příkaz	Popis
Set-CacheLogging	Tento příkaz povolí souborové protokolování pro relaci nástroje pro správu mezipamětí založeného na prostředí Windows PowerShell. Trasování událostí zahájené tímto příkazem trvá pouze po dobu trvání relací prostředí Windows PowerShell, z nichž bylo voláno. Ve výchozím nastavení je protokolování povoleno na úrovni VERBOSE. Výchozí soubor protokolu je umístěn v adresáři %temp% uživatelů a jeho název je tvořen předponou DCacheAdministration následovanou identifikátorem procesu a časovým razítkem vytvoření. Pokud soubor stejného názvu již existuje, pokusí se prostředí Windows PowerShell připojit záznamy na konec souboru protokolu. Zde je popis parametrů (v závorkách je alias parametru): LogLevel (L): Úroveň událostí, která určuje, jaké typy událostí budou při trasování zaznamenávány. Platné hodnoty jsou NONE, ERROR, WARNING, INFO a VERBOSE. File (F): Absolutní cesta ke složce nebo souboru, kam mají být protokoly zapisovány. Pokud není název souboru zadán, bude použit výchozí název DCacheAdminTrace[<ProcessId>].log, kde <ProcessId> je číselný identifikátor procesu systému Windows dané relace prostředí Windows PowerShell. Ke všem zadaným názvům souborů bude připojena přípona ".log". Příkaz v tomto příkladu vytvoří soubor c:\WarningLog.log, do kterého budou zaznamenávány chybové zprávy a upozornění: Set-CacheLogging -LogLevel WARNING -File c:\WarningLog Tento příkaz vyvolá sledování událostí pouze pro relaci prostředí Windows PowerShell, nikoli pro klienta mezipaměti nebo hostitele mezipaměti.
Invoke-GC	Tento příkaz umožňuje ručně vyvolat uvolňování paměti v clusteru mezipamětí, při kterém se uvolní nepoužívaná paměť. Tato možnost je k dispozici jen za zvláštních okolností. Uvolňování paměti je obvykle spravováno rozhraním .NET Framework a funkcemi pro správu paměti clusteru mezipamětí technologie AppFabric.
Get-Help	Poskytuje nápovědu ke všem podporovaným příkazům. V klíčovém slově lze použít znak *, a filtrovat tak množství zobrazovaných informací nápovědy, například: Get-Help new* Get-Help Start* Get-Help *cache Get-Help *cachehost
exit	Ukončí relaci prostředí Windows PowerShell.
cls	Vymaže obrazovku prostředí Windows PowerShell.

Další odkazy

Koncepty

Konfigurace mezipaměti pomocí prostředí Windows PowerShell (ukládání do mezipaměti technologie Windows Server AppFabric)
Nastavení konfigurace (ukládání do mezipaměti technologie Windows Server AppFabric)
Možnosti konfigurace ukládání do mezipaměti technologie Windows Server AppFabric
Řešení potíží s ukládáním do mezipaměti technologie Windows Server AppFabric
Koncepce ukládání do mezipaměti technologie Windows Server AppFabric
Vývoj klienta mezipaměti (ukládání do mezipaměti technologie Windows Server AppFabric)

  2011-12-05