Azure PowerShell을 사용하여 Azure Redis 관리
Azure Managed Redis
Azure Managed Redis(미리 보기) 인스턴스를 만들려면 Azure Portal에 로그인하고 리소스 만들기를 선택합니다.
새로 만들기 페이지에서 데이터베이스를 선택한 다음, Azure Cache for Redis를 선택합니다.
새 Redis Cache 페이지에서 새 캐시의 설정을 구성합니다.
설정 값 선택 설명 구독 드롭다운하여 구독을 선택합니다. 이 새 Azure Managed Redis 인스턴스를 만들 구독입니다. 리소스 그룹 드롭다운하여 리소스 그룹을 선택하거나, 새로 만들기를 선택하고 새 리소스 그룹 이름을 입력합니다. 캐시 및 기타 리소스를 만들 새 리소스 그룹의 이름입니다. 모든 앱 리소스를 하나의 리소스 그룹에 배치하면 앱 리소스를 쉽게 관리하거나 삭제할 수 있습니다. DNS 이름 지역에서 고유한 이름을 입력합니다. 캐시 이름은 숫자, 문자 또는 하이픈만 포함하는 캐시의 지역 이름이 결합된 경우 1~63자의 문자열이어야 합니다. (캐시 이름이 45자 미만인 경우 현재 사용 가능한 모든 지역에서 작동해야 합니다.) 이름은 숫자 또는 문자로 시작하고 끝나야 하며 연속 하이픈을 포함할 수 없습니다. 캐시 인스턴스의 호스트 이름은 \<DNS name\>.\<Azure region\>.redis.azure.net입니다.위치 드롭다운하여 위치를 선택합니다. Azure Managed Redis는 선택한 Azure 지역에서 사용할 수 있습니다. 캐시 유형 드롭다운하고 성능 계층 및 캐시 크기를 선택합니다. 계층은 Redis 인스턴스의 성능을 결정하는 반면 캐시 크기는 데이터를 저장하는 데 사용할 수 있는 메모리를 결정합니다. 올바른 성능 계층을 선택하는 방법에 대한 지침은 적합한 계층 조싱을 참조 하세요. 
다음: 네트워킹을 선택하고 퍼블릭 또는 프라이빗 엔드포인트를 선택합니다.
다음: 고급을 선택합니다. 여기서는 인스턴스에 추가되도록 모든 Redis 모듈 을 구성할 수 있습니다.
비클러스터형 캐시에 대한 클러스터링 정책을 엔터프라이즈로 설정하거나 클러스터형 캐시에 대한 정책을 OSS로 설정합니다. 클러스터링 정책 선택에 대한 자세한 내용은 클러스터 정책을 참조하세요.
활성 지역 복제를 사용하는 경우 만드는 동안 구성해야 합니다. 이 작업을 수행하는 방법에 대한 지침은 Azure Managed Redis 인스턴스에 대한 활성 지역 복제 구성을 참조 하세요.
Important
Azure Managed Redis(미리 보기) 인스턴스를 만든 후에는 클러스터링 정책을 변경할 수 없습니다. RediSearch를 사용 중인 경우 Enterprise 클러스터 정책이 필요하며
NoEviction이 유일한 제거 정책으로써 지원됩니다.Important
지역에서 복제 그룹에서 이 캐시 인스턴스를 사용하는 경우 인스턴스를 만든 후에는 제거 정책을 변경할 수 없습니다. 캐시를 만들기 전에 주 노드의 제거 정책을 알고 있어야 합니다. 활성 지역 복제에 대한 자세한 내용은 활성 지역 복제 필수 구성 요소를 참조하세요.
Important
캐시 인스턴스를 만든 후에는 모듈을 변경할 수 없습니다. Azure Cache for Redis 인스턴스를 만들 때 모듈을 사용하도록 설정해야 합니다. 캐시를 만든 후에는 모듈 구성을 사용하도록 설정할 수 있는 옵션이 없습니다.
다음: 태그를 선택하고 건너뜁니다.
완료되면 다음: 리뷰 + 만들기를 클릭합니다.
설정을 검토하고 생성를 선택합니다.
Redis 인스턴스를 만드는 데 몇 분 정도 걸립니다. Azure Managed Redis 개요 페이지에서 진행률을 모니터링할 수 있습니다. 상태가 실행 중으로 표시되면 캐시를 사용할 준비가 된 것입니다.
Azure Cache for Redis
캐시를 만들려면 Azure Portal에 로그인합니다. 포털 메뉴에서 리소스 만들기를 선택합니다.
시작 창의 검색 창에서 Aure Cache for Redis를 입력합니다. 검색 결과에서 Azure Cache for Redis를 찾은 다음, 만들기를 선택합니다.
새 Redis Cache 창의 기본 탭에서 캐시에 대해 다음 설정을 구성합니다.
설정 작업 설명 구독 Azure 구독을 선택합니다. Azure Cache for Redis의 새 인스턴스를 만드는 데 사용할 구독. 리소스 그룹 리소스 그룹을 선택하거나 새로 만들기를 선택하고 새 리소스 그룹 이름을 입력합니다. 캐시 및 기타 리소스를 만들 리소스 그룹의 이름. 모든 앱 리소스를 하나의 리소스 그룹에 배치하면 앱 리소스를 쉽게 관리하거나 삭제할 수 있습니다. DNS 이름 고유한 이름을 입력합니다. 캐시 이름은 숫자, 문자 및 하이픈만 포함하는 1~63자의 문자열이어야 합니다. 이름은 숫자 또는 문자로 시작하고 끝나야 하며 연속 하이픈을 포함할 수 없습니다. 캐시 인스턴스의 호스트 이름은 \<DNS name>.redis.cache.windows.net입니다.위치 위치를 선택합니다. 캐시를 사용하는 다른 서비스 근처에 있는 Azure 지역. 캐시 SKU SKU를 선택합니다. SKU는 캐시에 사용할 수 있는 크기, 성능 및 기능 매개 변수를 결정합니다. 자세한 내용은 Azure Cache for Redis 개요를 참조하세요. 캐시 크기 캐시 크기를 선택합니다. 자세한 내용은 Azure Cache for Redis 개요를 참조하세요. 네트워킹 탭을 선택하거나 다음: 네트워킹을 선택합니다.
네트워킹 탭에서 캐시에 사용할 연결 방법을 선택합니다.
고급 탭을 선택하거나 다음: 고급을 선택합니다.
고급 창에서 다음 정보에 따라 인증 방법을 확인하거나 선택합니다.
- 기본적으로 새 기본, 표준 또는 프리미엄 캐시의 경우 Microsoft Entra 인증이 활성화되고 액세스 키 인증이 비활성화됩니다.
- 기본 또는 표준 캐시의 경우 비 TLS 포트 선택 영역을 선택/해제할 수 있습니다.
- 표준 및 프리미엄 캐시의 경우 가용성 영역을 사용하도록 선택할 수 있습니다. 캐시를 만든 후에는 가용성 영역을 비활성화할 수 없습니다.
- 프리미엄 캐시의 경우 비 TLS 포트, 클러스터링, 관리 ID 및 데이터 지속성에 대한 설정을 구성합니다.
Important
최적의 보안을 위해 관리 ID와 함께 Microsoft Entra ID를 사용하여 가능한 경우 캐시에 대한 요청에 권한을 부여하는 것이 좋습니다. Microsoft Entra ID 및 관리 ID를 사용한 인증은 공유 액세스 키 인증에 비해 뛰어난 보안과 사용 편의성을 제공합니다. 캐시에서 관리 ID를 사용하는 방법에 대한 자세한 내용은 캐시 인증을 위한 Microsoft Entra ID 사용을 참조하세요.
(선택 사항) 태그 탭을 선택하거나 다음: 태그를 선택합니다.
(선택 사항) 태그 탭에서 캐시 리소스를 분류하려는 경우 태그 이름과 값을 입력합니다.
검토 + 만들기 단추를 선택합니다.
검토 + 만들기 탭에서 Azure는 자동으로 구성의 유효성을 검사합니다.
녹색 유효성 검사 통과 메시지가 표시되면 만들기를 선택합니다.
새 캐시 배포는 몇 분 동안 발생합니다. Azure Cache for Redis 개요 창에서 배포 진행률을 모니터링할 수 있습니다. 상태가 실행 중으로 표시되면 캐시를 사용할 준비가 된 것입니다.
이 문서에서는 Azure Redis 인스턴스를 만들고, 업데이트하고, 크기를 조정하는 방법을 보여 줍니다.
참고 항목
Azure에는 리소스를 만들고 사용하는 데 필요한 두 가지 배포 모델이 있습니다. Azure Resource Manager 및 클래식이라는 두 가지 배포 모델이 있다는 것을 이해해야 합니다. 이 문서에서는 Resource Manager 배포 모델의 사용법에 대해 설명합니다. 새 배포에는 클래식 배포 모델 대신 Resource Manager 배포 모델을 사용하는 것이 좋습니다.
두 배포 모델에 대한 자세한 내용은 Azure Resource Manager 및 클래식 배포: 배포 모델 및 리소스 상태 이해를 참조하세요.
필수 조건
Azure PowerShell을 이미 설치한 경우 Azure PowerShell 버전 12.4.0 이상이 있어야 합니다. Azure PowerShell 명령 프롬프트에서 이 명령을 사용하여 Azure PowerShell의 버전을 확인할 수 있습니다.
Get-Module Az | format-table version
먼저 다음 명령을 사용하여 Azure에 로그인해야 합니다.
Connect-AzAccount
Microsoft Azure 로그인 대화 상자에서 Azure 계정의 메일 주소 및 암호를 지정합니다.
다음으로, 여러 Azure 구독이 있는 경우 Azure 구독을 설정해야 합니다. 현재 구독 목록을 보려면 다음 명령을 실행합니다.
Get-AzSubscription | sort SubscriptionName | Select SubscriptionName
구독을 지정하려면 다음 명령을 실행합니다. 다음 예제에서 구독 이름은 ContosoSubscription입니다.
Select-AzSubscription -SubscriptionName ContosoSubscription
Azure Resource Manager에서 Windows PowerShell을 사용하려면 먼저 다음 설정을 확인해야 합니다.
- Windows PowerShell, 버전 3.0 또는 4.0. Windows PowerShell 버전을 확인하려면
$PSVersionTable을 입력하고PSVersion값이 3.0 또는 4.0인지를 확인합니다. 호환 버전을 설치하려면 Windows Management Framework 3.0을 참조하세요.
이 자습서에 나오는 cmdlet에 대한 자세한 도움말을 보려면 Get-Help cmdlet을 사용합니다.
Get-Help <cmdlet-name> -Detailed
예를 들어 New-AzRedisEnterpriseCache cmdlet에 대한 도움말을 보려면 다음과 같이 입력합니다.
Get-Help New-AzRedisEnterpriseCache -Detailed
다른 클라우드에 연결하는 방법
기본적으로 Azure 환경은 글로벌 Azure 클라우드 인스턴스를 나타내는 AzureCloud입니다. 다른 인스턴스에 연결하려면 원하는 환경 또는 환경 이름을 사용하여 -Environment 또는 -EnvironmentName 명령줄 스위치와 함께 Connect-AzAccount 명령을 사용합니다.
사용 가능한 환경 목록을 보려면 Get-AzEnvironment cmdlet을 실행합니다.
Azure Government 클라우드를 연결하려면
Azure Government 클라우드를 연결하려면 다음 명령 중 하나를 사용합니다.
Connect-AzAccount -EnvironmentName AzureUSGovernment
또는
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureUSGovernment)
Azure Government 클라우드 내에 캐시를 만들려면 다음 위치 중 하나를 사용합니다.
- USGov 버지니아
- USGov 아이오와
Azure Government 클라우드에 대한 자세한 내용은 Microsoft Azure Government 및 Microsoft Azure Government 개발자 가이드를 참조하세요.
21Vianet에서 운영하는 Microsoft Azure 클라우드에 연결하려면
21Vianet에서 운영하는 Azure 클라우드에 연결하려면 다음 명령 중 하나를 사용합니다.
Connect-AzAccount -EnvironmentName AzureChinaCloud
또는
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureChinaCloud)
21Vianet에서 운영하는 Azure 클라우드에서 캐시를 만들려면 다음 위치 중 하나를 사용합니다.
- 중국 동부
- 중국 북부
Microsoft Azure Germany에 연결하려면
Microsoft Azure Germany에 연결하려면 다음 명령 중 하나를 사용합니다.
Connect-AzAccount -EnvironmentName AzureGermanCloud
또는
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureGermanCloud)
Microsoft Azure Germany에서 캐시를 만들려면 다음 위치 중 하나를 사용합니다.
- 독일 중부
- 독일 북동부
Microsoft Azure Germany에 대한 자세한 내용은 Microsoft Azure Germany를 참조하세요.
Azure Managed Redis PowerShell 매개 변수 및 속성
모든 Azure Managed Redis PowerShell 매개 변수 및 속성 목록은 New-AzRedisEnterpriseCache를 참조하세요.
Azure Managed Redis를 만들려면
New-AzRedisEnterpriseCache cmdlet을 사용하여 새 Azure Managed Redis 인스턴스를 만듭니다.
Important
Azure Portal을 사용하여 구독에서 Azure Managed Redis를 처음 만들 때 포털은 해당 구독에 Microsoft.Cache 대한 네임스페이스를 등록합니다. PowerShell을 사용하여 구독에서 첫 번째 Azure Managed Redis를 만들려는 경우 먼저 다음 명령을 사용하여 해당 네임스페이스를 등록해야 합니다. 그렇지 않으면 cmdlet(예: New-AzRedisEnterpriseCache 실패)입니다 Get-AzRedisEnterpriseCache .
Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache"
New-AzRedisEnterpriseCache에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.
PS C:\> Get-Help New-AzRedisEnterpriseCache -detailed
NAME
New-AzRedisEnterpriseCache
SYNOPSIS
Creates a new Azure Managed Redis.
SYNTAX
New-AzRedisEnterpriseCache -Name <String> -ResourceGroupName <String> -Location <String> [-RedisVersion <String>]
[-Sku <String>] [-MaxMemoryPolicy <String>] [-RedisConfiguration <Hashtable>] [-EnableNonSslPort
<Boolean>] [-ShardCount <Integer>] [-VirtualNetwork <String>] [-Subnet <String>] [-StaticIP <String>]
[<CommonParameters>]
DESCRIPTION
The New-AzRedisEnterpriseCache cmdlet creates a new Azure Managed Redis.
PARAMETERS
-Name <String>
Name of the Azure Managed Redis to create.
-ResourceGroupName <String>
Name of resource group in which to create the Azure Managed Redis.
-Location <String>
Location in which to create the Azure Managed Redis.
-RedisVersion <String>
RedisVersion is deprecated and will be removed in future release.
-Sku <String>
Sku of Azure Managed Redis.
-MaxMemoryPolicy <String>
The 'MaxMemoryPolicy' setting has been deprecated. Please use 'RedisConfiguration' setting to set
MaxMemoryPolicy. e.g. -RedisConfiguration @{"maxmemory-policy" = "allkeys-lru"}
-RedisConfiguration <Hashtable>
All Redis Configuration Settings. Few possible keys: rdb-backup-enabled, rdb-storage-connection-string,
rdb-backup-frequency, maxmemory-reserved, maxmemory-policy, notify-keyspace-events, hash-max-ziplist-entries,
hash-max-ziplist-value, set-max-intset-entries, zset-max-ziplist-entries, zset-max-ziplist-value, databases.
-EnableNonSslPort <Boolean>
EnableNonSslPort is used by Azure Managed Redis. If no value is provided, the default value is false and the
non-SSL port will be disabled. Possible values are true and false.
-ShardCount <Integer>
The number of shards to create on a Cluster Cache.
-VirtualNetwork <String>
The exact ARM resource ID of the virtual network to deploy the Azure Managed Redis in. Example format: /subscriptions/{
subid}/resourceGroups/{resourceGroupName}/providers/Microsoft.ClassicNetwork/VirtualNetworks/{vnetName}
-Subnet <String>
Required when deploying an Azure Managed Redis inside an existing Azure Virtual Network.
-StaticIP <String>
Required when deploying an Azure Managed Redis inside an existing Azure Virtual Network.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
기본 매개 변수로 캐시를 만들려면 다음 명령을 실행합니다.
New-AzRedisEnterpriseCache -ResourceGroupName myGroup -Name mycache -Location "North Central US"
ResourceGroupName, Name 및 Location은 필수 매개 변수이지만 나머지는 선택 사항이며 기본값을 포함합니다. 이전 명령을 실행하면 지정된 이름, 위치 및 리소스 그룹이 있는 Azure Managed Redis 인스턴스가 만들어집니다. 인스턴스 크기는 1GB이며 비 SSL 포트는 사용하지 않도록 설정되어 있습니다.
클러스터링을 사용하려면 ShardCount 매개 변수를 사용하여 분할된 데이터베이스 수를 지정합니다.
RedisConfiguration 매개 변수에 대한 값을 지정하려면 @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}처럼 키/값 쌍으로 값을 {}로 묶습니다. 다음 예제에서는 maxmemory 정책 및 키스페이스 알림이 allkeys-random 구성된 KEA1GB 캐시를 만듭니다. 자세한 내용은 Keyspace 알림(고급 설정) 및 메모리 정책을 참조하세요.
New-AzRedisEnterpriseCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}
캐시를 만드는 동안 데이터베이스 설정을 구성하려면
databases 설정은 캐시를 만드는 동안에만 구성할 수 있습니다. 다음 예제에서는 New-AzRedisEnterpriseCache cmdlet을 사용하여 48개의 데이터베이스가 있는 캐시를 만듭니다.
New-AzRedisEnterpriseCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku B1 -RedisConfiguration @{"databases" = "48"}
속성에 대한 databases 자세한 내용은 기본 Azure Managed Redis 서버 구성을 참조하세요. New-AzRedisEnterpriseCache cmdlet을 사용하여 캐시를 만드는 방법에 대한 자세한 내용은 이전 Azure Managed Redis 섹션을 참조하세요.
Azure Managed Redis를 업데이트하려면
Azure Managed Redis 인스턴스는 [Set-AzRedisEnterpriseCache] cmdlet을 사용하여 업데이트됩니다.
Set-AzRedisEnterpriseCache에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.
PS C:\> Get-Help Set-AzRedisEnterpriseCache -detailed
NAME
Set-AzRedisEnterpriseCache
SYNOPSIS
Set Azure Managed Redis updatable parameters.
SYNTAX
Set-AzRedisEnterpriseCache -Name <String> -ResourceGroupName <String> [-Sku <String>]
[-MaxMemoryPolicy <String>] [-RedisConfiguration <Hashtable>] [-EnableNonSslPort <Boolean>] [-ShardCount
<Integer>] [<CommonParameters>]
DESCRIPTION
The Set-AzRedisEnterpriseCache cmdlet sets Azure Managed Redis parameters.
PARAMETERS
-Name <String>
Name of the Azure Managed Redis to update.
-ResourceGroupName <String>
Name of the resource group for the cache.
-Sku <String>
Sku of Azure Managed Redis.
-MaxMemoryPolicy <String>
The 'MaxMemoryPolicy' setting has been deprecated. Please use 'RedisConfiguration' setting to set
MaxMemoryPolicy. e.g. -RedisConfiguration @{"maxmemory-policy" = "allkeys-lru"}
-RedisConfiguration <Hashtable>
All Redis Configuration Settings. Few possible keys: rdb-backup-enabled, rdb-storage-connection-string,
rdb-backup-frequency, maxmemory-reserved, maxmemory-policy, notify-keyspace-events, hash-max-ziplist-entries,
hash-max-ziplist-value, set-max-intset-entries, zset-max-ziplist-entries, zset-max-ziplist-value.
-EnableNonSslPort <Boolean>
EnableNonSslPort is used by Azure Managed Redis. The default value is null and no change will be made to the
currently configured value. Possible values are true and false.
-ShardCount <Integer>
The number of shards to create on a Cluster Cache.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
cmdlet을 Set-AzRedisEnterpriseCache 사용하여 속성(예: Sku및 EnableNonSslPort값)을 업데이트할 RedisConfiguration 수 있습니다.
다음 명령은 myCache라는 Azure Managed Redis에 대한 maxmemory-policy를 업데이트합니다.
Set-AzRedisEnterpriseCache -ResourceGroupName "myGroup" -Name "myCache" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random"}
Azure Managed Redis에 대한 정보를 얻으려면
Get-AzRedisEnterpriseCache cmdlet을 사용하여 캐시에 대한 정보를 검색할 수 있습니다.
Get-AzRedisEnterpriseCache에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.
PS C:\> Get-Help Get-AzRedisEnterpriseCache -detailed
NAME
Get-AzRedisEnterpriseCache
SYNOPSIS
Gets details about a single cache or all caches in the specified resource group or all caches in the current
subscription.
SYNTAX
Get-AzRedisEnterpriseCache [-Name <String>] [-ResourceGroupName <String>] [<CommonParameters>]
DESCRIPTION
The Get-AzRedisEnterpriseCache cmdlet gets the details about a cache or caches depending on input parameters. If both
ResourceGroupName and Name parameters are provided then Get-AzRedisEnterpriseCache will return details about the
specific cache name provided.
If only ResourceGroupName is provided than it will return details about all caches in the specified resource group.
If no parameters are given than it will return details about all caches the current subscription.
PARAMETERS
-Name <String>
The name of the cache. When this parameter is provided along with ResourceGroupName, Get-AzRedisEnterpriseCache
returns the details for the cache.
-ResourceGroupName <String>
The name of the resource group that contains the cache or caches. If ResourceGroupName is provided with Name
then Get-AzRedisEnterpriseCache returns the details of the cache specified by Name. If only the ResourceGroup
parameter is provided, then details for all caches in the resource group are returned.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
현재 구독의 모든 캐시에 대한 정보를 반환하려면 매개 변수 없이 Get-AzRedisEnterpriseCache를 실행합니다.
Get-AzRedisEnterpriseCache
특정 리소스 그룹의 모든 캐시에 대한 정보를 반환하려면 ResourceGroupName 매개 변수와 함께 Get-AzRedisEnterpriseCache를 실행합니다.
Get-AzRedisEnterpriseCache -ResourceGroupName myGroup
특정 캐시에 대한 정보를 반환하려면 캐시 이름을 포함하는 Name 매개 변수와 해당 캐시를 포함하는 리소스 그룹이 있는 ResourceGroupName 매개 변수와 함께 Get-AzRedisEnterpriseCache를 실행합니다.
PS C:\> Get-AzRedisEnterpriseCache -Name myCache -ResourceGroupName myGroup
Name : mycache
Id : /subscriptions/12ad12bd-abdc-2231-a2ed-a2b8b246bbad4/resourceGroups/myGroup/providers/Mi
crosoft.Cache/Redis/mycache
Location : South Central US
Type : Microsoft.Cache/Redis
HostName : mycache.redis.cache.windows.net
Port : 10000
ProvisioningState : Succeeded
SslPort : 6380
RedisConfiguration : {[maxmemory-policy, volatile-lru], [maxmemory-reserved, 62], [notify-keyspace-events, KEA],
[maxclients, 1000]...}
EnableNonSslPort : False
RedisVersion : 3.0
Sku : B1
ResourceGroupName : myGroup
VirtualNetwork :
Subnet :
StaticIP :
TenantSettings : {}
ShardCount :
Azure Managed Redis에 대한 액세스 키를 검색하려면
캐시에 대한 액세스 키를 검색하려면 Get-AzRedisEnterpriseCacheKey cmdlet을 사용할 수 있습니다.
Get-AzRedisEnterpriseCacheKey에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.
PS C:\> Get-Help Get-AzRedisEnterpriseCacheKey -detailed
NAME
Get-AzRedisEnterpriseCacheKey
SYNOPSIS
Gets the accesskeys for the specified Azure Managed Redis.
SYNTAX
Get-AzRedisEnterpriseCacheKey -Name <String> -ResourceGroupName <String> [<CommonParameters>]
DESCRIPTION
The Get-AzRedisEnterpriseCacheKey cmdlet gets the access keys for the specified cache.
PARAMETERS
-Name <String>
Name of the Azure Managed Redis.
-ResourceGroupName <String>
Name of the resource group for the cache.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
캐시에 대한 키를 검색하려면 Get-AzRedisEnterpriseCacheKey cmdlet을 호출하고 캐시 이름과 해당 캐시를 포함하는 리소스 그룹 이름을 전달합니다.
PS C:\> Get-AzRedisEnterpriseCacheKey -Name myCache -ResourceGroupName myGroup
PrimaryKey : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
SecondaryKey : ABhfB757JgjIgt785JgKH9865eifmekfnn649303JKL=
Azure Managed Redis에 대한 액세스 키를 다시 생성하려면
캐시에 대한 액세스 키를 다시 생성하려면 New-AzRedisEnterpriseCacheKey cmdlet을 사용할 수 있습니다.
New-AzRedisEnterpriseCacheKey에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.
PS C:\> Get-Help New-AzRedisEnterpriseCacheKey -detailed
NAME
New-AzRedisEnterpriseCacheKey
SYNOPSIS
Regenerates the access key of an Azure Managed Redis.
SYNTAX
New-AzRedisEnterpriseCacheKey -Name <String> -ResourceGroupName <String> -KeyType <String> [-Force] [<CommonParameters>]
DESCRIPTION
The New-AzRedisEnterpriseCacheKey cmdlet regenerate the access key of an Azure Managed Redis.
PARAMETERS
-Name <String>
Name of the Azure Managed Redis.
-ResourceGroupName <String>
Name of the resource group for the cache.
-KeyType <String>
Specifies whether to regenerate the primary or secondary access key. Possible values are Primary or Secondary.
-Force
When the Force parameter is provided, the specified access key is regenerated without any confirmation prompts.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
캐시에 대한 주 및 보조 키를 다시 생성하려면 New-AzRedisEnterpriseCacheKey cmdlet을 호출하고 이름, 리소스 그룹을 전달하고 KeyType 매개 변수에 대해 Primary 또는 Secondary를 지정합니다. 다음 예제에서는 캐시에 대한 보조 액세스 키가 다시 생성됩니다.
PS C:\> New-AzRedisEnterpriseCacheKey -Name myCache -ResourceGroupName myGroup -KeyType Secondary
Confirm
Are you sure you want to regenerate Secondary key for Azure Managed Redis 'myCache'?
[Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): Y
PrimaryKey : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
SecondaryKey : c53hj3kh4jhHjPJk8l0jji785JgKH9865eifmekfnn6=
Azure Managed Redis를 삭제하려면
Azure Managed Redis를 삭제하려면 Remove-AzRedisEnterpriseCache cmdlet을 사용합니다.
Remove-AzRedisEnterpriseCache에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.
PS C:\> Get-Help Remove-AzRedisEnterpriseCache -detailed
NAME
Remove-AzRedisEnterpriseCache
SYNOPSIS
Remove Azure Managed Redis if exists.
SYNTAX
Remove-AzRedisEnterpriseCache -Name <String> -ResourceGroupName <String> [-Force] [-PassThru] [<CommonParameters>
DESCRIPTION
The Remove-AzRedisEnterpriseCache cmdlet removes an Azure Managed Redis if it exists.
PARAMETERS
-Name <String>
Name of the Azure Managed Redis to remove.
-ResourceGroupName <String>
Name of the resource group of the cache to remove.
-Force
When the Force parameter is provided, the cache is removed without any confirmation prompts.
-PassThru
By default Remove-AzRedisEnterpriseCache removes the cache and does not return any value. If the PassThru par
is provided then Remove-AzRedisEnterpriseCache returns a boolean value indicating the success of the operatio
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
다음 예제에서는 캐시 이름 myCache 가 제거됩니다.
PS C:\> Remove-AzRedisEnterpriseCache -Name myCache -ResourceGroupName myGroup
Confirm
Are you sure you want to remove Azure Managed Redis 'myCache'?
[Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): Y
Azure Managed Redis를 가져오려면
cmdlet을 사용하여 Import-AzRedisEnterpriseCache Azure Managed Redis 인스턴스로 데이터를 가져올 수 있습니다.
Import-AzRedisEnterpriseCache에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.
PS C:\> Get-Help Import-AzRedisEnterpriseCache -detailed
NAME
Import-AzRedisEnterpriseCache
SYNOPSIS
Import data from blobs to Azure Managed Redis.
SYNTAX
Import-AzRedisEnterpriseCache -Name <String> -ResourceGroupName <String> -Files <String[]> [-Format <String>] [-Force]
[-PassThru] [<CommonParameters>]
DESCRIPTION
The Import-AzRedisEnterpriseCache cmdlet imports data from the specified blobs into Azure Managed Redis.
PARAMETERS
-Name <String>
The name of the cache.
-ResourceGroupName <String>
The name of the resource group that contains the cache.
-Files <String[]>
SAS urls of blobs whose content should be imported into the cache.
-Format <String>
Format for the blob. Currently "rdb" is the only supported, with other formats expected in the future.
-Force
When the Force parameter is provided, import will be performed without any confirmation prompts.
-PassThru
By default Import-AzRedisEnterpriseCache imports data in cache and does not return any value. If the PassThru
parameter is provided then Import-AzRedisEnterpriseCache returns a boolean value indicating the success of the
operation.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
다음 명령은 SAS URI에 지정된 Blob에서 Azure Managed Redis로 데이터를 가져옵니다.
PS C:\>Import-AzRedisEnterpriseCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -Files @("https://mystorageaccount.blob.core.windows.net/mycontainername/blobname?sv=2015-04-05&sr=b&sig=caIwutG2uDa0NZ8mjdNJdgOY8%2F8mhwRuGNdICU%2B0pI4%3D&st=2016-05-27T00%3A00%3A00Z&se=2016-05-28T00%3A00%3A00Z&sp=rwd") -Force
Azure Managed Redis를 내보내려면
cmdlet을 사용하여 Export-AzRedisEnterpriseCache Azure Managed Redis 인스턴스에서 데이터를 내보낼 수 있습니다.
Export-AzRedisEnterpriseCache에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.
PS C:\> Get-Help Export-AzRedisEnterpriseCache -detailed
NAME
Export-AzRedisEnterpriseCache
SYNOPSIS
Exports data from Azure Managed Redis to a specified container.
SYNTAX
Export-AzRedisEnterpriseCache -Name <String> -ResourceGroupName <String> -Prefix <String> -Container <String> [-Format
<String>] [-PassThru] [<CommonParameters>]
DESCRIPTION
The Export-AzRedisEnterpriseCache cmdlet exports data from Azure Managed Redis to a specified container.
PARAMETERS
-Name <String>
The name of the cache.
-ResourceGroupName <String>
The name of the resource group that contains the cache.
-Prefix <String>
Prefix to use for blob names.
-Container <String>
SAS url of container where data should be exported.
-Format <String>
Format for the blob. Currently "rdb" is the only supported, with other formats expected in the future.
-PassThru
By default Export-AzRedisEnterpriseCache does not return any value. If the PassThru parameter is provided
then Export-AzRedisEnterpriseCache returns a boolean value indicating the success of the operation.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
다음 명령은 Azure Managed Redis 인스턴스에서 SAS URI로 지정된 컨테이너로 데이터를 내보냅니다.
PS C:\>Export-AzRedisEnterpriseCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -Prefix "blobprefix"
-Container "https://mystorageaccount.blob.core.windows.net/mycontainer?sv=2015-04-05&sr=c&sig=HezZtBZ3DURmEGDduauE7
pvETY4kqlPI8JCNa8ATmaw%3D&st=2016-05-27T00%3A00%3A00Z&se=2016-05-28T00%3A00%3A00Z&sp=rwdl"
Azure Managed Redis를 다시 부팅하려면(미리 보기)
cmdlet을 사용하여 Azure Managed Redis(미리 보기) 인스턴스를 다시 부팅할 Reset-AzRedisEnterpriseCache 수 있습니다.
Reset-AzRedisEnterpriseCache에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.
PS C:\> Get-Help Reset-AzRedisEnterpriseCache -detailed
NAME
Reset-AzRedisEnterpriseCache
SYNOPSIS
Reboot specified node(s) of an Azure Managed Redis instance.
SYNTAX
Reset-AzRedisEnterpriseCache -Name <String> -ResourceGroupName <String> -RebootType <String> [-ShardId <Integer>]
[-Force] [-PassThru] [<CommonParameters>]
DESCRIPTION
The Reset-AzRedisEnterpriseCache cmdlet reboots the specified node(s) of an Azure Managed Redis instance.
PARAMETERS
-Name <String>
The name of the cache.
-ResourceGroupName <String>
The name of the resource group that contains the cache.
-RebootType <String>
Which node to reboot. Possible values are "PrimaryNode", "SecondaryNode", "AllNodes".
-ShardId <Integer>
Which shard to reboot when rebooting a cache with clustering enabled.
-Force
When the Force parameter is provided, reset will be performed without any confirmation prompts.
-PassThru
By default Reset-AzRedisEnterpriseCache does not return any value. If the PassThru parameter is provided
then Reset-AzRedisEnterpriseCache returns a boolean value indicating the success of the operation.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
다음 명령은 지정된 캐시의 두 노드를 모두 재부팅합니다.
PS C:\>Reset-AzRedisEnterpriseCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -RebootType "AllNodes"
-Force
참고 항목
Azure에는 리소스를 만들고 사용하는 데 필요한 두 가지 배포 모델이 있습니다. Azure Resource Manager 및 클래식이라는 두 가지 배포 모델이 있다는 것을 이해해야 합니다. 이 문서에서는 Resource Manager 배포 모델의 사용법에 대해 설명합니다. 새 배포에는 클래식 배포 모델 대신 Resource Manager 배포 모델을 사용하는 것이 좋습니다.
두 배포 모델에 대한 자세한 내용은 Azure Resource Manager 및 클래식 배포: 배포 모델 및 리소스 상태 이해를 참조하세요.
필수 조건
Azure PowerShell을 이미 설치한 경우 Azure PowerShell 버전 1.0.0 이상이 있어야 합니다. Azure PowerShell 명령 프롬프트에서 이 명령을 사용하여 Azure PowerShell의 버전을 확인할 수 있습니다.
Get-Module Az | format-table version
먼저 다음 명령을 사용하여 Azure에 로그인해야 합니다.
Connect-AzAccount
Microsoft Azure 로그인 대화 상자에서 Azure 계정의 메일 주소 및 암호를 지정합니다.
다음으로, 여러 Azure 구독이 있는 경우 Azure 구독을 설정해야 합니다. 현재 구독 목록을 보려면 다음 명령을 실행합니다.
Get-AzSubscription | sort SubscriptionName | Select SubscriptionName
구독을 지정하려면 다음 명령을 실행합니다. 다음 예제에서 구독 이름은 ContosoSubscription입니다.
Select-AzSubscription -SubscriptionName ContosoSubscription
Azure Resource Manager에서 Windows PowerShell을 사용하려면 먼저 다음 설정을 확인해야 합니다.
- Windows PowerShell, 버전 3.0 또는 4.0. Windows PowerShell 버전을 확인하려면
$PSVersionTable을 입력하고PSVersion값이 3.0 또는 4.0인지를 확인합니다. 호환 버전을 설치하려면 Windows Management Framework 3.0을 참조하세요.
이 자습서에 나오는 cmdlet에 대한 자세한 도움말을 보려면 Get-Help cmdlet을 사용합니다.
Get-Help <cmdlet-name> -Detailed
예를 들어 New-AzRedisCache cmdlet에 대한 도움말을 보려면 다음과 같이 입력합니다.
Get-Help New-AzRedisCache -Detailed
다른 클라우드에 연결하는 방법
기본적으로 Azure 환경은 글로벌 Azure 클라우드 인스턴스를 나타내는 AzureCloud입니다. 다른 인스턴스에 연결하려면 원하는 환경 또는 환경 이름을 사용하여 -Environment 또는 -EnvironmentName 명령줄 스위치와 함께 Connect-AzAccount 명령을 사용합니다.
사용 가능한 환경 목록을 보려면 Get-AzEnvironment cmdlet을 실행합니다.
Azure Government 클라우드를 연결하려면
Azure Government 클라우드를 연결하려면 다음 명령 중 하나를 사용합니다.
Connect-AzAccount -EnvironmentName AzureUSGovernment
또는
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureUSGovernment)
Azure Government 클라우드 내에 캐시를 만들려면 다음 위치 중 하나를 사용합니다.
- USGov 버지니아
- USGov 아이오와
Azure Government 클라우드에 대한 자세한 내용은 Microsoft Azure Government 및 Microsoft Azure Government 개발자 가이드를 참조하세요.
21Vianet에서 운영하는 Microsoft Azure 클라우드에 연결하려면
21Vianet에서 운영하는 Azure 클라우드에 연결하려면 다음 명령 중 하나를 사용합니다.
Connect-AzAccount -EnvironmentName AzureChinaCloud
또는
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureChinaCloud)
21Vianet에서 운영하는 Azure 클라우드에서 캐시를 만들려면 다음 위치 중 하나를 사용합니다.
- 중국 동부
- 중국 북부
Microsoft Azure Germany에 연결하려면
Microsoft Azure Germany에 연결하려면 다음 명령 중 하나를 사용합니다.
Connect-AzAccount -EnvironmentName AzureGermanCloud
또는
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureGermanCloud)
Microsoft Azure Germany에서 캐시를 만들려면 다음 위치 중 하나를 사용합니다.
- 독일 중부
- 독일 북동부
Microsoft Azure Germany에 대한 자세한 내용은 Microsoft Azure Germany를 참조하세요.
Azure Cache for Redis PowerShell에 사용되는 속성
다음 표에는 Azure Cache for Redis 인스턴스를 만들고 관리할 때 공통 매개 변수에 대한 Azure PowerShell 속성 및 설명이 포함되어 있습니다.
| 매개 변수 | 설명 | 기본값 |
|---|---|---|
| 이름 | 캐시의 이름 | |
| 위치 | 캐시의 위치 | |
| ResourceGroupName | 캐시를 만들 리소스 그룹 이름 | |
| 크기 | 캐시의 크기. 유효한 값: P1, P2, P3, P4, P5, C0, C1, C2, C3, C4, C5, C6, 250MB, 1GB, 2.5GB, 6GB, 13GB, 26GB, 53GB | 1GB |
| ShardCount | 클러스터링을 사용하는 프리미엄 캐시를 만들 때 만들 분할된 데이터베이스 수. 유효한 값: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 | |
| SKU | 캐시의 SKU를 지정합니다. 유효한 값: 기본, 표준, 프리미엄 | Standard |
| RedisConfiguration | Redis 구성 설정을 지정합니다. 각 설정에 대한 자세한 내용은 다음 RedisConfiguration 속성 테이블을 참조하세요. | |
| EnableNonSslPort | 비 SSL 포트를 사용하는지 여부를 나타냅니다. | False |
| MaxMemoryPolicy | 이 매개 변수는 더 이상 사용되지 않으며 대신 RedisConfiguration을 사용합니다. | |
| StaticIP | VNET에서 캐시를 호스팅하는 경우 서브넷에서 캐시에 대한 고유 IP 주소를 지정합니다. 제공되지 않으면 하나의 IP 주소가 서브넷에서 자동으로 선택됩니다. | |
| 서브넷 | VNET에서 캐시를 호스팅하는 경우에 캐시를 배포할 서브넷의 이름을 지정합니다. | |
| VirtualNetwork | VNET에서 캐시를 호스팅하는 경우에 캐시를 배포할 VNET의 리소스 ID를 지정합니다. | |
| KeyType | 액세스 키를 갱신할 때 다시 생성할 액세스 키를 지정합니다. 유효한 값: 주, 보조 |
RedisConfiguration 속성
| 속성 | 설명 | 가격 책정 계층 |
|---|---|---|
| rdb-backup-enabled | Redis 데이터 지속성 사용 여부 | 프리미엄 전용 |
| rdb-storage-connection-string | Redis 데이터 지속성 | 프리미엄 전용 |
| rdb-backup-frequency | Redis 데이터 지속성 | 프리미엄 전용 |
| maxmemory-reserved | 비 캐시 프로세스를 위해 예약되는 메모리 를 구성합니다 | 표준 및 프리미엄 |
| maxmemory-policy | 캐시에 대한 제거 정책 을 구성합니다 | 모든 가격 책정 계층 |
| notify-keyspace-events | Keyspace 알림 | 표준 및 프리미엄 |
| hash-max-ziplist-entries | 작은 집계 데이터 형식에 대한 메모리 최적화 구성 | 표준 및 프리미엄 |
| hash-max-ziplist-value | 작은 집계 데이터 형식에 대한 메모리 최적화 구성 | 표준 및 프리미엄 |
| set-max-intset-entries | 작은 집계 데이터 형식에 대한 메모리 최적화 구성 | 표준 및 프리미엄 |
| zset-max-ziplist-entries | 작은 집계 데이터 형식에 대한 메모리 최적화 구성 | 표준 및 프리미엄 |
| zset-max-ziplist-value | 작은 집계 데이터 형식에 대한 메모리 최적화 구성 | 표준 및 프리미엄 |
| databases | 데이터베이스 수를 구성합니다. 이 속성은 캐시 만들기에서만 구성할 수 있습니다. | 표준 및 프리미엄 |
Azure Cache for Redis를 만들려면
New-AzRedisCache cmdlet을 사용하여 새 Azure Cache for Redis 인스턴스를 만듭니다.
Important
Azure Portal을 사용하여 구독에 처음으로 Azure Cache for Redis를 만들 때 포털은 해당 구독에 대해 Microsoft.Cache 네임스페이스를 등록합니다. PowerShell을 사용하여 구독에서 첫 번째 Azure Cache for Redis를 만드는 경우, 먼저 다음 명령을 사용하여 해당 네임스페이스를 등록해야 하며 그렇지 않은 경우 New-AzRedisCache 및 Get-AzRedisCache의 cmdlet이 실패합니다.
Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache"
New-AzRedisCache에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.
PS C:\> Get-Help New-AzRedisCache -detailed
NAME
New-AzRedisCache
SYNOPSIS
Creates a new Azure Cache for Redis.
SYNTAX
New-AzRedisCache -Name <String> -ResourceGroupName <String> -Location <String> [-RedisVersion <String>]
[-Size <String>] [-Sku <String>] [-MaxMemoryPolicy <String>] [-RedisConfiguration <Hashtable>] [-EnableNonSslPort
<Boolean>] [-ShardCount <Integer>] [-VirtualNetwork <String>] [-Subnet <String>] [-StaticIP <String>]
[<CommonParameters>]
DESCRIPTION
The New-AzRedisCache cmdlet creates a new Azure Cache for Redis.
PARAMETERS
-Name <String>
Name of the Azure Cache for Redis to create.
-ResourceGroupName <String>
Name of resource group in which to create the Azure Cache for Redis.
-Location <String>
Location in which to create the Azure Cache for Redis.
-RedisVersion <String>
RedisVersion is deprecated and will be removed in future release.
-Size <String>
Size of the Azure Cache for Redis. The default value is 1GB or C1. Possible values are P1, P2, P3, P4, C0, C1, C2, C3,
C4, C5, C6, 250MB, 1GB, 2.5GB, 6GB, 13GB, 26GB, 53GB.
-Sku <String>
Sku of Azure Cache for Redis. The default value is Standard. Possible values are Basic, Standard and Premium.
-MaxMemoryPolicy <String>
The 'MaxMemoryPolicy' setting has been deprecated. Please use 'RedisConfiguration' setting to set
MaxMemoryPolicy. e.g. -RedisConfiguration @{"maxmemory-policy" = "allkeys-lru"}
-RedisConfiguration <Hashtable>
All Redis Configuration Settings. Few possible keys: rdb-backup-enabled, rdb-storage-connection-string,
rdb-backup-frequency, maxmemory-reserved, maxmemory-policy, notify-keyspace-events, hash-max-ziplist-entries,
hash-max-ziplist-value, set-max-intset-entries, zset-max-ziplist-entries, zset-max-ziplist-value, databases.
-EnableNonSslPort <Boolean>
EnableNonSslPort is used by Azure Cache for Redis. If no value is provided, the default value is false and the
non-SSL port will be disabled. Possible values are true and false.
-ShardCount <Integer>
The number of shards to create on a Premium Cluster Cache.
-VirtualNetwork <String>
The exact ARM resource ID of the virtual network to deploy the Azure Cache for Redis in. Example format: /subscriptions/{
subid}/resourceGroups/{resourceGroupName}/providers/Microsoft.ClassicNetwork/VirtualNetworks/{vnetName}
-Subnet <String>
Required when deploying an Azure Cache for Redis inside an existing Azure Virtual Network.
-StaticIP <String>
Required when deploying an Azure Cache for Redis inside an existing Azure Virtual Network.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
기본 매개 변수로 캐시를 만들려면 다음 명령을 실행합니다.
New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US"
ResourceGroupName, Name 및 Location은 필수 매개 변수이지만 나머지는 선택 사항이며 기본값을 포함합니다. 이전 명령을 실행하면 지정된 이름, 위치 및 리소스 그룹으로 표준 SKU Azure Cache for Redis 인스턴스가 만들어집니다. 인스턴스 크기는 1GB이며 비 SSL 포트는 사용하지 않도록 설정되어 있습니다.
프리미엄 캐시를 만들려면 P1(6GB - 60GB), P2(13GB - 130GB), P3(26GB - 260GB) 또는 P4(53GB - 530GB) 크기를 지정합니다. 클러스터링을 사용하려면 ShardCount 매개 변수를 사용하여 분할된 데이터베이스 수를 지정합니다. 다음 예제에서는 3개의 분할된 데이터베이스가 있는 P1 프리미엄 캐시를 만듭니다. P1 프리미엄 캐시는 6GB 크기이고 3개의 분할된 데이터베이스를 지정했으므로 총 크기는 18GB(3 x 6GB)입니다.
New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku Premium -Size P1 -ShardCount 3
RedisConfiguration 매개 변수에 대한 값을 지정하려면 @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}처럼 키/값 쌍으로 값을 {}로 묶습니다. 다음 예제에서는 allkeys-random 최대 메모리 정책 및 KEA로 구성된 키스페이스 알림을 사용하여 표준 1GB 캐시를 만듭니다. 자세한 내용은 Keyspace 알림(고급 설정) 및 메모리 정책을 참조하세요.
New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}
캐시를 만드는 동안 데이터베이스 설정을 구성하려면
databases 설정은 캐시를 만드는 동안에만 구성할 수 있습니다. 다음 예제에서는 New-AzRedisCache cmdlet를 사용하여 48 데이터베이스로 프리미엄 P3(26GB) 캐시를 만듭니다.
New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku Premium -Size P3 -RedisConfiguration @{"databases" = "48"}
databases 속성에 대한 자세한 내용은 기본 Azure Cache for Redis 서버 구성을 참조하세요. New-AzRedisCache cmdlet를 사용하여 캐시를 만드는 방법에 대한 자세한 내용은 이전의 Azure Cache for Redis를 만들려면 섹션을 참조하세요.
Azure Cache for Redis를 업데이트하려면
Set-AzRedisCache cmdlet을 사용하여 Azure Cache for Redis 인스턴스를 업데이트합니다.
Set-AzRedisCache에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.
PS C:\> Get-Help Set-AzRedisCache -detailed
NAME
Set-AzRedisCache
SYNOPSIS
Set Azure Cache for Redis updatable parameters.
SYNTAX
Set-AzRedisCache -Name <String> -ResourceGroupName <String> [-Size <String>] [-Sku <String>]
[-MaxMemoryPolicy <String>] [-RedisConfiguration <Hashtable>] [-EnableNonSslPort <Boolean>] [-ShardCount
<Integer>] [<CommonParameters>]
DESCRIPTION
The Set-AzRedisCache cmdlet sets Azure Cache for Redis parameters.
PARAMETERS
-Name <String>
Name of the Azure Cache for Redis to update.
-ResourceGroupName <String>
Name of the resource group for the cache.
-Size <String>
Size of the Azure Cache for Redis. The default value is 1GB or C1. Possible values are P1, P2, P3, P4, C0, C1, C2, C3,
C4, C5, C6, 250MB, 1GB, 2.5GB, 6GB, 13GB, 26GB, 53GB.
-Sku <String>
Sku of Azure Cache for Redis. The default value is Standard. Possible values are Basic, Standard and Premium.
-MaxMemoryPolicy <String>
The 'MaxMemoryPolicy' setting has been deprecated. Please use 'RedisConfiguration' setting to set
MaxMemoryPolicy. e.g. -RedisConfiguration @{"maxmemory-policy" = "allkeys-lru"}
-RedisConfiguration <Hashtable>
All Redis Configuration Settings. Few possible keys: rdb-backup-enabled, rdb-storage-connection-string,
rdb-backup-frequency, maxmemory-reserved, maxmemory-policy, notify-keyspace-events, hash-max-ziplist-entries,
hash-max-ziplist-value, set-max-intset-entries, zset-max-ziplist-entries, zset-max-ziplist-value.
-EnableNonSslPort <Boolean>
EnableNonSslPort is used by Azure Cache for Redis. The default value is null and no change will be made to the
currently configured value. Possible values are true and false.
-ShardCount <Integer>
The number of shards to create on a Premium Cluster Cache.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
Size, Sku, EnableNonSslPort의 속성과 RedisConfiguration 값을 업데이트하는 데 Set-AzRedisCache cmdlet을 사용할 수 있습니다.
다음 명령은 myCache라는 Azure Cache for Redis에 대한 maxmemory-policy를 업데이트합니다.
Set-AzRedisCache -ResourceGroupName "myGroup" -Name "myCache" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random"}
Azure Cache for Redis 크기를 조정하려면
Size, Sku 또는 ShardCount 속성이 수정될 때 Azure Cache for Redis 인스턴스 크기를 조정하는 데 Set-AzRedisCache를 사용할 수 있습니다.
참고 항목
PowerShell을 사용하여 캐시 크기를 조정할 경우 Azure 포털에서 캐시 크기를 조정할 때와 동일한 한도 및 지침이 적용됩니다. 다른 가격 책정 계층으로 크기를 조정할 수 있지만 다음과 같은 제한 사항이 있습니다.
- 높은 가격 책정 계층에서 낮은 가격 책정 계층으로 크기를 조정할 수 없습니다.
- 프리미엄 캐시에서 표준 또는 기본 캐시로 축소할 수 없습니다.
- 표준 캐시에서 기본 캐시로 축소할 수 없습니다.
- 기본 캐시에서 표준 캐시로 크기를 조정할 수 있지만 동시에 크기를 변경할 수는 없습니다. 다른 크기가 필요한 경우 후속 크기 조정 작업을 통해 원하는 크기로 조정할 수 있습니다.
- 기본 캐시에서 바로 프리미엄 캐시로 확장할 수 없습니다. 크기 조정 작업을 통해 기본에서 표준으로 확장한 다음, 후속 크기 조정 작업을 통해 표준에서 프리미엄으로 확장해야 합니다.
- 더 큰 크기에서 C0(250MB) 크기로 축소할 수 없습니다.
자세한 내용은 Azure Cache for Redis 크기를 조정하는 방법을 참조하세요.
다음 예제에서는 myCache라는 캐시를 2.5GB 캐시로 크기를 조정하는 방법을 보여 줍니다. 이 명령은 기본 또는 표준 캐시 둘 다에 적용할 수 있습니다.
Set-AzRedisCache -ResourceGroupName myGroup -Name myCache -Size 2.5GB
이 명령을 실행하면 캐시 상태가 반환됩니다( Get-AzRedisCache호출과 유사). ProvisioningState이 Scaling로 설정됩니다.
PS C:\> Set-AzRedisCache -Name myCache -ResourceGroupName myGroup -Size 2.5GB
Name : mycache
Id : /subscriptions/12ad12bd-abdc-2231-a2ed-a2b8b246bbad4/resourceGroups/mygroup/providers/Mi
crosoft.Cache/Redis/mycache
Location : South Central US
Type : Microsoft.Cache/Redis
HostName : mycache.redis.cache.windows.net
Port : 6379
ProvisioningState : Scaling
SslPort : 6380
RedisConfiguration : {[maxmemory-policy, volatile-lru], [maxmemory-reserved, 150], [notify-keyspace-events, KEA],
[maxmemory-delta, 150]...}
EnableNonSslPort : False
RedisVersion : 3.0
Size : 1GB
Sku : Standard
ResourceGroupName : mygroup
PrimaryKey : ....
SecondaryKey : ....
VirtualNetwork :
Subnet :
StaticIP :
TenantSettings : {}
ShardCount :
크기 조정 작업이 완료되면 ProvisioningState는 Succeeded로 바뀝니다. 예를 들어 기본에서 표준으로 변경한 후 크기를 변경하는 것과 같이 다른 크기 조정 작업을 수행해야 하는 경우, 이전 작업이 완료될 때까지 기다려야 합니다. 기다리지 않으면 다음과 유사한 오류가 표시됩니다.
Set-AzRedisCache : Conflict: The resource '...' is not in a stable state, and is currently unable to accept the update request.
Azure Cache for Redis에 대한 정보를 가져오려면
Get-AzRedisCache cmdlet을 사용하여 캐시에 대한 정보를 검색할 수 있습니다.
Get-AzRedisCache에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.
PS C:\> Get-Help Get-AzRedisCache -detailed
NAME
Get-AzRedisCache
SYNOPSIS
Gets details about a single cache or all caches in the specified resource group or all caches in the current
subscription.
SYNTAX
Get-AzRedisCache [-Name <String>] [-ResourceGroupName <String>] [<CommonParameters>]
DESCRIPTION
The Get-AzRedisCache cmdlet gets the details about a cache or caches depending on input parameters. If both
ResourceGroupName and Name parameters are provided then Get-AzRedisCache will return details about the
specific cache name provided.
If only ResourceGroupName is provided than it will return details about all caches in the specified resource group.
If no parameters are given than it will return details about all caches the current subscription.
PARAMETERS
-Name <String>
The name of the cache. When this parameter is provided along with ResourceGroupName, Get-AzRedisCache
returns the details for the cache.
-ResourceGroupName <String>
The name of the resource group that contains the cache or caches. If ResourceGroupName is provided with Name
then Get-AzRedisCache returns the details of the cache specified by Name. If only the ResourceGroup
parameter is provided, then details for all caches in the resource group are returned.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
현재 구독의 모든 캐시에 대한 정보를 반환하려면 매개 변수 없이 Get-AzRedisCache를 실행합니다.
Get-AzRedisCache
특정 리소스 그룹의 모든 캐시에 대한 정보를 반환하려면 ResourceGroupName 매개 변수와 함께 Get-AzRedisCache를 실행합니다.
Get-AzRedisCache -ResourceGroupName myGroup
특정 캐시에 대한 정보를 반환하려면 캐시 이름을 포함하는 Name 매개 변수와 해당 캐시를 포함하는 리소스 그룹이 있는 ResourceGroupName 매개 변수와 함께 Get-AzRedisCache를 실행합니다.
PS C:\> Get-AzRedisCache -Name myCache -ResourceGroupName myGroup
Name : mycache
Id : /subscriptions/12ad12bd-abdc-2231-a2ed-a2b8b246bbad4/resourceGroups/myGroup/providers/Mi
crosoft.Cache/Redis/mycache
Location : South Central US
Type : Microsoft.Cache/Redis
HostName : mycache.redis.cache.windows.net
Port : 6379
ProvisioningState : Succeeded
SslPort : 6380
RedisConfiguration : {[maxmemory-policy, volatile-lru], [maxmemory-reserved, 62], [notify-keyspace-events, KEA],
[maxclients, 1000]...}
EnableNonSslPort : False
RedisVersion : 3.0
Size : 1GB
Sku : Standard
ResourceGroupName : myGroup
VirtualNetwork :
Subnet :
StaticIP :
TenantSettings : {}
ShardCount :
Azure Cache for Redis에 대한 액세스 키를 검색하려면
캐시에 대한 액세스 키를 검색하려면 Get-AzRedisCacheKey cmdlet을 사용할 수 있습니다.
Get-AzRedisCacheKey에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.
PS C:\> Get-Help Get-AzRedisCacheKey -detailed
NAME
Get-AzRedisCacheKey
SYNOPSIS
Gets the accesskeys for the specified Azure Cache for Redis.
SYNTAX
Get-AzRedisCacheKey -Name <String> -ResourceGroupName <String> [<CommonParameters>]
DESCRIPTION
The Get-AzRedisCacheKey cmdlet gets the access keys for the specified cache.
PARAMETERS
-Name <String>
Name of the Azure Cache for Redis.
-ResourceGroupName <String>
Name of the resource group for the cache.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
캐시에 대한 키를 검색하려면 Get-AzRedisCacheKey cmdlet을 호출하고 캐시 이름과 해당 캐시를 포함하는 리소스 그룹 이름을 전달합니다.
PS C:\> Get-AzRedisCacheKey -Name myCache -ResourceGroupName myGroup
PrimaryKey : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
SecondaryKey : ABhfB757JgjIgt785JgKH9865eifmekfnn649303JKL=
Azure Cache for Redis에 대한 액세스 키를 다시 생성하려면
캐시에 대한 액세스 키를 다시 생성하려면 Get-AzRedisCacheKey cmdlet을 사용할 수 있습니다.
New-AzRedisCacheKey에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.
PS C:\> Get-Help New-AzRedisCacheKey -detailed
NAME
New-AzRedisCacheKey
SYNOPSIS
Regenerates the access key of an Azure Cache for Redis.
SYNTAX
New-AzRedisCacheKey -Name <String> -ResourceGroupName <String> -KeyType <String> [-Force] [<CommonParameters>]
DESCRIPTION
The New-AzRedisCacheKey cmdlet regenerate the access key of an Azure Cache for Redis.
PARAMETERS
-Name <String>
Name of the Azure Cache for Redis.
-ResourceGroupName <String>
Name of the resource group for the cache.
-KeyType <String>
Specifies whether to regenerate the primary or secondary access key. Possible values are Primary or Secondary.
-Force
When the Force parameter is provided, the specified access key is regenerated without any confirmation prompts.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
캐시에 대한 주 및 보조 키를 다시 생성하려면 New-AzRedisCacheKey cmdlet을 호출하고 이름, 리소스 그룹을 전달하고 KeyType 매개 변수에 대해 Primary 또는 Secondary를 지정합니다. 다음 예제에서는 캐시에 대한 보조 액세스 키가 다시 생성됩니다.
PS C:\> New-AzRedisCacheKey -Name myCache -ResourceGroupName myGroup -KeyType Secondary
Confirm
Are you sure you want to regenerate Secondary key for Azure Cache for Redis 'myCache'?
[Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): Y
PrimaryKey : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
SecondaryKey : c53hj3kh4jhHjPJk8l0jji785JgKH9865eifmekfnn6=
Azure Cache for Redis를 삭제하려면
Azure Cache for Redis를 삭제하려면 Remove-AzRedisCache cmdlet을 사용합니다.
Remove-AzRedisCache에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.
PS C:\> Get-Help Remove-AzRedisCache -detailed
NAME
Remove-AzRedisCache
SYNOPSIS
Remove Azure Cache for Redis if exists.
SYNTAX
Remove-AzRedisCache -Name <String> -ResourceGroupName <String> [-Force] [-PassThru] [<CommonParameters>
DESCRIPTION
The Remove-AzRedisCache cmdlet removes an Azure Cache for Redis if it exists.
PARAMETERS
-Name <String>
Name of the Azure Cache for Redis to remove.
-ResourceGroupName <String>
Name of the resource group of the cache to remove.
-Force
When the Force parameter is provided, the cache is removed without any confirmation prompts.
-PassThru
By default Remove-AzRedisCache removes the cache and does not return any value. If the PassThru par
is provided then Remove-AzRedisCache returns a boolean value indicating the success of the operatio
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
다음 예제에서는 캐시 이름 myCache 가 제거됩니다.
PS C:\> Remove-AzRedisCache -Name myCache -ResourceGroupName myGroup
Confirm
Are you sure you want to remove Azure Cache for Redis 'myCache'?
[Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): Y
Azure Cache for Redis를 가져오려면
Import-AzRedisCache cmdlet을 사용하여 Azure Cache for Redis 인스턴스에 데이터를 가져올 수 있습니다.
Important
가져오기/내보내기는 프리미엄 계층 캐시에만 사용할 수 있습니다. Import/Export에 대한 자세한 내용은 Azure Cache for Redis에서 데이터 가져오기 및 내보내기를 참조하세요.
Import-AzRedisCache에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.
PS C:\> Get-Help Import-AzRedisCache -detailed
NAME
Import-AzRedisCache
SYNOPSIS
Import data from blobs to Azure Cache for Redis.
SYNTAX
Import-AzRedisCache -Name <String> -ResourceGroupName <String> -Files <String[]> [-Format <String>] [-Force]
[-PassThru] [<CommonParameters>]
DESCRIPTION
The Import-AzRedisCache cmdlet imports data from the specified blobs into Azure Cache for Redis.
PARAMETERS
-Name <String>
The name of the cache.
-ResourceGroupName <String>
The name of the resource group that contains the cache.
-Files <String[]>
SAS urls of blobs whose content should be imported into the cache.
-Format <String>
Format for the blob. Currently "rdb" is the only supported, with other formats expected in the future.
-Force
When the Force parameter is provided, import will be performed without any confirmation prompts.
-PassThru
By default Import-AzRedisCache imports data in cache and does not return any value. If the PassThru
parameter is provided then Import-AzRedisCache returns a boolean value indicating the success of the
operation.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
다음 명령은 SAS URI가 지정한 Blob에서 Azure Cache for Redis에 데이터를 가져옵니다.
PS C:\>Import-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -Files @("https://mystorageaccount.blob.core.windows.net/mycontainername/blobname?sv=2015-04-05&sr=b&sig=caIwutG2uDa0NZ8mjdNJdgOY8%2F8mhwRuGNdICU%2B0pI4%3D&st=2016-05-27T00%3A00%3A00Z&se=2016-05-28T00%3A00%3A00Z&sp=rwd") -Force
Azure Cache for Redis를 내보내려면
Export-AzRedisCache cmdlet을 사용하여 Azure Cache for Redis 인스턴스에서 데이터를 내보낼 수 있습니다.
Important
가져오기/내보내기는 프리미엄 계층 캐시에만 사용할 수 있습니다. Import/Export에 대한 자세한 내용은 Azure Cache for Redis에서 데이터 가져오기 및 내보내기를 참조하세요.
Export-AzRedisCache에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.
PS C:\> Get-Help Export-AzRedisCache -detailed
NAME
Export-AzRedisCache
SYNOPSIS
Exports data from Azure Cache for Redis to a specified container.
SYNTAX
Export-AzRedisCache -Name <String> -ResourceGroupName <String> -Prefix <String> -Container <String> [-Format
<String>] [-PassThru] [<CommonParameters>]
DESCRIPTION
The Export-AzRedisCache cmdlet exports data from Azure Cache for Redis to a specified container.
PARAMETERS
-Name <String>
The name of the cache.
-ResourceGroupName <String>
The name of the resource group that contains the cache.
-Prefix <String>
Prefix to use for blob names.
-Container <String>
SAS url of container where data should be exported.
-Format <String>
Format for the blob. Currently "rdb" is the only supported, with other formats expected in the future.
-PassThru
By default Export-AzRedisCache does not return any value. If the PassThru parameter is provided
then Export-AzRedisCache returns a boolean value indicating the success of the operation.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
다음 명령은 Azure Cache for Redis 인스턴스에서 SAS uri가 지정한 컨테이너로 데이터를 내보냅니다.
PS C:\>Export-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -Prefix "blobprefix"
-Container "https://mystorageaccount.blob.core.windows.net/mycontainer?sv=2015-04-05&sr=c&sig=HezZtBZ3DURmEGDduauE7
pvETY4kqlPI8JCNa8ATmaw%3D&st=2016-05-27T00%3A00%3A00Z&se=2016-05-28T00%3A00%3A00Z&sp=rwdl"
Azure Cache for Redis를 다시 부팅하려면
Reset-AzRedisCache cmdlet을 사용하여 Azure Cache for Redis 인스턴스를 재부팅할 수 있습니다.
Important
재부팅은 기본, 표준 및 프리미엄 계층 캐시에만 사용할 수 있습니다. 캐시를 재부팅하는 방법에 대한 자세한 내용은 캐시 관리 - 재부팅을 참조하세요.
Reset-AzRedisCache에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.
PS C:\> Get-Help Reset-AzRedisCache -detailed
NAME
Reset-AzRedisCache
SYNOPSIS
Reboot specified node(s) of an Azure Cache for Redis instance.
SYNTAX
Reset-AzRedisCache -Name <String> -ResourceGroupName <String> -RebootType <String> [-ShardId <Integer>]
[-Force] [-PassThru] [<CommonParameters>]
DESCRIPTION
The Reset-AzRedisCache cmdlet reboots the specified node(s) of an Azure Cache for Redis instance.
PARAMETERS
-Name <String>
The name of the cache.
-ResourceGroupName <String>
The name of the resource group that contains the cache.
-RebootType <String>
Which node to reboot. Possible values are "PrimaryNode", "SecondaryNode", "AllNodes".
-ShardId <Integer>
Which shard to reboot when rebooting a premium cache with clustering enabled.
-Force
When the Force parameter is provided, reset will be performed without any confirmation prompts.
-PassThru
By default Reset-AzRedisCache does not return any value. If the PassThru parameter is provided
then Reset-AzRedisCache returns a boolean value indicating the success of the operation.
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
다음 명령은 지정된 캐시의 두 노드를 모두 재부팅합니다.
PS C:\>Reset-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -RebootType "AllNodes"
-Force
다음 단계
Azure에서 Windows PowerShell 사용에 대한 자세한 내용은 다음 리소스를 참조하십시오.
- MSDN에 있는 Azure Cache for Redis cmdlet 설명서
- Azure Resource Manager Cmdlet: Azure Resource Manager 모듈에서 cmdlet을 사용하는 방법을 알아봅니다.
- 리소스 그룹을 사용하여 Azure 리소스 관리: Azure 포털에서 리소스 그룹을 만들고 관리하는 방법에 대해 알아봅니다.
- Azure 블로그: Azure의 새로운 기능에 대해 알아봅니다.
- Windows PowerShell 블로그: Windows PowerShell의 새로운 기능에 대해 알아봅니다.
- "Hey, Scripting Guy!" 블로그: Windows PowerShell 커뮤니티에서 실제 팁과 요령을 확인합니다.