Azure PowerShell을 사용하여 Azure Redis Redis 관리

Azure Managed Redis 캐시 만들기

New-AzRedisEnterpriseCache cmdlet을 사용하여 새 Azure Managed Redis 인스턴스를 만듭니다. ResourceGroupName, Name, Location및 Sku 필수 매개 변수입니다. 다른 매개 변수는 선택 사항이며 기본값이 있습니다.

Microsoft Entra 인증은 기본적으로 모든 새 캐시에 사용하도록 설정되며 보안을 위해 권장됩니다.

모든 Azure Managed Redis PowerShell 매개 변수 및 속성은 New-AzRedisEnterpriseCacheNew-AzRedisEnterpriseCache를 참조하세요. 사용 가능한 매개 변수 및 해당 설명 목록을 출력하려면 다음 명령을 실행합니다.

Get-Help New-AzRedisEnterpriseCache -detailed

다음 예제 명령은 기본 매개 변수를 사용하여 지정된 이름, 위치, 리소스 그룹 및 SKU를 사용하여 Azure Managed Redis 인스턴스를 만듭니다. 인스턴스 크기는 1GB이며 비 SSL 포트는 사용하지 않도록 설정되어 있습니다.

New-AzRedisEnterpriseCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku Balanced_B1

데이터베이스 만들기 및 구성

New-AzRedisEnterpriseCacheDatabase cmdlet을 사용하여 Azure Managed Redis 캐시에 대한 데이터베이스를 만들고 구성할 수 있습니다. New-AzRedisEnterpriseCacheDatabase에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.

Get-Help New-AzRedisEnterpriseCacheDatabase -detailed

캐시를 만드는 동안 데이터베이스를 구성하지 않으면 New-AzRedisEnterpriseCache 는 기본적으로 명명된 default 캐시에 하나의 데이터베이스를 만들고 모든 캐시 데이터는 이 DB 0 데이터베이스로 이동합니다.

Azure Managed Redis 캐시 업데이트

Update-AzRedisEnterpriseCache cmdlet을 사용하여 Azure Managed Redis 인스턴스를 업데이트할 수 있습니다. Update-AzRedisEnterpriseCache에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.

Get-Help Update-AzRedisEnterpriseCache -detailed

cmdlet을 사용하여 Update-AzRedisEnterpriseCache의 Sku, Tag, MinimumTlsVersion와 같은 속성을 업데이트할 수 있습니다. 다음 명령은 최소 TLS(전송 계층 보안) 버전을 업데이트하고 Azure Managed Redis 캐시에 태그 myCache를 추가합니다.

Update-AzRedisEnterpriseCache -Name "myCache" -ResourceGroupName "myGroup" -MinimumTlsVersion "1.2" -Tag @{"tag1" = "value1"}

Azure Managed Redis 캐시에 대한 정보 가져오기

Get-AzRedisEnterpriseCache cmdlet을 사용하여 캐시에 대한 정보를 검색할 수 있습니다. Get-AzRedisEnterpriseCache에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.

Get-Help Get-AzRedisEnterpriseCache -detailed

현재 구독의 모든 캐시에 대한 정보를 반환하려면 매개 변수 없이 Get-AzRedisEnterpriseCache를 실행합니다.

Get-AzRedisEnterpriseCache

특정 리소스 그룹의 모든 캐시에 대한 정보를 반환하려면 Get-AzRedisEnterpriseCache 매개 변수와 함께 ResourceGroupName를 실행합니다.

Get-AzRedisEnterpriseCache -ResourceGroupName myGroup

특정 캐시에 대한 정보를 반환하려면 Get-AzRedisEnterpriseCache을 Name 및 ResourceGroupName와 함께 실행하십시오.

Get-AzRedisEnterpriseCache -Name myCache -ResourceGroupName myGroup

Azure Managed Redis 캐시에 대한 액세스 키 검색

캐시에 대한 액세스 키를 검색하려면 Get-AzRedisEnterpriseCacheKey cmdlet을 사용합니다. Get-AzRedisEnterpriseCacheKey에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.

