New-AzRedisEnterpriseCache

참조

모듈:: Az.RedisEnterpriseCache

Redis Enterprise 캐시를 만듭니다.

Syntax

New-AzRedisEnterpriseCache
   -ClusterName <String>
   -ResourceGroupName <String>
   -Location <String>
   -Sku <SkuName>
   [-SubscriptionId <String>]
   [-AofPersistenceEnabled]
   [-AofPersistenceFrequency <AofFrequency>]
   [-Capacity <Int32>]
   [-ClientProtocol <Protocol>]
   [-ClusteringPolicy <ClusteringPolicy>]
   [-CustomerManagedKeyEncryptionKeyUrl <String>]
   [-EvictionPolicy <EvictionPolicy>]
   [-GroupNickname <String>]
   [-IdentityType <ManagedServiceIdentityType>]
   [-IdentityUserAssignedIdentity <Hashtable>]
   [-KeyEncryptionKeyIdentityType <CmkIdentityType>]
   [-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId <String>]
   [-LinkedDatabase <ILinkedDatabase[]>]
   [-MinimumTlsVersion <TlsVersion>]
   [-Module <IModule[]>]
   [-Port <Int32>]
   [-RdbPersistenceEnabled]
   [-RdbPersistenceFrequency <RdbFrequency>]
   [-Tag <Hashtable>]
   [-Zone <String[]>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

New-AzRedisEnterpriseCache
   -ClusterName <String>
   -ResourceGroupName <String>
   -Location <String>
   -Sku <SkuName>
   -NoDatabase
   [-SubscriptionId <String>]
   [-Capacity <Int32>]
   [-CustomerManagedKeyEncryptionKeyUrl <String>]
   [-IdentityType <ManagedServiceIdentityType>]
   [-IdentityUserAssignedIdentity <Hashtable>]
   [-KeyEncryptionKeyIdentityType <CmkIdentityType>]
   [-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId <String>]
   [-MinimumTlsVersion <TlsVersion>]
   [-Tag <Hashtable>]
   [-Zone <String[]>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-Confirm]
   [-WhatIf]
   [<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: 지역 복제본(replica)ted 데이터베이스를 사용하여 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}

이 명령은 기본값으로 명명된 지역 복제본(replica)ted 데이터베이스를 사용하여 캐시 이름 MyCache를 만듭니다.

매개 변수

-AofPersistenceEnabled

[미리 보기] AOF 지속성을 사용할 수 있는지 여부를 설정합니다. AOF 지속성을 사용하도록 설정한 후에는 사용하지 않도록 설정할 수 없습니다. 사용하도록 설정한 후 AOF 지속성을 사용하지 않도록 설정하기 위한 지원이 나중에 추가됩니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AofPersistenceFrequency

[미리 보기] AOF 지속성을 사용하는 경우 데이터가 디스크에 기록되는 빈도를 설정합니다. 허용되는 값: 1s, 항상

Type:	AofFrequency
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AsJob

작업으로 명령 실행

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Capacity

Redis Enterprise 클러스터의 크기 - SKU에 따라 기본값은 2 또는 3입니다. 허용되는 값은 엔터프라이즈 SKU의 경우 (2, 4, 6, ...) 및 Flash SKU의 경우 (3, 9, 15, ...)입니다.

Type:	Int32
Aliases:	SkuCapacity
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClientProtocol

redis 클라이언트가 TLS 암호화 또는 일반 텍스트 redis 프로토콜을 사용하여 연결할 수 있는지 여부를 지정합니다. 기본값은 암호화된 허용 값입니다. 암호화됨, 일반 텍스트

Type:	Protocol
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClusteringPolicy

클러스터링 정책 - 기본값은 생성 시 지정된 OSSCluster입니다. 허용되는 값: EnterpriseCluster, OSSCluster

Type:	ClusteringPolicy
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClusterName

Redis Enterprise 클러스터의 이름입니다.

Type:	String
Aliases:	Name
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CustomerManagedKeyEncryptionKeyUrl

키 암호화 키 URL만 버전 관리됩니다. 예: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78"

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EvictionPolicy

Redis 제거 정책 - 기본값은 VolatileLRU 허용 값입니다. AllKeysLFU, AllKeysLRU, AllKeysRandom, VolatileLRU, VolatileLFU, VolatileTTL, VolatileRandom, NoEviction

Type:	EvictionPolicy
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-GroupNickname

연결된 데이터베이스 리소스 그룹의 이름

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IdentityType

관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우).

