Windows PowerShell을 사용한 캐시 관리(AppFabric 1.1)

Windows PowerShell을 사용하여 캐시 클러스터, 캐시 호스트 및 캐시 자체를 관리할 수 있습니다. 캐시 관리 기능이 설치된 컴퓨터를 사용하는 경우 시작 메뉴로 이동하여 모든 프로그램, Windows Server용 Microsoft AppFabric 1.1, 캐싱 관리 Windows PowerShell을 차례로 클릭하면 됩니다.

참고

일부 관리 명령이 제대로 작동하려면 관리자 권한으로 Windows PowerShell을 실행해야 합니다. 캐싱 관리 Windows PowerShell 바로 가기의 경우 바로 가기를 마우스 오른쪽 단추로 클릭한 다음 관리자 권한으로 실행을 선택합니다.

AppFabric 캐싱 PowerShell 명령에는 관리 명령과 구성 명령의 두 가지 기본 범주가 있습니다. 이 항목에서는 관리 명령을 중점적으로 다룹니다. 구성 명령에 대한 자세한 내용은 Windows PowerShell을 사용한 캐시 구성(AppFabric 1.1 캐싱)을 참조하십시오. 이 항목의 표에서는 관리 명령이 여러 범주로 나누어져 있습니다. 일부 명령은 여러 테이블에 포함되어 있고, 네 가지 명령 범주에 각각 적용할 때 다른 매개 변수를 표시합니다.

• 캐시 클러스터 관련 명령

• 캐시 호스트 관련 명령

• 캐시 관련 명령

• 콘솔 관리 명령

AppFabric 1.1의 2012년 3월자 업데이트의 명령 이름 변경

AppFabric 1.1의 2012년 3월자 업데이트 업데이트에는 AppFabric용 Windows PowerShell 명령에 대한 이름 변경이 포함되어 있으며 이러한 변경을 통해 명령에 대한 이해를 높이고 일관성을 향상시킬 수 있습니다. 다음 표에서 원래 명령 이름(RTM)과 2012년 3월 기준 명령 이름(QFE)에 대해 설명합니다.

이전 버전과의 호환성을 유지할 수 있도록 이전 명령 이름을 새 명령 이름의 별칭으로 지정하는 PowerShell 스크립트를 제공합니다. 매개 변수 이름에 대한 변경도 PowerShell 모듈 내에 별칭으로 지정되어 있습니다.

Windows PowerShell 세션 내에서 도움말 보기

아래 정보는 AppFabric의 캐싱 기능에 대한 관리 명령을 요약한 것입니다. Windows PowerShell 세션 내에서도 도움말을 볼 수 있습니다. 예를 들어, 다음 명령은 모든 관리 명령을 표시합니다.

get-command -module DistributedCacheAdministration

특정 명령에 대한 도움말이 필요한 경우 get-help 명령을 사용할 수 있습니다. 예를 들어, 다음 명령은 New-Cache 명령에 대한 전체 도움말을 표시합니다.

get-help New-Cache -full

중요한 고려 사항

이 항목에 설명된 Windows PowerShell 명령을 사용하는 경우 다음 사항을 고려해야 합니다.

• 캐시 클러스터의 모든 캐시 서버에서 이러한 Windows PowerShell 명령을 사용하는 사람의 보안 ID에 관리자 권한이 있어야 합니다.

• 명령의 매개 변수 값은 대/소문자를 구분합니다. 예를 들어, 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 명령을 보여 줍니다.

