Администрирование кэша с помощью 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 необходимо щелкнуть его правой кнопкой мыши и выбрать пункт Запуск от имени администратора.

Существует две основные категории команд PowerShell для кэширования AppFabric: команды администрирования и команды конфигурации. В этом разделе рассматриваются команды администрирования. Дополнительные сведения о командах конфигурации см. в разделе Настройка кэша с помощью 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.

• При внесении основанных на XML изменений в конфигурацию кластера с помощью команд Export-CacheClusterConfig и Import-CacheClusterConfig можно изменить параметры конфигурации кластера (XML-атрибуты) в XML-файле, однако добавление или удаление именованных кэшей и узлов кэша посредством вставки или удаления XML-элементов не поддерживается.

• Использование команд кластера кэша Start-CacheCluster, Stop-CacheCluster и Restart-CacheCluster включает координирование состояния службы узлов кэша Windows на всех серверах кэширования в кластере. Выполнение этих команд может занять больше времени, когда ведущие узлы выполняют роль управления кластером; большинство ведущих узлов должно оставаться запущенным, а остальные узлы кэша могут останавливаться и запускаться.

• Всегда следует запускать и останавливать службу кэша с помощью команд кластера кэша Start-CacheCluster, Stop-CacheCluster и Restart-CacheCluster. Запуск и остановка этой службы в средстве администрирования служб может привести к зависанию. Кроме того, эти команды должны выполняться из сеанса 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): общий объем памяти, которая выделена для хранения данных на узле кэша; указывается в мегабайтах (МБ). 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	Останавливает указанную службу кэша. Примечание Команда Stop-CacheHost не остановит службу узла кэша в Windows, если та выполняет роль управления кластером и ее остановка приведет к завершению работы всего кластера. Дополнительные сведения см. в разделе Ведущие узлы и управление кластером (кэширование в 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. Обратите внимание на то, что данный компонент поддерживается только для узлов кэша, на которых запущен выпуск Enterprise или DataCenter системы Windows Server. 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 для сеанса Windows PowerShell. Ко всем указанным именам файлов добавляется ".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