Type:	ManagedServiceIdentityType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IdentityUserAssignedIdentity

리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-KeyEncryptionKeyIdentityType

이 API 버전에서는 userAssignedIdentity만 지원됩니다. 다른 형식은 나중에 지원될 수 있습니다.

Type:	CmkIdentityType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-KeyEncryptionKeyIdentityUserAssignedIdentityResourceId

키 암호화 키 URL에 액세스하는 데 사용할 사용자 할당 ID입니다. 예: /subscriptions/<sub uuid>/resourceGroups/<resource group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LinkedDatabase

이 데이터베이스와 연결할 데이터베이스 리소스 목록을 생성하려면 GEOREPLICATIONLINKEDDATABASE 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다. 생성하려면 LINKEDDATABASE 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

Type:	ILinkedDatabase[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Location

리소스가 있는 지리적 위치입니다.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-MinimumTlsVersion

지원할 클러스터의 최소 TLS 버전 - 기본값은 1.2 허용 값: 1.0, 1.1, 1.2입니다.

Type:	TlsVersion
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Module

이 데이터베이스에서 사용하도록 설정할 선택적 redis 모듈 집합 - 모듈은 생성 시에만 추가할 수 있습니다. 구성하려면 MODULE 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

Type:	IModule[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoDatabase

고급 - 기본 데이터베이스를 자동으로 만들지 마세요. 경고: 데이터베이스를 만들 때까지 캐시를 사용할 수 없습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NoWait

명령을 비동기적으로 실행

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Port

데이터베이스 엔드포인트의 TCP 포트 - 기본적으로 생성 시 지정된 사용 가능한 포트로 설정됩니다.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RdbPersistenceEnabled

[미리 보기] RDB 지속성을 사용할 수 있는지 여부를 설정합니다. RDB 지속성을 사용하도록 설정한 후에는 사용하지 않도록 설정할 수 없습니다. 사용하도록 설정한 후 RDB 지속성을 사용하지 않도록 설정하기 위한 지원이 나중에 추가됩니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RdbPersistenceFrequency

[미리 보기] RDB 지속성을 사용하는 경우 데이터베이스의 스냅샷 생성되는 빈도를 설정합니다. 허용되는 값: 1h, 6h, 12h

Type:	RdbFrequency
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Sku

배포할 Redis Enterprise 클러스터의 유형입니다. 허용되는 값: Enterprise_E10, Enterprise_E20, Enterprise_E50, Enterprise_E100, EnterpriseFlash_F300, EnterpriseFlash_F700, EnterpriseFlash_F1500

Type:	SkuName
Aliases:	SkuName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SubscriptionId

대상 구독의 ID입니다.

Type:	String
Position:	Named
Default value:	(Get-AzContext).Subscription.Id
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

클러스터 리소스 태그입니다.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Zone

이 클러스터를 배포할 가용성 영역.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

출력

ICluster

참고

별칭

복합 매개 변수 속성

아래에 설명된 매개 변수를 만들려면 적절한 속성을 포함하는 해시 테이블을 생성합니다. 해시 테이블에 대한 자세한 내용은 Get-Help about_Hash_Tables 실행합니다.

LINKEDDATABASE <ILinkedDatabase[]>: 이 데이터베이스와 연결할 데이터베이스 리소스 목록을 생성하려면 GEOREPLICATIONLINKEDDATABASE 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

[Id <String>]: 이 데이터베이스와 연결할 데이터베이스 리소스의 리소스 ID입니다.

MODULE <IModule[]>: 이 데이터베이스에서 사용하도록 설정하는 선택적 redis 모듈 집합 - 모듈은 생성 시에만 추가할 수 있습니다.

Name <String>: 모듈의 이름(예: 'RedisBloom', 'RediSearch', 'RedisTimeSeries')
[Arg <String>]: 모듈에 대한 구성 옵션(예: 'ERROR_RATE 0.01 INITIAL_SIZE 400').