명령(RTM)	명령(QFE)	설명
Use-CacheCluster	Connect-AFCacheClusterConfiguration	Windows PowerShell 세션의 컨텍스트를 원하는 캐시 클러스터로 설정합니다. Windows PowerShell 세션을 시작하는 경우 먼저 이 명령을 실행해야 합니다. 캐시 호스트에 있는 경우 컴퓨터의 캐시 구성에서 매개 변수를 가져오기 때문에 매개 변수 없이 이 명령을 실행합니다. 호스트가 아닌 컴퓨터에서 실행하는 경우 아래 명령을 사용하여 원하는 캐시 클러스터를 지정할 수 있습니다. 매개 변수 설명은 다음과 같습니다. Provider: 클러스터 구성 설정을 저장하는 데 사용되는 공급자입니다. 구성 정보의 저장 방법에 따라 System.Data.SqlClient 또는 XML일 수 있습니다. ConnectionString: 데이터베이스 또는 XML 구성 파일 위치에 대한 연결 문자열입니다.
Start-CacheCluster	Start-AFCacheCluster	클러스터의 모든 캐시 서비스를 시작합니다. 리드 호스트가 먼저 시작됩니다. 다시 부팅한 후 캐시 서비스가 자동으로 시작되지 않으므로 Start-CacheCluster 또는 Start-CacheHost를 호출하여 서비스를 시작해야 합니다. 이 명령을 사용하려면 관리자 권한이 있어야 합니다.
Stop-CacheCluster	Stop-AFCacheCluster	클러스터의 모든 캐시 서비스를 중지합니다. 이 명령을 사용하려면 관리자 권한이 있어야 합니다.
Restart-CacheCluster	Restart-AFCacheCluster	클러스터의 모든 캐시 서비스를 올바른 순서로 다시 시작합니다. 이 명령을 사용하려면 관리자 권한이 있어야 합니다.
Get-CacheClusterHealth	Get-AFCacheClusterHealth	캐시 클러스터의 상태에 대한 통계를 반환합니다.
Export-CacheClusterConfig	Export-AFCacheClusterConfiguration	Import-CacheClusterConfig와 함께 직렬로 사용되는 이 명령을 통해 XML에서 클러스터 구성 설정을 편집할 수 있습니다. 자세한 내용은 클러스터 구성 설정 편집을 참조하십시오. 이 명령은 클러스터에 현재 존재하는 클러스터 구성 설정을 지정한 XML 기반 구성 파일로 내보냅니다. 클러스터 구성 설정을 저장하도록 선택한 위치(SQL Server 또는 공유 네트워크 폴더)에 관계없이 이 명령을 사용할 수 있습니다. 매개 변수 설명은 다음과 같습니다. File: 만들려는 XML 기반 구성 파일의 정규화된 경로 및 이름으로, 이 파일은 현재 캐시 클러스터 구성 설정을 설명합니다. 예를 들면 다음과 같습니다. Export-CacheClusterConfig -File c:\Temp\CurrentClusterConfig.xml
Import-CacheClusterConfig	Import-AFCacheClusterConfiguration	Export-CacheClusterConfig와 함께 직렬로 사용되는 이 명령을 통해 XML에서 클러스터 구성 설정을 편집할 수 있습니다. 자세한 내용은 클러스터 구성 설정 편집을 참조하십시오. 이 명령은 지정한 XML 기반 구성 파일에 설명된 클러스터 구성 설정을 가져옵니다. 클러스터 구성 설정을 저장하도록 선택한 위치(SQL Server 또는 공유 네트워크 폴더)에 관계없이 이 명령을 사용할 수 있습니다. 변경 내용을 적용하려면 Restart-CacheCluster를 사용하여 클러스터를 다시 시작해야 합니다. 매개 변수 설명은 다음과 같습니다. File: 클러스터에 적용할 캐시 클러스터 구성 설정을 설명하는 XML 기반 구성 파일의 정규화된 경로 및 이름입니다. Force: 확인 메시지를 표시하지 않고 구성 파일을 가져옵니다. RefreshNow: 실행 중인 클러스터의 캐시 클러스터 구성 설정을 변경합니다. 이 기능은 현재 메모리 관리와 관련된 설정에만 작동합니다. 그러나 이 경우에도 메모리 관리 설정을 적용하려면 개별 캐시 호스트를 다시 시작하거나 클러스터에 추가해야 합니다. 예를 들면 다음과 같습니다. Import-CacheClusterConfig -File c:\CurrentClusterConfig.xml
Grant-CacheAllowedClientAccount	Grant-AFCacheAllowedClientAccount	Windows 계정에 캐시 클러스터에 대한 액세스 권한을 부여합니다. 기본적으로 캐시 호스트의 모든 관리자 계정은 캐시 클러스터에 액세스할 수 있습니다. 다른 계정은 이 명령을 사용하여 허용되는 클라이언트 계정 목록에 명시적으로 추가해야 합니다. 매개 변수 설명은 다음과 같습니다. Account: 캐시 클러스터에 대한 액세스 권한을 부여할 Windows 계정입니다. Force: 지정한 클라이언트 계정이 있는지 확인하지 않고 추가합니다.
Revoke-CacheAllowedClientAccount	Revoke-AFCacheAllowedClientAccount	Windows 계정에서 캐시 클러스터에 대한 액세스 권한을 취소합니다. 이렇게 하면 캐시 호스트의 관리자가 캐시 클러스터에 액세스할 수 없습니다. 매개 변수 설명은 다음과 같습니다. Account: 캐시 클러스터에 대한 액세스 권한을 부여할 Windows 계정입니다.
Get-Cache	Get-AFCache	매개 변수 없이 사용할 경우 캐시 클러스터의 모든 캐시에 대한 정보를 표시합니다. 참고 HostName 매개 변수와 함께 이 명령을 사용하는 방법에 대한 자세한 내용은 다음 표를 참조하십시오.
Update-CacheHostAllowedVersions	Update-AFCacheHostAllowedVersions	캐시 클러스터에 대한 액세스가 허용된 캐시 호스트 및 캐시 클라이언트의 버전 범위를 업데이트합니다. 현재 버전 번호는 다음 릴리스와 관련이 있습니다. 1 = Windows Server AppFabric v1.0 3 = Windows Server용 Microsoft AppFabric 1.1 매개 변수 설명은 다음과 같습니다. BeginClientVersion: 캐시 클라이언트 버전 범위의 시작 값입니다. EndClientVersion: 캐시 클라이언트 버전 범위의 끝 값입니다. BeginServerVersion: 캐시 호스트 버전 범위의 시작 값입니다. EndServerVersion: 캐시 호스트 버전 범위의 끝 값입니다. 자세한 내용은 AppFabric 캐시 클러스터에 대한 업그레이드 절차(AppFabric 1.1)를 참조하십시오.
Stop-CacheNonUpdatedHosts	Stop-AFCacheNonUpdatedHosts	지정된 버전 값과 버전이 다른 캐시 호스트를 중지합니다. 매개 변수 설명은 다음과 같습니다. BeginServerVersion: 캐시 호스트 버전 범위의 시작 값입니다. EndServerVersion: 캐시 호스트 버전 범위의 끝 값입니다. HostTimeout: 각 캐시 호스트가 중지할 때까지 대기해야 하는 시간 제한(초)입니다. Version: 캐시 호스트의 코드 버전입니다. 자세한 내용은 AppFabric 캐시 클러스터에 대한 업그레이드 절차(AppFabric 1.1)를 참조하십시오.
Update-CacheConfigurationStore	Update-AFCacheConfigurationStore	AppFabric 업그레이드 후에 캐시 구성 저장소를 업데이트합니다. 이렇게 하면 Windows Server용 Microsoft AppFabric 1.1 버전으로 업그레이드할 때 캐시 호스트 이름이 동등한 FQDN(정규화된 도메인 이름)으로 변환된 것을 확인할 수 있습니다.

