Set-AzRedisCache

참조

모듈:: Az.RedisCache

Azure Cache for Redis를 수정합니다.

구문

Set-AzRedisCache
   [-ResourceGroupName <String>]
   -Name <String>
   [-Size <String>]
   [-Sku <String>]
   [-RedisConfiguration <Hashtable>]
   [-EnableNonSslPort <Boolean>]
   [-TenantSettings <Hashtable>]
   [-ShardCount <Int32>]
   [-MinimumTlsVersion <String>]
   [-DisableAccessKeyAuthentication <Boolean>]
   [-RedisVersion <String>]
   [-UpdateChannel <String>]
   [-Tag <Hashtable>]
   [-IdentityType <String>]
   [-UserAssignedIdentity <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-AzRedisCache cmdlet은 Azure Cache for Redis를 수정합니다.

예제

예제 1: Azure Cache for Redis 수정

Set-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random"}

PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : mygroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/myCache
          Location           : North Central US
          Name               : MyCache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : creating
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random]}
          EnableNonSslPort   : False
          RedisVersion       : 2.8
          Size               : 250MB
          Sku                : Standard
          Tag                : {}
          Zone               : []

이 명령은 MyCache라는 Azure Cache fo Redis에 대한 maxmemory-policy를 업데이트합니다.

예제 2: Azure Cache for Redis 수정 - RDB 또는 AOF 데이터 지속성을 사용하지 않도록 설정하려는 경우

Set-AzRedisCache -Name "MyCache"  -RedisConfiguration @{"rdb-backup-enabled" = "false"}

PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : Succeeded
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300], [rdb-backup-enabled, false]...} 
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          Tag                : {}
          Zone               : []

이 cmdlet은 Azure Cache for Redis에 대한 RDB 백업 데이터 지속성을 사용하지 않도록 설정합니다. AOF 백업 영구 캐시를 사용하지 않도록 설정할 수도 있습니다.

예제 3: Azure Cache for Redis 수정 - Azure Redis 캐시를 만든 후 데이터 지속성을 추가하려는 경우

Set-AzRedisCache -Name "MyCache" -RedisConfiguration @{"rdb-backup-enabled" = "true"; "rdb-storage-connection-string" = "DefaultEndpointsProtocol=https;AccountName=mystorageaccount;AccountKey=******;EndpointSuffix=mySuffix"; "rdb-backup-frequency" = "30"}

PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : Succeeded
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300], [rdb-backup-enabled, true]....} 
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          Tag                : {}
          Zone               : []

이 cmdlet을 사용하면 기존 캐시에서 rdb-backup 지속성을 사용할 수 있습니다. aof-backup 지속성을 사용하도록 설정할 수도 있습니다.

예제 4: Azure Cache for Redis 수정 - rdb 백업 빈도를 변경하려는 경우

예를 들어 - 현재 30분마다 RDB 스냅샷을 생성하지만 15분마다 스냅샷을 생성하도록 변경하려고 합니다.

Set-AzRedisCache -Name "MyCache" -RedisConfiguration @{"rdb-backup-frequency" = "15"}

PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : Succeeded
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300], [rdb-backup-enabled, true]....} 
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          Tag                : {}
          Zone               : []

예제 5: Azure Cache for Redis 수정 - AOF 백업 데이터 지속성을 RDB 백업으로 변경하려는 경우

Set-AzRedisCache -Name "MyCache"  -RedisConfiguration @{"aof-backup-enabled"= "false"; "rdb-backup-enabled" = "true"; "rdb-storage-connection-string" = "DefaultEndpointsProtocol=https;AccountName=mystorageaccount;AccountKey=******;EndpointSuffix=mySuffix"; "rdb-backup-frequency" = "30"}

PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : Succeeded
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300], [rdb-backup-enabled, true]....} 
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          Tag                : {}
          Zone               : []

이 cmdlet은 지속성 메서드를 변경하는 데 도움이 됩니다.

예제 6: Azure Cache for Redis 인스턴스 크기 조정 - 다른 크기로 업데이트합니다.

Set-AzRedisCache -Name "MyCache" -Size "P2" -Sku "Premium"

PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : Scaling
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300]....} 
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          Tag                : {}
          Zone               : []

이 명령은 인스턴스의 메모리 크기를 늘리거나 줄입니다.

예제 7: Azure Cache for Redis 인스턴스 크기 조정 - 다른 계층으로 업데이트

Set-AzRedisCache -Name "MyCache" -Size "P1" -Sku "Premium"

PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : Scaling
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300]....} 
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 1GB
          Sku                : Standard
          Tag                : {}
          Zone               : []

이 명령은 캐시 계층을 변경하는 데 도움이 됩니다. 기본에서 표준으로, 표준에서 프리미엄으로 변경할 수 있습니다.

예제 8: Azure Cache for Redis 인스턴스 크기 조정 - Redis 클러스터링을 사용하도록 설정합니다.

Set-AzRedisCache -Name "MyCache" -ShardCount 1

PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : Scaling
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300]....} 
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          ShardCount         :
          Tag                : {}
          Zone               : []

이 cmdlet은 Azure Cache for Redis 인스턴스에 클러스터링을 사용하도록 설정하는 데 도움이 됩니다. 분할된 데이터베이스 수를 늘리려면 먼저 클러스터링을 사용하도록 설정해야 합니다.

예제 9: Azure Cache for Redis 인스턴스 크기 조정 - Redis 클러스터를 사용하여 규모 감축/축소

Set-AzRedisCache -Name "MyCache" -ShardCount 2

PrimaryKey         : ******
          SecondaryKey       : ******
          ResourceGroupName  : MyGroup
          Id                 : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Cache/Redis/MyCache
          Location           : Central US
          Name               : mycache
          Type               : Microsoft.Cache/Redis
          HostName           : mycache.redis.cache.windows.net
          Port               : 6379
          ProvisioningState  : Scaling
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300]....} 
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          ShardCount         : 1
          Tag                : {}
          Zone               : []

이 명령은 클러스터 크기를 늘리거나 줄입니다.

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

형식:	SwitchParameter
별칭:	cf
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:	IAzureContextContainer
별칭:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DisableAccessKeyAuthentication

선택 사항: true로 설정하면 액세스 키를 통해 Redis에 대한 인증을 사용할 수 없습니다. 기본값은 거짓입니다.

형식:	String
Position:	Named
Default value:	false
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-EnableNonSslPort

비 SSL 포트를 사용하는지 여부를 나타냅니다. 기본값은 $False(비 SSL 포트는 사용하지 않도록 설정됨)입니다.

형식:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-IdentityType

Azure Cache for Redis에 사용되는 ID 유형을 지정합니다. 유효한 값: "SystemAssigned" 또는 "UserAssigned" 또는 "SystemAssignedUserAssigned" 또는 "None"

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-MinimumTlsVersion

클라이언트가 캐시에 연결하는 데 필요한 TLS 버전을 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-Name

업데이트할 Azure Cache for Redis의 이름을 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-RedisConfiguration

Redis 구성 설정을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

rdb-backup-enabled. Redis 데이터 지속성을 사용하도록 지정합니다. 프리미엄 계층에만 해당합니다.
rdb-storage-connection-string. Redis 데이터 지속성에 대한 Storage 계정에 대한 연결 문자열 지정합니다. 프리미엄 계층에만 해당합니다.
rdb-backup-frequency. Redis 데이터 지속성에 대한 백업 빈도를 지정합니다. 프리미엄 계층에만 해당합니다.
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. 작은 집계 데이터 형식에 대한 메모리 최적화를 구성합니다. 표준 및 프리미엄 계층.
생성됩니다. 데이터베이스 수를 구성합니다. 이 속성은 캐시 만들기에서만 구성할 수 있습니다. 표준 및 프리미엄 계층. 자세한 내용은 Azure PowerShellhttp://go.microsoft.com/fwlink/?LinkId=800051 을 사용하여 Azure Redis Cache 관리(http://go.microsoft.com/fwlink/?LinkId=800051)를 참조하세요.
preferred-data-archive-auth-method Preferred auth 메서드는 데이터 보관에 사용되는 스토리지 계정과 통신하고, SAS 또는 ManagedIdentity를 지정하며, 기본값은 SAS입니다.
preferred-data-persistence-auth-method Preferred auth 메서드는 데이터 지속성에 사용되는 스토리지 계정과 통신하고, SAS 또는 ManagedIdentity를 지정하고, 기본값은 SAS입니다.

형식:	Hashtable
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-RedisVersion

Redis 버전입니다. 이는 'major[.minor]' 형식('major'만 필요) 또는 사용 가능한 안정적인 최신 Redis 버전을 참조하는 'latest' 값이어야 합니다. 지원되는 버전: 4.0, 6.0(최신). 기본값은 'latest'입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-ResourceGroupName

Redis Cache를 포함하는 리소스 그룹의 이름을 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-ShardCount

프리미엄 클러스터 캐시에 만들 분할된 데이터베이스 수를 지정합니다.