Get-Help Get-AzRedisEnterpriseCacheKey -detailed

캐시의 키를 검색하려면 Get-AzRedisEnterpriseCacheKey 및 Name을 사용하여 ResourceGroupName cmdlet을 호출합니다.

Get-AzRedisEnterpriseCacheKey -Name myCache -ResourceGroupName myGroup

Azure Managed Redis 캐시에 대한 액세스 키 다시 생성

캐시에 대한 액세스 키를 다시 생성하려면 New-AzRedisEnterpriseCacheKey cmdlet을 사용할 수 있습니다. New-AzRedisEnterpriseCacheKey에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.

Get-Help New-AzRedisEnterpriseCacheKey -detailed

기본 또는 보조 키를 다시 생성하려면 캐시 New-AzRedisEnterpriseCacheKey 및 Name로 cmdlet ResourceGroupName을 호출하고, 매개 변수 Primary에 대해 Secondary 또는 KeyType를 지정합니다. 다음 예제에서는 캐시에 대한 보조 액세스 키를 다시 생성합니다.

New-AzRedisEnterpriseCacheKey -Name myCache -ResourceGroupName myGroup -KeyType Secondary

Azure Managed Redis 캐시 삭제

Azure Managed Redis 캐시를 삭제하려면 Remove-AzRedisEnterpriseCache cmdlet을 사용합니다. Remove-AzRedisEnterpriseCache에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.

Get-Help Remove-AzRedisEnterpriseCache -detailed

다음 예제에서는 이름이 .인 myCache캐시를 제거합니다.

Remove-AzRedisEnterpriseCache -Name myCache -ResourceGroupName myGroup

Azure Managed Redis 캐시 데이터 가져오기

cmdlet을 사용하여 Import-AzRedisEnterpriseCache Azure Managed Redis 인스턴스로 데이터를 가져올 수 있습니다. Import-AzRedisEnterpriseCache에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.

Get-Help Import-AzRedisEnterpriseCache -detailed

임포트할 Blob을 위한 캐시 Name 및 ResourceGroupName와 SasUri가 필요합니다. 다음 명령은 SAS URI에 지정된 Blob에서 데이터를 가져옵니다.

Import-AzRedisEnterpriseCache -ClusterName "myCache" -ResourceGroupName "myGroup" -SasUri @("<sas-uri>")

Azure Managed Redis 캐시 데이터 내보내기

cmdlet을 사용하여 Export-AzRedisEnterpriseCache Azure Managed Redis 인스턴스에서 데이터를 내보낼 수 있습니다. Export-AzRedisEnterpriseCache에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.

Get-Help Export-AzRedisEnterpriseCache -detailed

내보낼 컨테이너의 캐시 Name 와 ResourceGroupNameSasUri 캐시가 필요합니다. 다음 예제 명령은 SAS URI에 지정된 컨테이너에서 데이터를 내보냅니다.

Export-AzRedisEnterpriseCache -Name "myCache" -ResourceGroupName "myGroup" -SasUri "https://mystorageaccount.blob.core.windows.net/mycontainer?sp=signedPermissions&se=signedExpiry&sv=signedVersion&sr=signedResource&sig=signature;mystoragekey"

Azure Cache for Redis PowerShell 속성 및 매개 변수

다음 표에서는 일반적인 Azure Cache for Redis 매개 변수에 대한 Azure PowerShell 속성 및 설명을 보여 줍니다. 모든 Azure PowerShell 매개 변수 및 속성은 Az.RedisCache를 참조하세요.

RedisConfiguration 매개 변수의 속성

Azure Redis 캐시 만들기

New-AzRedisCache cmdlet을 사용하여 새 Azure Cache for Redis 인스턴스를 만듭니다. ResourceGroupName, Name및 Location 필수 매개 변수입니다. 다른 매개 변수는 선택 사항이며 기본값이 있습니다.