캐시 호스트 관련 명령

다음 표에서는 Windows Powershell에서 캐시 호스트 관련 작업을 수행하는 데 사용할 수 있는 명령을 보여 줍니다.

명령(RTM)	명령(QFE)	설명
Get-CacheHost	Get-AFCacheHost	지정한 캐시 호스트에 대한 정보를 표시합니다. 매개 변수가 전달되지 않은 경우 캐시 클러스터의 구성원인 모든 캐시 서비스를 표시합니다. Shutting Down의 상태는 정상 종료가 진행 중임을 나타냅니다. 매개 변수 설명은 다음과 같습니다. HostName: 캐시 호스트의 이름입니다. CachePort: 캐시 호스트의 캐시 포트 번호입니다. 예를 들면 다음과 같습니다. Get-CacheHost
Get-CacheHostConfig	Get-AFCacheHostConfiguration	지정한 캐시 호스트에 대한 구성 정보를 반환합니다. 매개 변수 설명은 다음과 같습니다. HostName: 캐시 호스트의 이름입니다. CachePort: 캐시 호스트의 캐시 포트 번호입니다. 예를 들면 다음과 같습니다. Get-CacheConfig -HostName CacheServer1 -CachePort 22233
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
Start-CacheHost	Start-AFCacheHost	지정한 캐시 서비스를 시작합니다. 캐시 서버를 다시 부팅한 후 이 명령을 사용해야 캐시 서비스가 실행 중인 캐시 클러스터에 다시 가입할 수 있습니다. 캐시 클러스터가 작동하지 않는 경우 Start-CacheCluster 명령을 대신 사용해야 합니다. 또한 다시 부팅한 후 캐시 서비스가 자동으로 시작되지 않으므로 Start-CacheHost 또는 Start-CacheCluster를 호출하여 서비스를 시작해야 합니다. 매개 변수 설명은 다음과 같습니다. HostName: 캐시 호스트의 이름입니다. CachePort: 캐시 호스트의 캐시 포트 번호입니다. HostTimeout: 지정한 캐시 호스트 시작에 대한 시간 제한 값(초)입니다. 기본값은 60초입니다. 예를 들면 다음과 같습니다. Start-CacheHost -HostName CacheServer1 -CachePort 22233
Stop-CacheHost	Stop-AFCacheHost	지정한 캐시 서비스를 중지합니다. 참고 Stop-CacheHost 명령은 클러스터 관리 역할을 수행하는 캐시 호스트 Windows 서비스를 중지하지 않으며, 캐시 호스트를 중지하면 전체 클러스터가 종료됩니다. 자세한 내용은 리드 호스트 및 클러스터 관리(AppFabric 1.1 캐싱)를 참조하십시오. 매개 변수 설명은 다음과 같습니다. HostName: 캐시 호스트의 이름입니다. CachePort: 캐시 호스트의 캐시 포트 번호입니다. HostTimeout: 지정한 캐시 호스트 시작에 대한 시간 제한 값(초)입니다. Graceful: 정상적인 종료가 시작되도록 지정합니다. 정상적으로 종료되면 캐싱 서비스가 중지되기 전에 캐시 항목이 다른 캐시 호스트로 이동됩니다. 따라서 데이터 손실을 피할 수 있고 캐시 클라이언트가 해당 항목을 다시 채울 필요가 없게 됩니다. Stop-CacheHost 명령의 기본 동작을 정상 종료하기 위해 New-CacheCluster 명령과 GracefulShutdownEnabled 옵션을 사용하여 캐시 클러스터를 만들 수 있습니다. 또한 캐시 클러스터는 GracefulShutdownTimeout을 지정해야 합니다. 경고 실행 서버로 이동되는 캐시 항목을 처리할 수 있는 나머지 메모리와 서버가 충분히 있는지 확인한 경우에만 정상 종료를 시작하십시오. 그렇지 않으면 정상 종료가 중단될 수 있어 취소해야 합니다. 예를 들면 다음과 같습니다. Stop-CacheHost -HostName CacheServer1 -CachePort 22233
Stop-CacheHostShutdown	Stop-AFCacheHostShutdown	진행 중인 정상 종료를 취소합니다. 캐시 호스트가 계속 실행되며 데이터는 손실되지 않습니다. 필요한 경우 일반적인 부하 분산 작업이 수반될 수 있습니다. 매개 변수 설명은 다음과 같습니다. HostName: 캐시 호스트의 이름입니다. CachePort: 캐시 호스트의 캐시 포트 번호입니다.
Restart-CacheHost	Restart-AFCacheHost	지정한 캐시 서비스를 다시 시작합니다. 설정은 Stop-CacheHost에 대한 설정과 동일합니다.
Get-CacheStatistics	Get-AFCacheStatistics	지정한 캐시 호스트에 대한 통계를 표시합니다. 여기에는 총 크기(바이트)와 캐시된 개체, 영역, 명명된 캐시, 요청 및 캐시 누락 수가 포함됩니다. 참고 CacheName 매개 변수와 함께 이 명령을 사용하는 방법에 대한 자세한 내용은 다음 표를 참조하십시오. 매개 변수 설명은 다음과 같습니다. HostName: 캐시 호스트의 이름입니다. CachePort: 캐시 호스트의 캐시 포트 번호입니다. 예를 들면 다음과 같습니다. Get-CacheStatistics -HostName CacheServer1 -CachePort 22233
Get-Cache	Get-AFCache	지정한 캐시 호스트에 있는 모든 캐시와 영역을 표시합니다. 매개 변수 설명은 다음과 같습니다. HostName: 캐시 호스트의 이름입니다. CachePort: 캐시 호스트의 캐시 포트 번호입니다. 예를 들면 다음과 같습니다. Get-Cache -HostName CacheServer1 -CachePort 22233
Get-CacheRegion	Get-AFCacheRegion	캐시 클러스터에 있는 모든 영역의 목록을 반환합니다. 캐시 클라이언트만 영역을 만들거나 제거할 수 있습니다. 그러나 캐시 클러스터가 위치할 캐시 호스트는 캐시 클러스터가 결정합니다. 모든 매개 변수는 선택 사항입니다. 참고 CacheName 매개 변수와 함께 이 명령을 사용하는 방법에 대한 자세한 내용은 다음 표를 참조하십시오. 매개 변수 설명은 다음과 같습니다. MaxRegions: 표시할 최대 영역 수입니다. 이 매개 변수는 MaxRegionsPerHost 매개 변수와 함께 사용할 수 없습니다. MaxRegionsPerHost: 캐시 클러스터의 각 호스트에서 표시할 최대 영역 수입니다. 예를 들면 다음과 같습니다. Get-CacheRegion -MaxRegionsPerHost 4