형식:	Nullable<T>[Int32]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-Size

Redis Cache의 크기를 지정합니다. 유효한 값은 다음과 같습니다.

P1
P2
P3
P4
P5
C0
C1
C2
C3
C4
C5
C6
250MB
1GB
2.5GB
6GB
13GB
26GB
53GB
120GB 기본값은 1GB 또는 C1입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-Sku

만들 Redis Cache의 SKU를 지정합니다. 유효한 값은 다음과 같습니다.

Basic
Standard
프리미엄 기본값은 Standard입니다.

형식:	String
허용되는 값:	Basic, Standard, Premium
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-Tag

태그를 나타내는 해시 테이블입니다.

형식:	Hashtable
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-TenantSettings

이 매개 변수는 더 이상 사용되지 않습니다.

형식:	Hashtable
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-UpdateChannel

선택 사항: Redis Cache에서 받을 월별 Redis 업데이트에 대한 업데이트 채널을 지정합니다. '미리 보기' 업데이트 채널을 사용하는 캐시는 '안정' 채널 캐시보다 최소 4주 전에 최신 Redis 업데이트를 받습니다. 기본값은 'Stable'입니다. 가능한 값은 'Stable', 'Preview'입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-UserAssignedIdentity

Azure Cache for Redis와 연결할 하나 이상의 쉼표로 구분된 사용자 ID를 지정합니다. 사용자 ID 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}' 형식의 ARM 리소스 ID입니다.

형식:	String[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

형식:	SwitchParameter
별칭:	wi
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

입력

String

Hashtable

Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

출력

RedisCacheAttributesWithAccessKeys

다음을 통해 공유

Set-AzRedisCache

구문

Description

예제

예제 1: Azure Cache for Redis 수정

예제 2: Azure Cache for Redis 수정 - RDB 또는 AOF 데이터 지속성을 사용하지 않도록 설정하려는 경우

예제 3: Azure Cache for Redis 수정 - Azure Redis 캐시를 만든 후 데이터 지속성을 추가하려는 경우

예제 4: Azure Cache for Redis 수정 - rdb 백업 빈도를 변경하려는 경우

예제 5: Azure Cache for Redis 수정 - AOF 백업 데이터 지속성을 RDB 백업으로 변경하려는 경우

예제 6: Azure Cache for Redis 인스턴스 크기 조정 - 다른 크기로 업데이트합니다.

예제 7: Azure Cache for Redis 인스턴스 크기 조정 - 다른 계층으로 업데이트

예제 8: Azure Cache for Redis 인스턴스 크기 조정 - Redis 클러스터링을 사용하도록 설정합니다.

예제 9: Azure Cache for Redis 인스턴스 크기 조정 - Redis 클러스터를 사용하여 규모 감축/축소

매개 변수

-Confirm

-DefaultProfile

-DisableAccessKeyAuthentication

-EnableNonSslPort

-IdentityType

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

입력

출력

추가 리소스

다음을 통해 공유

Set-AzRedisCache

구문

Description

예제

예제 1: Azure Cache for Redis 수정

예제 2: Azure Cache for Redis 수정 - RDB 또는 AOF 데이터 지속성을 사용하지 않도록 설정하려는 경우

예제 3: Azure Cache for Redis 수정 - Azure Redis 캐시를 만든 후 데이터 지속성을 추가하려는 경우

예제 4: Azure Cache for Redis 수정 - rdb 백업 빈도를 변경하려는 경우

예제 5: Azure Cache for Redis 수정 - AOF 백업 데이터 지속성을 RDB 백업으로 변경하려는 경우

예제 6: Azure Cache for Redis 인스턴스 크기 조정 - 다른 크기로 업데이트합니다.

예제 7: Azure Cache for Redis 인스턴스 크기 조정 - 다른 계층으로 업데이트

예제 8: Azure Cache for Redis 인스턴스 크기 조정 - Redis 클러스터링을 사용하도록 설정합니다.

예제 9: Azure Cache for Redis 인스턴스 크기 조정 - Redis 클러스터를 사용하여 규모 감축/축소

매개 변수

-Confirm

-DefaultProfile

-DisableAccessKeyAuthentication

-EnableNonSslPort

-IdentityType

-MinimumTlsVersion

-Name

-RedisConfiguration

-RedisVersion

-ResourceGroupName

-ShardCount

-Size

-Sku

-Tag

-TenantSettings

-UpdateChannel

-UserAssignedIdentity

-WhatIf

입력

출력

관련 링크

추가 리소스