New-AzRedisCache에 사용할 수 있는 매개 변수 목록과 해당 설명을 보려면 다음 명령을 실행합니다.

Get-Help New-AzRedisCache -detailed>

다음 예제 명령은 기본 매개 변수를 사용하여 지정된 이름, 위치 및 리소스 그룹을 사용하여 Azure Cache for Redis 인스턴스를 만듭니다. 인스턴스는 비 SSL 포트를 사용하지 않도록 설정된 표준 1GB 캐시입니다.

New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US"

매개 변수의 RedisConfiguration 값을 지정하려면 키-값 쌍을 중괄호로 묶습니다 {}. 다음 예제에서는 .을 사용하여 1GB 캐시를 @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}만듭니다. 자세한 내용은 Keyspace 알림(고급 설정) 및 메모리 정책을 참조하세요.

New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}

프리미엄 캐시 만들기

Azure Cache for Redis 프리미엄 계층 캐시를 만들려면 크기 P1 (6-60GB), (13-130GB), P2 (26-260GB) P3 또는 P4 (53-530GB)을 지정합니다. 클러스터링을 사용하려면 ShardCount 매개 변수를 사용하여 분할된 데이터베이스 수를 지정합니다.

다음 예제에서는 세 개의 분할된 데이터베이스가 있는 P1 프리미엄 캐시를 만듭니다. P1 프리미엄 캐시의 크기는 6GB이고 분할된 데이터베이스가 3개인 총 크기는 18GB(3 x 6GB)입니다.

New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku Premium -Size P1 -ShardCount 3

데이터베이스 설정 구성

databases cmdlet의 설정은 캐시의 데이터베이스 수를 구성합니다. PowerShell 또는 다른 관리 클라이언트를 사용하여 캐시를 만드는 동안에만 표준 및 프리미엄 계층에 대해서만 구성할 databases 수 있습니다.

캐시를 databases 만드는 동안 설정을 지정하지 않으면 New-AzRedisCache 는 하나의 데이터베이스를 default만들고 모든 캐시 데이터는 이 DB 0 데이터베이스로 이동합니다. 데이터베이스 제한은 캐시 계층 및 크기에 따라 달라지지만 기본 설정은 16입니다.

다음 예제에서는 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 서버 구성을 참조하세요.

Azure Cache for Redis를 업데이트하기

Set-AzRedisCache cmdlet을 사용하여 Azure Cache for Redis 인스턴스를 업데이트합니다. Set-AzRedisCache에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.

Get-Help Set-AzRedisCache -detailed

Set-AzRedisCache cmdlet을 사용하여 Size, Sku, EnableNonSslPort 및 RedisConfiguration 값과 같은 속성을 업데이트할 수 있습니다. 다음 예제 명령은 Azure Cache for Redis 인스턴스의 이름을 maxmemory-policy업데이트합니다myCache.

Set-AzRedisCache -ResourceGroupName "myGroup" -Name "myCache" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random"}

Azure Cache for Redis 캐시 크기 조정

Set-AzRedisCache, Size, 또는 Sku 속성을 수정할 때 ShardCount를 사용하여 Azure Cache for Redis 인스턴스의 크기를 조정할 수 있습니다.

다음 예제에서는 2.5GB 크기로 명명된 myCache 캐시의 크기를 조정하는 방법을 보여줍니다. 이 명령은 기본 또는 표준 캐시에 대해 작동합니다.

Set-AzRedisCache -ResourceGroupName myGroup -Name myCache -Size 2.5GB

이 명령을 실행하면 캐시 상태가 호출 Get-AzRedisCache과 유사하게 반환됩니다. ProvisioningState이 Scaling로 설정됩니다.

크기 조정 작업이 완료되면 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에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.

Get-Help Get-AzRedisCache -detailed

현재 구독의 모든 캐시에 대한 정보를 반환하려면 매개 변수 없이 Get-AzRedisCache를 실행합니다.

Get-AzRedisCache