캐시 관련 명령

다음 표에서는 Windows Powershell을 통해 캐시 관련 작업을 수행하는 데 사용할 수 있는 명령을 보여 줍니다.

명령(RTM)	명령(QFE)	설명
New-Cache	New-AFCache	클러스터가 실행되고 있는 경우 새 명명된 캐시를 만듭니다. CacheName을 제외한 모든 값은 선택 사항입니다. 참고 명명된 캐시는 128개로 제한됩니다. 매개 변수 설명은 다음과 같습니다. 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
Remove-Cache	Remove-AFCache	CacheName 매개 변수에 지정된 명명된 캐시를 제거합니다. 매개 변수 설명은 다음과 같습니다. CacheName: 캐시의 이름입니다. 예를 들면 다음과 같습니다. Remove-Cache -CacheName NamedCache1
Get-CacheConfig	Get-AFCacheConfiguration	CacheName 매개 변수에 지정된 명명된 캐시의 구성 세부 정보를 반환합니다. 매개 변수 설명은 다음과 같습니다. CacheName: 캐시의 이름입니다. 예를 들면 다음과 같습니다. Get-CacheConfig -CacheName NamedCache1
Set-CacheConfig	Set-AFCacheConfiguration	CacheName 매개 변수에 지정된 명명된 캐시의 구성 설정을 업데이트합니다. CacheName 매개 변수를 사용하여 캐시를 변경할 때 캐시 클러스터가 실행되고 있지 않을 수도 있습니다. 또는 Remove-Cache 및 New-Cache 명령을 사용할 수 있습니다. 이러한 명령을 사용하면 클러스터를 중지하여 클러스터의 다른 명명된 캐시에 영향을 주지 않고 명명된 캐시 구성을 변경할 수 있습니다. 자세한 내용은 Windows PowerShell을 사용한 캐시 구성 설정 편집을 참조하십시오. 매개 변수 설명은 다음과 같습니다. CacheName: 캐시의 이름입니다. Secondaries: 값이 1이면 고가용성 기능을 사용할 수 있습니다. 값이 0이면 고가용성 기능을 사용할 수 없습니다. 기본값은 0입니다. 이 기능은 Enterprise 또는 DataCenter 버전의 Windows Server를 실행하는 캐시 호스트에 대해서만 지원됩니다. 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"}. RefreshNow: 실행 중인 캐시 클러스터에서 read-through 및 write-behind 설정을 업데이트합니다. 다른 설정은 이 스위치로 업데이트할 수 없습니다. 예를 들면 다음과 같습니다. Set-CacheConfig -CacheName NamedCache1 -TimeToLive 30
Get-CacheStatistics	Get-AFCacheStatistics	CacheName 매개 변수에 지정된 명명된 캐시의 통계를 반환합니다. 참고 HostName 및 CachePort 매개 변수와 함께 이 명령을 사용하는 방법에 대한 자세한 내용은 이전 표를 참조하십시오. 매개 변수 설명은 다음과 같습니다. CacheName: 캐시의 이름입니다. 예를 들면 다음과 같습니다. Get-CacheStatistics -CacheName NamedCache1
Get-CacheRegion	Get-AFCacheRegion	CacheName 매개 변수에 지정된 명명된 캐시에 있는 모든 영역의 목록을 반환합니다. 캐시 클라이언트만 영역을 만들거나 제거할 수 있습니다. 각 영역이 위치할 캐시 호스트는 캐시 클러스터가 제어합니다. 참고 HostName 및 CachePort 매개 변수와 함께 이 명령을 사용하는 방법에 대한 자세한 내용은 이전 표를 참조하십시오. 매개 변수 설명은 다음과 같습니다. CacheName: 캐시의 이름입니다. 예를 들면 다음과 같습니다. Get-CacheRegion -CacheName NamedCache1

