다음을 통해 공유


New-AzRedisCache

Redis Cache를 만듭니다.

구문

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

Description

New-AzRedisCache cmdlet은 Azure Redis Cache를 만듭니다.

예제

예제 1: Redis Cache 만들기

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "North Central US"

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 : {}
          EnableNonSslPort   : False
          RedisVersion       : 2.8
          Size               : 1GB
          Sku                : Standard
          Tag                : {}
          Zone               : []

이 명령은 Redis Cache를 만듭니다.

예제 2: 표준 SKU Redis Cache 만들기

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "North Central US" -Size 250MB -Sku "Standard" -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               : []

이 cmdlet은 Azure Cache for Redis를 사용하여 캐시를 만듭니다.

예제 3: 영역 중복 캐시 만들기

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -Zone @("1","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  : creating
          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               : {1, 2}

이 명령은 뮤티플 영역에 Azure cache for Redis 인스턴스를 만듭니다.

예제 4: 가상 네트워크 사용 캐시 만들기

Virtual Network를 만들기 위한 요구 사항 캐시를 사용하도록 설정합니다.

  1. Redis 캐시를 만들려는 동일한 리소스 그룹에 가상 네트워크를 만듭니다. New-AzVirtualNetwork powershell 명령에서 가상 네트워크를 만들 수 있습니다.
  2. VNET에 대한 SubnetID가 캐시를 사용하도록 설정해야 합니다. SubnetID의 구문은 다음과 같습니다.

SubnetID 형식: /subscriptions/{subid}/resourceGroups/{resourceGroupName}/providers/Microsoft.ClassicNetwork/VirtualNetworks/{vnetName}/subnets/{subnetName}

New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -SubnetId "/subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Network/virtualNetworks/MyNet/subnets/MySubnet"

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  : creating
          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
          SubnetId           : /subscriptions/a559b6fd-3a84-40bb-a450-b0db5ed37dfe/resourceGroups/mygroup/providers/Microsoft.Network/virtualNetworks/MyNet/subnets/MySubnet
          StaticIP           : 10.0.0.4
          Tag                : {}
          Zone               : []

예제 5: 프리미엄 Azure Cache for Redis에 대한 데이터 지속성 구성

지속성은 사용자가 소유하고 관리하는 Azure Storage 계정에 Redis 데이터를 씁니다. 따라서 데이터 지속성을 구성하기 전에 동일한 리소스 그룹에 스토리지 계정이 있어야 합니다. 캐시와 동일한 지역 및 구독의 스토리지 계정을 선택하면 Premium Storage의 처리량이 더 높기 때문에 Premium Storage 계정을 사용하는 것이 좋습니다.

스토리지 계정을 만든 후 이 절차를 사용하여 스토리지 계정 연결 문자열 가져옵니다.

  1. Powershell에서 Get-AzStorageAccountKey -ResourceGroupName $resourceGroupName -Name $storageAccountName 명령을 실행합니다.
  2. 위의 출력에서 키를 복사합니다.
  3. 스토리지 계정의 연결 문자열 얻으려면 스토리지 계정 키와 스토리지 계정 이름을 아래 형식으로 입력합니다.

연결 문자열 형식 :- "DefaultEndpointsProtocol=https; AccountName={storageAccountName}; AccountKey={storageAccountKey}; EndpointSuffix=mySuffix"

데이터 지속성을 사용하려면 특정 Redis 구성 설정이 있어야 합니다.

RDB 백업 사용

  • rdb-backup-enabled(true 또는 false 설정)
  • rdb-storage-connection-string(위의 형식으로 연결 문자열 제공)
  • rdb-backup-frequency(백업 간격을 분 단위로 설정합니다. 15분, 30분, 60분, 360분, 720분, 1440분 중에서만 선택할 수 있습니다.)
New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -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  : creating
          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               : []

예제 6: 프리미엄 Azure Cache for Redis에 대한 데이터 지속성 구성 - AOF 백업 사용

AOF 백업을 사용하도록 설정했습니다.

  • aof-backup-enabled(true 또는 false 설정),
  • aof-storage-connection-string-0(위의 형식으로 연결 문자열 제공합니다.)
  • aof-storage-connection-string-1(필요에 따라 다른 스토리지 계정을 구성할 수 있습니다. 두 번째 스토리지 계정이 구성된 경우 복제본 캐시에 대한 쓰기는 이 두 번째 스토리지 계정에 기록됩니다.)
New-AzRedisCache -ResourceGroupName "MyGroup" -Name "MyCache" -Location "Central US" -Size P1 -Sku "Premium" -RedisConfiguration @{"aof-backup-enabled" = "true"; "aof-storage-connection-string-0" = "DefaultEndpointsProtocol=https;AccountName=mystorageaccount;AccountKey=******;EndpointSuffix=mySuffix"}

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  : creating
          SslPort            : 6380
          RedisConfiguration : {[maxmemory-policy, allkeys-random], [maxclients, 7500], [maxmemory-reserved, 200],
                                [maxfragmentationmemory-reserved, 300], [aof-backup-enabled, true]...}
          EnableNonSslPort   : False
          RedisVersion       : 4.0.14
          Size               : 6GB
          Sku                : Premium
          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

-Location

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

  • 미국 중북부
  • 미국 중남부
  • 미국 중부
  • 서유럽
  • 북유럽
  • 미국 서부
  • 미국 동부
  • 미국 동부 2
  • 일본 동부
  • 일본 서부
  • 브라질 남부
  • 동남아시아
  • 동아시아
  • 오스트레일리아 동부
  • 오스트레일리아 남동부
형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-MinimumTlsVersion

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

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

-Name

만들 Redis Cache의 이름을 지정합니다.

형식: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
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ShardCount

프리미엄 클러스터 캐시에 만들 분할된 데이터베이스 수를 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
형식: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 기본값은 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

-StaticIP

Redis Cache의 서브넷에 고유한 IP 주소를 지정합니다. 이 매개 변수의 값을 지정하지 않으면 이 cmdlet은 서브넷에서 IP 주소를 선택합니다.

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

-SubnetId

Azure Cache for Redis를 배포할 가상 네트워크에 있는 서브넷의 전체 리소스 ID입니다. 예제 형식: /subscriptions/{subid}/resourceGroups/{resourceGroupName}/Microsoft. {Network|ClassicNetwork}/VirtualNetworks/{vnetName}/subnets/{subnetName}

형식:String
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:Stable
필수: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

-Zone

가용성 영역이 있는 Azure 지역 목록입니다.

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용: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]]

String[]

출력

RedisCacheAttributesWithAccessKeys