특정 리소스 그룹의 모든 캐시에 대한 정보를 반환하려면 Get-AzRedisCache 매개 변수와 함께 ResourceGroupName를 실행합니다.

Get-AzRedisCache -ResourceGroupName myGroup

특정 캐시에 대한 정보를 반환하려면 Get-AzRedisCache을 실행할 때 캐시 Name 및 ResourceGroupName 을 사용하십시오.

Get-AzRedisCache -Name myCache -ResourceGroupName myGroup

Azure Cache for Redis의 캐시 액세스 키를 찾아보기

캐시에 대한 액세스 키를 검색하려면 Get-AzRedisCacheKey cmdlet을 사용할 수 있습니다. Get-AzRedisCacheKey에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.

Get-Help Get-AzRedisCacheKey -detailed

캐시의 키를 검색하려면 Get-AzRedisCacheKey 캐시와 Name를 사용하여 ResourceGroupName cmdlet을 호출하십시오.

Get-AzRedisCacheKey -Name myCache -ResourceGroupName myGroup

Azure Cache for Redis 캐시에 대한 액세스 키를 다시 생성

캐시에 대한 액세스 키를 다시 생성하려면 Get-AzRedisCacheKey cmdlet을 사용할 수 있습니다. New-AzRedisCacheKey에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.

Get-Help New-AzRedisCacheKey -detailed

기본 또는 보조 키를 다시 생성하려면 캐시 New-AzRedisCacheKey 및 Name로 cmdlet ResourceGroupName을 호출하고, 매개 변수 Primary에 대해 Secondary 또는 KeyType를 지정합니다. 다음 예제에서는 캐시에 대한 보조 액세스 키를 다시 생성합니다.

New-AzRedisCacheKey -Name myCache -ResourceGroupName myGroup -KeyType Secondary

Azure Cache for Redis 캐시를 삭제하기

Azure Cache for Redis 캐시를 삭제하려면 Remove-AzRedisCache cmdlet을 사용합니다. Remove-AzRedisCache에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.

Get-Help Remove-AzRedisCache -detailed

다음 예제에서는 이름이 .인 myCache캐시를 제거합니다.

Remove-AzRedisCache -Name myCache -ResourceGroupName myGroup

Azure Cache for Redis 캐시로 데이터 가져오기

Import-AzRedisCache cmdlet을 사용하여 Azure Cache for Redis 인스턴스에 데이터를 가져올 수 있습니다.

Import-AzRedisCache에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.

Get-Help Import-AzRedisCache -detailed

다음 명령은 매개 변수에 지정된 Files Blob에서 Azure Cache for Redis로 데이터를 가져옵니다.

Import-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -Files @("https://mystorageaccount.blob.core.windows.net/mycontainername/blobname?sv=signedVersion&sr=signedResource&sig=signature&st=signTime&se=signedExpiry&sp=signedPermissions") -Force

Azure Cache for Redis 캐시 데이터 내보내기

Export-AzRedisCache cmdlet을 사용하여 Azure Cache for Redis 인스턴스에서 데이터를 내보낼 수 있습니다.

Export-AzRedisCache에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.

Get-Help Export-AzRedisCache -detailed

다음 명령은 Azure Cache for Redis 인스턴스의 데이터를 매개 변수로 지정된 Container 컨테이너로 내보냅니다.

Export-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -Prefix "blobprefix" -Container "https://mystorageaccount.blob.core.windows.net/mycontainer?sv=signedResource&sig=signature&st=signTime&se=signedExpiry&sp=signedPermissions"

Azure Cache for Redis 캐시 다시 부팅

Reset-AzRedisCache cmdlet을 사용하여 Azure Cache for Redis 인스턴스를 재부팅할 수 있습니다.

Reset-AzRedisCache에 대해 사용 가능한 매개 변수 및 해당 설명에 대한 목록을 보려면 다음 명령을 실행합니다.

Get-Help Reset-AzRedisCache -detailed

다음 명령은 지정된 캐시의 두 노드를 모두 재부팅합니다.

Reset-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -RebootType "AllNodes" -Force