콘솔 관리 명령

다음 표에서는 Windows Powershell 기반 캐시 관리 도구 관리와 관련된 작업을 수행하는 데 사용할 수 있는 명령을 보여 줍니다.

명령(RTM)	명령(QFE)	설명
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 세션에 대한 이벤트만 추적하고 캐시 클라이언트 또는 캐시 호스트에 대한 이벤트는 추적하지 않습니다.
Clear-CacheLogging	Clear-AFCacheLogging	Set-CacheLogging에 의해 시작된 로깅을 중지합니다.
Invoke-CacheGC	Invoke-AFCacheGarbageCollector	캐시 클러스터에서 수동으로 가비지 수집을 호출하여 사용되지 않은 메모리를 해제합니다. 이 명령은 특별한 경우에만 사용할 수 있습니다. 일반적으로 가비지 수집은 .NET Framework 및 AppFabric 캐시 클러스터의 메모리 관리 기능에 의해 관리됩니다.
exit	exit	Windows PowerShell 세션을 종료합니다.
cls	cls	Windows PowerShell 화면을 지웁니다.

참고 항목

개념

Windows PowerShell을 사용한 캐시 구성(AppFabric 1.1 캐싱)
구성 설정
AppFabric 캐싱 구성 옵션
AppFabric 캐싱 문제 해결
AppFabric 캐싱 개념(AppFabric 1.1 캐싱)
캐시 클라이언트 개발

  2012-04-05