New-AzRedisEnterpriseCache
Redis Enterprise 캐시를 만듭니다.
구문
CreateClusterWithDatabase (기본값)
New-AzRedisEnterpriseCache
-ClusterName <String>
-ResourceGroupName <String>
-Location <String>
-Sku <SkuName>
[-SubscriptionId <String>]
[-Capacity <Int32>]
[-MinimumTlsVersion <TlsVersion>]
[-Zone <String[]>]
[-Tag <Hashtable>]
[-Module <IModule[]>]
[-ClientProtocol <Protocol>]
[-Port <Int32>]
[-EvictionPolicy <EvictionPolicy>]
[-GroupNickname <String>]
[-LinkedDatabase <ILinkedDatabase[]>]
[-ClusteringPolicy <ClusteringPolicy>]
[-AccessKeysAuthentication <AccessKeysAuthentication>]
[-CustomerManagedKeyEncryptionKeyUrl <String>]
[-HighAvailability <HighAvailability>]
[-PublicNetworkAccess <PublicNetworkAccess>]
[-IdentityType <ManagedServiceIdentityType>]
[-IdentityUserAssignedIdentity <Hashtable>]
[-KeyEncryptionKeyIdentityType <CmkIdentityType>]
[-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId <String>]
[-AofPersistenceEnabled]
[-AofPersistenceFrequency <AofFrequency>]
[-RdbPersistenceEnabled]
[-RdbPersistenceFrequency <RdbFrequency>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateClusterOnly
New-AzRedisEnterpriseCache
-ClusterName <String>
-ResourceGroupName <String>
-Location <String>
-Sku <SkuName>
[-SubscriptionId <String>]
[-Capacity <Int32>]
[-MinimumTlsVersion <TlsVersion>]
[-Zone <String[]>]
[-Tag <Hashtable>]
[-CustomerManagedKeyEncryptionKeyUrl <String>]
[-HighAvailability <HighAvailability>]
[-PublicNetworkAccess <PublicNetworkAccess>]
[-IdentityType <ManagedServiceIdentityType>]
[-IdentityUserAssignedIdentity <Hashtable>]
[-KeyEncryptionKeyIdentityType <CmkIdentityType>]
[-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-NoDatabase]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
연결된 데이터베이스를 사용하여 기존(잠재적 가동 중지 시간으로 덮어쓰기/다시 만들기) 캐시 클러스터를 만들거나 업데이트합니다.
예제
예제 1: Redis Enterprise 캐시 만들기
New-AzRedisEnterpriseCache -Name "MyCache" -ResourceGroupName "MyGroup" -Location "West US" -Sku "Enterprise_E10"
Location Name Type Zone Database
-------- ---- ---- ---- --------
West US MyCache Microsoft.Cache/redisEnterprise {default}
이 명령은 연결된 데이터베이스가 기본값인 MyCache라는 Redis Enterprise 캐시를 만듭니다.
예제 2: 일부 선택적 매개 변수를 사용하여 Redis Enterprise 캐시 만들기
New-AzRedisEnterpriseCache -Name "MyCache" -ResourceGroupName "MyGroup" -Location "East US" -Sku "Enterprise_E20" -Capacity 4 -MinimumTlsVersion "1.2" -Zone "1","2","3" -Tag @{"tag1" = "value1"} -Module "{name:RedisBloom, args:`"ERROR_RATE 0.00 INITIAL_SIZE 400`"}","{name:RedisTimeSeries, args:`"RETENTION_POLICY 20`"}","{name:RediSearch}" -ClientProtocol "Plaintext" -EvictionPolicy "NoEviction" -ClusteringPolicy "EnterpriseCluster" -AofPersistenceEnabled -AofPersistenceFrequency "1s"
Location Name Type Zone Database
-------- ---- ---- ---- --------
East US MyCache Microsoft.Cache/redisEnterprise {1, 2, 3} {default}
이 명령은 일부 선택적 매개 변수를 사용하여 기본값으로 명명된 연결된 데이터베이스를 사용하여 MyCache라는 Redis Enterprise 캐시를 만듭니다.
예제 3: 고급 - 연결된 데이터베이스 없이 Redis Enterprise 캐시 클러스터 만들기
New-AzRedisEnterpriseCache -Name "MyCache" -ResourceGroupName "MyGroup" -Location "East US" -Sku "EnterpriseFlash_F300" -NoDatabase
Location Name Type Zone Database
-------- ---- ---- ---- --------
East US MyCache Microsoft.Cache/redisEnterprise {}
경고: 이 명령은 데이터를 저장할 연결된 데이터베이스 없이 MyCache라는 Redis Enterprise 캐시 클러스터를 만듭니다.
예제 4: 지역 복제 데이터베이스를 사용하여 Redis Enterprise 캐시 만들기
New-AzRedisEnterpriseCache -Name "MyCache" -ResourceGroupName "MyGroup" -Location "West US" -Sku "Enterprise_E10" -ClientProtocol "Encrypted" -EvictionPolicy "NoEviction" -ClusteringPolicy "EnterpriseCluster" -GroupNickname "GroupNickname" -LinkedDatabase '{id:"/subscriptions/6b9ac7d2-7f6d-4de4-962c-43fda44bc3f2/resourceGroups/MyGroup/providers/Microsoft.Cache/redisEnterprise/MyCache/databases/default"}'
Location Name Type Zone Database
-------- ---- ---- ---- --------
West US MyCache Microsoft.Cache/redisEnterprise {default}
이 명령은 기본값으로 명명된 지리적으로 복제된 데이터베이스를 사용하여 캐시 이름 MyCache를 만듭니다.
매개 변수
-AccessKeysAuthentication
현재 액세스 키를 사용하여 액세스를 허용하거나 거부하려면 이 속성을 사용/사용 안 함으로 설정할 수 있습니다.
데이터베이스를 만든 후에도 업데이트할 수 있습니다.
매개 변수 속성
매개 변수 집합
CreateClusterWithDatabase
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-AofPersistenceEnabled
[미리 보기] AOF 지속성을 사용할 수 있는지 여부를 설정합니다.
AOF 지속성을 사용하도록 설정한 후에는 사용하지 않도록 설정할 수 없습니다.
사용하도록 설정한 후 AOF 지속성을 사용하지 않도록 설정하기 위한 지원이 나중에 추가됩니다.
매개 변수 속성
매개 변수 집합
CreateClusterWithDatabase
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-AofPersistenceFrequency
[미리 보기] AOF 지속성을 사용하는 경우 데이터가 디스크에 기록되는 빈도를 설정합니다.
허용되는 값: 1s, 항상
매개 변수 속성
형식: AofFrequency
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
CreateClusterWithDatabase
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-AsJob
작업으로 명령 실행
매개 변수 속성
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-Capacity
RedisEnterprise 클러스터의 크기입니다.
기본값은 2 또는 3이거나 SKU에 따라 적용되지 않습니다. 유효한 값은 Enterprise_* SKU의 경우 (2, 4, 6, ...) 및 EnterpriseFlash_* SKU의 경우 (3, 9, 15, ...)입니다.
다른 SKU 용량 인수는 지원되지 않습니다.
매개 변수 속성
형식: Int32
Default value: None
와일드카드 지원: False
DontShow: False
별칭: Sku용량
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-ClientProtocol
redis 클라이언트가 TLS 암호화 또는 일반 텍스트 redis 프로토콜을 사용하여 연결할 수 있는지 여부를 지정합니다. 기본값은 암호화된 허용 값입니다. 암호화됨, 일반 텍스트
매개 변수 속성
형식: Protocol
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
CreateClusterWithDatabase
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-ClusteringPolicy
클러스터링 정책 - 기본값은 생성 시 지정된 OSSCluster입니다.
허용되는 값: EnterpriseCluster, OSSCluster
매개 변수 속성
매개 변수 집합
CreateClusterWithDatabase
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-ClusterName
Redis Enterprise 클러스터의 이름입니다.
매개 변수 속성
형식: String
Default value: None
와일드카드 지원: False
DontShow: False
별칭: 이름
매개 변수 집합
(All)
Position: Named
필수: True
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
매개 변수 속성
형식: SwitchParameter
Default value: None
와일드카드 지원: False
DontShow: False
별칭: cf(cf)
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-CustomerManagedKeyEncryptionKeyUrl
키 암호화 키 URL만 버전 관리됩니다.
예: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78"
매개 변수 속성
형식: String
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-DefaultProfile
Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.
매개 변수 속성
형식: PSObject
Default value: None
와일드카드 지원: False
DontShow: False
별칭: AzureRMContext, AzureCredential
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-EvictionPolicy
Redis 제거 정책 - 기본값은 VolatileLRU 허용 값입니다. AllKeysLFU, AllKeysLRU, AllKeysRandom, VolatileLRU, VolatileLFU, VolatileTTL, VolatileRandom, NoEviction
매개 변수 속성
매개 변수 집합
CreateClusterWithDatabase
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-GroupNickname
연결된 데이터베이스 리소스 그룹의 이름
매개 변수 속성
형식: String
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
CreateClusterWithDatabase
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-HighAvailability
기본적으로 사용하도록 설정됩니다.
사용 안 함에서 사용으로만 업데이트할 수 있습니다.
highAvailability를 사용하지 않도록 설정하면 데이터 집합이 복제되지 않습니다.
이는 가용성 SLA에 영향을 미치며 데이터 손실의 위험을 증가합니다.
매개 변수 속성
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-IdentityType
관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우).
매개 변수 속성
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-IdentityUserAssignedIdentity
리소스와 연결된 사용자 할당 ID 집합입니다.
userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다.
사전 값은 요청에서 빈 개체({})일 수 있습니다.
매개 변수 속성
형식: Hashtable
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-KeyEncryptionKeyIdentityType
이 API 버전에서는 userAssignedIdentity만 지원됩니다. 다른 형식은 나중에 지원될 수 있습니다.
매개 변수 속성
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId
키 암호화 키 URL에 액세스하는 데 사용할 사용자 할당 ID입니다.
예: /subscriptions/<sub uuid>/resourceGroups/<resource group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId.
매개 변수 속성
형식: String
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-LinkedDatabase
이 데이터베이스와 연결할 데이터베이스 리소스 목록을 생성하려면 GEOREPLICATIONLINKEDDATABASE 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.
생성하려면 LINKEDDATABASE 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.
매개 변수 속성
매개 변수 집합
CreateClusterWithDatabase
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-Location
리소스가 있는 지리적 위치입니다.
매개 변수 속성
형식: String
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
(All)
Position: Named
필수: True
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-MinimumTlsVersion
지원할 클러스터의 최소 TLS 버전 - 기본값은 1.2 허용 값: 1.0, 1.1, 1.2입니다.
매개 변수 속성
형식: TlsVersion
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-Module
이 데이터베이스에서 사용하도록 설정할 선택적 redis 모듈 집합 - 모듈은 생성 시에만 추가할 수 있습니다.
구성하려면 MODULE 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.
매개 변수 속성
형식: IModule [ ]
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
CreateClusterWithDatabase
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-NoDatabase
고급 - 기본 데이터베이스를 자동으로 만들지 마세요.
경고: 데이터베이스를 만들 때까지 캐시를 사용할 수 없습니다.
매개 변수 속성
매개 변수 집합
CreateClusterOnly
Position: Named
필수: True
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-NoWait
명령을 비동기적으로 실행
매개 변수 속성
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-Port
데이터베이스 엔드포인트의 TCP 포트 - 기본적으로 생성 시 지정된 사용 가능한 포트로 설정됩니다.
매개 변수 속성
형식: Int32
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
CreateClusterWithDatabase
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-PublicNetworkAccess
공용 네트워크 트래픽이 Redis 클러스터에 액세스할 수 있는지 여부입니다.
'사용' 또는 '사용 안 함'만 설정할 수 있습니다.
매개 변수 속성
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-RdbPersistenceEnabled
[미리 보기] RDB 지속성을 사용할 수 있는지 여부를 설정합니다.
RDB 지속성을 사용하도록 설정한 후에는 사용하지 않도록 설정할 수 없습니다.
사용하도록 설정한 후 RDB 지속성을 사용하지 않도록 설정하기 위한 지원이 나중에 추가됩니다.
매개 변수 속성
매개 변수 집합
CreateClusterWithDatabase
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-RdbPersistenceFrequency
[미리 보기] RDB 지속성을 사용하는 경우 데이터베이스의 스냅샷이 만들어지는 빈도를 설정합니다.
허용되는 값: 1h, 6h, 12h
매개 변수 속성
형식: RdbFrequency
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
CreateClusterWithDatabase
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-ResourceGroupName
리소스 그룹의 이름입니다.
이름은 대소문자를 구분하지 않습니다.
매개 변수 속성
형식: String
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
(All)
Position: Named
필수: True
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-Sku
배포할 RedisEnterprise 클러스터의 형식입니다.
허용되는 값: Balanced_B0, Balanced_B1, Balanced_B10, Balanced_B100, Balanced_B1000, Balanced_B150, Balanced_B20, Balanced_B250, Balanced_B3, Balanced_B350, Balanced_B5, Balanced_B50, Balanced_B500, Balanced_B700, ComputeOptimized_X10, ComputeOptimized_X100, ComputeOptimized_X150, ComputeOptimized_X20, ComputeOptimized_X250, ComputeOptimized_X3, ComputeOptimized_X350, ComputeOptimized_X5, ComputeOptimized_X50, ComputeOptimized_X500, ComputeOptimized_X700 EnterpriseFlash_F1500, EnterpriseFlash_F300, EnterpriseFlash_F700, Enterprise_E1, Enterprise_E10, Enterprise_E100, Enterprise_E20, Enterprise_E200, Enterprise_E400, Enterprise_E5, Enterprise_E50, FlashOptimized_A1000, FlashOptimized_A1500, FlashOptimized_A2000, FlashOptimized_A250, FlashOptimized_A4500, FlashOptimized_A500, FlashOptimized_A700, MemoryOptimized_M10, MemoryOptimized_M100, MemoryOptimized_M1000, MemoryOptimized_M150, MemoryOptimized_M1500, MemoryOptimized_ M20, MemoryOptimized_M2000, MemoryOptimized_M250, MemoryOptimized_M350, MemoryOptimized_M50, MemoryOptimized_M500, MemoryOptimized_M700
매개 변수 속성
형식: SkuName
Default value: None
와일드카드 지원: False
DontShow: False
별칭: SKU 이름
매개 변수 집합
(All)
Position: Named
필수: True
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-SubscriptionId
대상 구독의 ID입니다.
매개 변수 속성
형식: String
Default value: (Get-AzContext).Subscription.Id
와일드카드 지원: False
DontShow: False
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-Tag
클러스터 리소스 태그입니다.
매개 변수 속성
형식: Hashtable
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여 주세요.
cmdlet이 실행되지 않습니다.
매개 변수 속성
형식: SwitchParameter
Default value: None
와일드카드 지원: False
DontShow: False
별칭: 위스콘신
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-Zone
이 클러스터를 배포할 가용성 영역입니다.
매개 변수 속성
형식: String [ ]
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters 를 참조하세요.
출력