다음을 통해 공유

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

  • 아티클

이 문서에서는 Azure Cache for Redis 인스턴스 만들기, 업데이트 및 크기 조정 방법을 보여줍니다. 이 문서에서는 액세스 키를 재생성하는 방법과 캐시에 대한 정보를 보는 방법도 보여줍니다. Azure Cache for Redis PowerShell cmdlet의 전체 목록은 Azure Cache for Redis cmdlet을 참조하세요.

참고 항목

Azure에는 리소스를 만들고 사용하는 데 필요한 두 가지 배포 모델이 있습니다. Azure Resource Manager 및 클래식이라는 두 가지 배포 모델이 있다는 것을 이해해야 합니다. 이 문서에서는 Resource Manager 배포 모델의 사용법에 대해 설명합니다. 새 배포에는 클래식 배포 모델 대신 Resource Manager 배포 모델을 사용하는 것이 좋습니다.

두 배포 모델에 대한 자세한 내용은 Azure Resource Manager 및 클래식 배포: 배포 모델 및 리소스 상태 이해를 참조하세요.

필수 조건

Azure PowerShell을 이미 설치한 경우 Azure PowerShell 버전 1.0.0 이상이 있어야 합니다. Azure PowerShell 명령 프롬프트에서 이 명령을 사용하여 Azure PowerShell의 버전을 확인할 수 있습니다.

    Get-Module Az | format-table version

먼저 다음 명령을 사용하여 Azure에 로그인해야 합니다.

    Connect-AzAccount

Microsoft Azure 로그인 대화 상자에서 Azure 계정의 메일 주소 및 암호를 지정합니다.

다음으로, 여러 Azure 구독이 있는 경우 Azure 구독을 설정해야 합니다. 현재 구독 목록을 보려면 다음 명령을 실행합니다.

    Get-AzSubscription | sort SubscriptionName | Select SubscriptionName

구독을 지정하려면 다음 명령을 실행합니다. 다음 예제에서 구독 이름은 ContosoSubscription입니다.

    Select-AzSubscription -SubscriptionName ContosoSubscription

Azure Resource Manager에서 Windows PowerShell을 사용하려면 먼저 다음 설정을 확인해야 합니다.

  • Windows PowerShell, 버전 3.0 또는 4.0. Windows PowerShell 버전을 확인하려면 $PSVersionTable을 입력하고 PSVersion 값이 3.0 또는 4.0인지를 확인합니다. 호환 버전을 설치하려면 Windows Management Framework 3.0을 참조하세요.

이 자습서에 나오는 cmdlet에 대한 자세한 도움말을 보려면 Get-Help cmdlet을 사용합니다.

    Get-Help <cmdlet-name> -Detailed

예를 들어 New-AzRedisCache cmdlet에 대한 도움말을 보려면 다음과 같이 입력합니다.

    Get-Help New-AzRedisCache -Detailed

다른 클라우드에 연결하는 방법

기본적으로 Azure 환경은 글로벌 Azure 클라우드 인스턴스를 나타내는 AzureCloud입니다. 다른 인스턴스에 연결하려면 원하는 환경 또는 환경 이름을 사용하여 -Environment 또는 -EnvironmentName 명령줄 스위치와 함께 Connect-AzAccount 명령을 사용합니다.

사용 가능한 환경 목록을 보려면 Get-AzEnvironment cmdlet을 실행합니다.

Azure Government 클라우드를 연결하려면

Azure Government 클라우드를 연결하려면 다음 명령 중 하나를 사용합니다.

    Connect-AzAccount -EnvironmentName AzureUSGovernment

또는

    Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureUSGovernment)

Azure Government 클라우드 내에 캐시를 만들려면 다음 위치 중 하나를 사용합니다.

  • USGov 버지니아
  • USGov 아이오와

Azure Government 클라우드에 대한 자세한 내용은 Microsoft Azure Government 및 Microsoft Azure Government 개발자 가이드를 참조하세요.

21Vianet에서 운영하는 Microsoft Azure 클라우드에 연결하려면

21Vianet에서 운영하는 Azure 클라우드에 연결하려면 다음 명령 중 하나를 사용합니다.

    Connect-AzAccount -EnvironmentName AzureChinaCloud

또는

    Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureChinaCloud)

21Vianet에서 운영하는 Azure 클라우드에서 캐시를 만들려면 다음 위치 중 하나를 사용합니다.

  • 중국 동부
  • 중국 북부

Microsoft Azure Germany에 연결하려면

Microsoft Azure Germany에 연결하려면 다음 명령 중 하나를 사용합니다.

    Connect-AzAccount -EnvironmentName AzureGermanCloud

또는

    Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureGermanCloud)

Microsoft Azure Germany에서 캐시를 만들려면 다음 위치 중 하나를 사용합니다.

  • 독일 중부
  • 독일 북동부

Microsoft Azure Germany에 대한 자세한 내용은 Microsoft Azure Germany를 참조하세요.

Azure Cache for Redis PowerShell에 사용되는 속성

다음 표에는 Azure Cache for Redis 인스턴스를 만들고 관리할 때 공통 매개 변수에 대한 Azure PowerShell 속성 및 설명이 포함되어 있습니다.

매개 변수 설명 기본값
이름 캐시의 이름
위치 캐시의 위치
ResourceGroupName 캐시를 만들 리소스 그룹 이름
크기 캐시의 크기. 유효한 값: P1, P2, P3, P4, P5, C0, C1, C2, C3, C4, C5, C6, 250MB, 1GB, 2.5GB, 6GB, 13GB, 26GB, 53GB 1GB
ShardCount 클러스터링을 사용하는 프리미엄 캐시를 만들 때 만들 분할된 데이터베이스 수. 유효한 값: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
SKU 캐시의 SKU를 지정합니다. 유효한 값: 기본, 표준, 프리미엄 Standard
RedisConfiguration Redis 구성 설정을 지정합니다. 각 설정에 대한 자세한 내용은 다음 RedisConfiguration 속성 테이블을 참조하세요.
EnableNonSslPort 비 SSL 포트를 사용하는지 여부를 나타냅니다. False
MaxMemoryPolicy 이 매개 변수는 더 이상 사용되지 않으며 대신 RedisConfiguration을 사용합니다.
StaticIP VNET에서 캐시를 호스팅하는 경우 서브넷에서 캐시에 대한 고유 IP 주소를 지정합니다. 제공되지 않으면 하나의 IP 주소가 서브넷에서 자동으로 선택됩니다.
서브넷 VNET에서 캐시를 호스팅하는 경우에 캐시를 배포할 서브넷의 이름을 지정합니다.
VirtualNetwork VNET에서 캐시를 호스팅하는 경우에 캐시를 배포할 VNET의 리소스 ID를 지정합니다.
KeyType 액세스 키를 갱신할 때 다시 생성할 액세스 키를 지정합니다. 유효한 값: 주, 보조

RedisConfiguration 속성

속성 설명 가격 책정 계층
rdb-backup-enabled Redis 데이터 지속성 사용 여부 프리미엄 전용
rdb-storage-connection-string Redis 데이터 지속성 프리미엄 전용
rdb-backup-frequency Redis 데이터 지속성 프리미엄 전용
maxmemory-reserved 비 캐시 프로세스를 위해 예약되는 메모리 를 구성합니다 표준 및 프리미엄
maxmemory-policy 캐시에 대한 제거 정책 을 구성합니다 모든 가격 책정 계층
notify-keyspace-events Keyspace 알림 표준 및 프리미엄
hash-max-ziplist-entries 작은 집계 데이터 형식에 대한 메모리 최적화 구성 표준 및 프리미엄
hash-max-ziplist-value 작은 집계 데이터 형식에 대한 메모리 최적화 구성 표준 및 프리미엄
set-max-intset-entries 작은 집계 데이터 형식에 대한 메모리 최적화 구성 표준 및 프리미엄
zset-max-ziplist-entries 작은 집계 데이터 형식에 대한 메모리 최적화 구성 표준 및 프리미엄
zset-max-ziplist-value 작은 집계 데이터 형식에 대한 메모리 최적화 구성 표준 및 프리미엄
databases 데이터베이스 수를 구성합니다. 이 속성은 캐시 만들기에서만 구성할 수 있습니다. 표준 및 프리미엄

Azure Cache for Redis를 만들려면

New-AzRedisCache cmdlet을 사용하여 새 Azure Cache for Redis 인스턴스를 만듭니다.

Important

Azure Portal을 사용하여 구독에 처음으로 Azure Cache for Redis를 만들 때 포털은 해당 구독에 대해 Microsoft.Cache 네임스페이스를 등록합니다. PowerShell을 사용하여 구독에서 첫 번째 Azure Cache for Redis를 만드는 경우, 먼저 다음 명령을 사용하여 해당 네임스페이스를 등록해야 하며 그렇지 않은 경우 New-AzRedisCache 및 Get-AzRedisCache의 cmdlet이 실패합니다.

Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache"

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

    PS C:\> Get-Help New-AzRedisCache -detailed

    NAME
        New-AzRedisCache

    SYNOPSIS
        Creates a new Azure Cache for Redis.


    SYNTAX
        New-AzRedisCache -Name <String> -ResourceGroupName <String> -Location <String> [-RedisVersion <String>]
        [-Size <String>] [-Sku <String>] [-MaxMemoryPolicy <String>] [-RedisConfiguration <Hashtable>] [-EnableNonSslPort
        <Boolean>] [-ShardCount <Integer>] [-VirtualNetwork <String>] [-Subnet <String>] [-StaticIP <String>]
        [<CommonParameters>]


    DESCRIPTION
        The New-AzRedisCache cmdlet creates a new Azure Cache for Redis.


    PARAMETERS
        -Name <String>
            Name of the Azure Cache for Redis to create.

        -ResourceGroupName <String>
            Name of resource group in which to create the Azure Cache for Redis.

        -Location <String>
            Location in which to create the Azure Cache for Redis.

        -RedisVersion <String>
            RedisVersion is deprecated and will be removed in future release.

        -Size <String>
            Size of the Azure Cache for Redis. The default value is 1GB or C1. Possible values are P1, P2, P3, P4, C0, C1, C2, C3,
            C4, C5, C6, 250MB, 1GB, 2.5GB, 6GB, 13GB, 26GB, 53GB.

        -Sku <String>
            Sku of Azure Cache for Redis. The default value is Standard. Possible values are Basic, Standard and Premium.

        -MaxMemoryPolicy <String>
            The 'MaxMemoryPolicy' setting has been deprecated. Please use 'RedisConfiguration' setting to set
            MaxMemoryPolicy. e.g. -RedisConfiguration @{"maxmemory-policy" = "allkeys-lru"}

        -RedisConfiguration <Hashtable>
            All Redis Configuration Settings. Few possible keys: rdb-backup-enabled, rdb-storage-connection-string,
            rdb-backup-frequency, 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, databases.

        -EnableNonSslPort <Boolean>
            EnableNonSslPort is used by Azure Cache for Redis. If no value is provided, the default value is false and the
            non-SSL port will be disabled. Possible values are true and false.

        -ShardCount <Integer>
            The number of shards to create on a Premium Cluster Cache.

        -VirtualNetwork <String>
            The exact ARM resource ID of the virtual network to deploy the Azure Cache for Redis in. Example format: /subscriptions/{
            subid}/resourceGroups/{resourceGroupName}/providers/Microsoft.ClassicNetwork/VirtualNetworks/{vnetName}

        -Subnet <String>
            Required when deploying an Azure Cache for Redis inside an existing Azure Virtual Network.

        -StaticIP <String>
            Required when deploying an Azure Cache for Redis inside an existing Azure Virtual Network.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

기본 매개 변수로 캐시를 만들려면 다음 명령을 실행합니다.

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

ResourceGroupName, Name 및 Location은 필수 매개 변수이지만 나머지는 선택 사항이며 기본값을 포함합니다. 이전 명령을 실행하면 지정된 이름, 위치 및 리소스 그룹으로 표준 SKU Azure Cache for Redis 인스턴스가 만들어집니다. 인스턴스 크기는 1GB이며 비 SSL 포트는 사용하지 않도록 설정되어 있습니다.

프리미엄 캐시를 만들려면 P1(6GB - 60GB), P2(13GB - 130GB), P3(26GB - 260GB) 또는 P4(53GB - 530GB) 크기를 지정합니다. 클러스터링을 사용하려면 ShardCount 매개 변수를 사용하여 분할된 데이터베이스 수를 지정합니다. 다음 예제에서는 3개의 분할된 데이터베이스가 있는 P1 프리미엄 캐시를 만듭니다. P1 프리미엄 캐시는 6GB 크기이고 3개의 분할된 데이터베이스를 지정했으므로 총 크기는 18GB(3 x 6GB)입니다.

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

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

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

캐시를 만드는 동안 데이터베이스 설정을 구성하려면

databases 설정은 캐시를 만드는 동안에만 구성할 수 있습니다. 다음 예제에서는 New-AzRedisCache cmdlet를 사용하여 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 서버 구성을 참조하세요. New-AzRedisCache cmdlet를 사용하여 캐시를 만드는 방법에 대한 자세한 내용은 이전의 Azure Cache for Redis를 만들려면 섹션을 참조하세요.

Azure Cache for Redis를 업데이트하려면

Set-AzRedisCache cmdlet을 사용하여 Azure Cache for Redis 인스턴스를 업데이트합니다.

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

    PS C:\> Get-Help Set-AzRedisCache -detailed

    NAME
        Set-AzRedisCache

    SYNOPSIS
        Set Azure Cache for Redis updatable parameters.

    SYNTAX
        Set-AzRedisCache -Name <String> -ResourceGroupName <String> [-Size <String>] [-Sku <String>]
        [-MaxMemoryPolicy <String>] [-RedisConfiguration <Hashtable>] [-EnableNonSslPort <Boolean>] [-ShardCount
        <Integer>] [<CommonParameters>]

    DESCRIPTION
        The Set-AzRedisCache cmdlet sets Azure Cache for Redis parameters.

    PARAMETERS
        -Name <String>
            Name of the Azure Cache for Redis to update.

        -ResourceGroupName <String>
            Name of the resource group for the cache.

        -Size <String>
            Size of the Azure Cache for Redis. The default value is 1GB or C1. Possible values are P1, P2, P3, P4, C0, C1, C2, C3,
            C4, C5, C6, 250MB, 1GB, 2.5GB, 6GB, 13GB, 26GB, 53GB.

        -Sku <String>
            Sku of Azure Cache for Redis. The default value is Standard. Possible values are Basic, Standard and Premium.

        -MaxMemoryPolicy <String>
            The 'MaxMemoryPolicy' setting has been deprecated. Please use 'RedisConfiguration' setting to set
            MaxMemoryPolicy. e.g. -RedisConfiguration @{"maxmemory-policy" = "allkeys-lru"}

        -RedisConfiguration <Hashtable>
            All Redis Configuration Settings. Few possible keys: rdb-backup-enabled, rdb-storage-connection-string,
            rdb-backup-frequency, 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.

        -EnableNonSslPort <Boolean>
            EnableNonSslPort is used by Azure Cache for Redis. The default value is null and no change will be made to the
            currently configured value. Possible values are true and false.

        -ShardCount <Integer>
            The number of shards to create on a Premium Cluster Cache.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Size, Sku, EnableNonSslPort의 속성과 RedisConfiguration 값을 업데이트하는 데 Set-AzRedisCache cmdlet을 사용할 수 있습니다.

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

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

Azure Cache for Redis 크기를 조정하려면

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

참고 항목

PowerShell을 사용하여 캐시 크기를 조정할 경우 Azure 포털에서 캐시 크기를 조정할 때와 동일한 한도 및 지침이 적용됩니다. 다른 가격 책정 계층으로 크기를 조정할 수 있지만 다음과 같은 제한 사항이 있습니다.

  • 높은 가격 책정 계층에서 낮은 가격 책정 계층으로 크기를 조정할 수 없습니다.
  • 프리미엄 캐시에서 표준 또는 기본 캐시로 축소할 수 없습니다.
  • 표준 캐시에서 기본 캐시로 축소할 수 없습니다.
  • 기본 캐시에서 표준 캐시로 크기를 조정할 수 있지만 동시에 크기를 변경할 수는 없습니다. 다른 크기가 필요한 경우 후속 크기 조정 작업을 통해 원하는 크기로 조정할 수 있습니다.
  • 기본 캐시에서 바로 프리미엄 캐시로 확장할 수 없습니다. 크기 조정 작업을 통해 기본에서 표준으로 확장한 다음, 후속 크기 조정 작업을 통해 표준에서 프리미엄으로 확장해야 합니다.
  • 더 큰 크기에서 C0(250MB) 크기로 축소할 수 없습니다.

자세한 내용은 Azure Cache for Redis 크기를 조정하는 방법을 참조하세요.

다음 예제에서는 myCache라는 캐시를 2.5GB 캐시로 크기를 조정하는 방법을 보여 줍니다. 이 명령은 기본 또는 표준 캐시 둘 다에 적용할 수 있습니다.

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

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

    PS C:\> Set-AzRedisCache -Name myCache -ResourceGroupName myGroup -Size 2.5GB


    Name               : mycache
    Id                 : /subscriptions/12ad12bd-abdc-2231-a2ed-a2b8b246bbad4/resourceGroups/mygroup/providers/Mi
                         crosoft.Cache/Redis/mycache
    Location           : South Central US
    Type               : Microsoft.Cache/Redis
    HostName           : mycache.redis.cache.windows.net
    Port               : 6379
    ProvisioningState  : Scaling
    SslPort            : 6380
    RedisConfiguration : {[maxmemory-policy, volatile-lru], [maxmemory-reserved, 150], [notify-keyspace-events, KEA],
                         [maxmemory-delta, 150]...}
    EnableNonSslPort   : False
    RedisVersion       : 3.0
    Size               : 1GB
    Sku                : Standard
    ResourceGroupName  : mygroup
    PrimaryKey         : ....
    SecondaryKey       : ....
    VirtualNetwork     :
    Subnet             :
    StaticIP           :
    TenantSettings     : {}
    ShardCount         :

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

    PS C:\> Get-Help Get-AzRedisCache -detailed

    NAME
        Get-AzRedisCache

    SYNOPSIS
        Gets details about a single cache or all caches in the specified resource group or all caches in the current
        subscription.

    SYNTAX
        Get-AzRedisCache [-Name <String>] [-ResourceGroupName <String>] [<CommonParameters>]

    DESCRIPTION
        The Get-AzRedisCache cmdlet gets the details about a cache or caches depending on input parameters. If both
        ResourceGroupName and Name parameters are provided then Get-AzRedisCache will return details about the
        specific cache name provided.

        If only ResourceGroupName is provided than it will return details about all caches in the specified resource group.

        If no parameters are given than it will return details about all caches the current subscription.

    PARAMETERS
        -Name <String>
            The name of the cache. When this parameter is provided along with ResourceGroupName, Get-AzRedisCache
            returns the details for the cache.

        -ResourceGroupName <String>
            The name of the resource group that contains the cache or caches. If ResourceGroupName is provided with Name
            then Get-AzRedisCache returns the details of the cache specified by Name. If only the ResourceGroup
            parameter is provided, then details for all caches in the resource group are returned.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

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

    Get-AzRedisCache

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

    Get-AzRedisCache -ResourceGroupName myGroup

특정 캐시에 대한 정보를 반환하려면 캐시 이름을 포함하는 Name 매개 변수와 해당 캐시를 포함하는 리소스 그룹이 있는 ResourceGroupName 매개 변수와 함께 Get-AzRedisCache를 실행합니다.

    PS C:\> Get-AzRedisCache -Name myCache -ResourceGroupName myGroup

    Name               : mycache
    Id                 : /subscriptions/12ad12bd-abdc-2231-a2ed-a2b8b246bbad4/resourceGroups/myGroup/providers/Mi
                         crosoft.Cache/Redis/mycache
    Location           : South Central US
    Type               : Microsoft.Cache/Redis
    HostName           : mycache.redis.cache.windows.net
    Port               : 6379
    ProvisioningState  : Succeeded
    SslPort            : 6380
    RedisConfiguration : {[maxmemory-policy, volatile-lru], [maxmemory-reserved, 62], [notify-keyspace-events, KEA],
                         [maxclients, 1000]...}
    EnableNonSslPort   : False
    RedisVersion       : 3.0
    Size               : 1GB
    Sku                : Standard
    ResourceGroupName  : myGroup
    VirtualNetwork     :
    Subnet             :
    StaticIP           :
    TenantSettings     : {}
    ShardCount         :

Azure Cache for Redis에 대한 액세스 키를 검색하려면

캐시에 대한 액세스 키를 검색하려면 Get-AzRedisCacheKey cmdlet을 사용할 수 있습니다.

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

    PS C:\> Get-Help Get-AzRedisCacheKey -detailed

    NAME
        Get-AzRedisCacheKey

    SYNOPSIS
        Gets the accesskeys for the specified Azure Cache for Redis.


    SYNTAX
        Get-AzRedisCacheKey -Name <String> -ResourceGroupName <String> [<CommonParameters>]

    DESCRIPTION
        The Get-AzRedisCacheKey cmdlet gets the access keys for the specified cache.

    PARAMETERS
        -Name <String>
            Name of the Azure Cache for Redis.

        -ResourceGroupName <String>
            Name of the resource group for the cache.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

캐시에 대한 키를 검색하려면 Get-AzRedisCacheKey cmdlet을 호출하고 캐시 이름과 해당 캐시를 포함하는 리소스 그룹 이름을 전달합니다.

    PS C:\> Get-AzRedisCacheKey -Name myCache -ResourceGroupName myGroup

    PrimaryKey   : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
    SecondaryKey : ABhfB757JgjIgt785JgKH9865eifmekfnn649303JKL=

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

캐시에 대한 액세스 키를 다시 생성하려면 Get-AzRedisCacheKey cmdlet을 사용할 수 있습니다.

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

    PS C:\> Get-Help New-AzRedisCacheKey -detailed

    NAME
        New-AzRedisCacheKey

    SYNOPSIS
        Regenerates the access key of an Azure Cache for Redis.

    SYNTAX
        New-AzRedisCacheKey -Name <String> -ResourceGroupName <String> -KeyType <String> [-Force] [<CommonParameters>]

    DESCRIPTION
        The New-AzRedisCacheKey cmdlet regenerate the access key of an Azure Cache for Redis.

    PARAMETERS
        -Name <String>
            Name of the Azure Cache for Redis.

        -ResourceGroupName <String>
            Name of the resource group for the cache.

        -KeyType <String>
            Specifies whether to regenerate the primary or secondary access key. Possible values are Primary or Secondary.

        -Force
            When the Force parameter is provided, the specified access key is regenerated without any confirmation prompts.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

캐시에 대한 주 및 보조 키를 다시 생성하려면 New-AzRedisCacheKey cmdlet을 호출하고 이름, 리소스 그룹을 전달하고 KeyType 매개 변수에 대해 Primary 또는 Secondary를 지정합니다. 다음 예제에서는 캐시에 대한 보조 액세스 키가 다시 생성됩니다.

    PS C:\> New-AzRedisCacheKey -Name myCache -ResourceGroupName myGroup -KeyType Secondary

    Confirm
    Are you sure you want to regenerate Secondary key for Azure Cache for Redis 'myCache'?
    [Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): Y


    PrimaryKey   : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
    SecondaryKey : c53hj3kh4jhHjPJk8l0jji785JgKH9865eifmekfnn6=

Azure Cache for Redis를 삭제하려면

Azure Cache for Redis를 삭제하려면 Remove-AzRedisCache cmdlet을 사용합니다.

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

    PS C:\> Get-Help Remove-AzRedisCache -detailed

    NAME
        Remove-AzRedisCache

    SYNOPSIS
        Remove Azure Cache for Redis if exists.

    SYNTAX
        Remove-AzRedisCache -Name <String> -ResourceGroupName <String> [-Force] [-PassThru] [<CommonParameters>

    DESCRIPTION
        The Remove-AzRedisCache cmdlet removes an Azure Cache for Redis if it exists.

    PARAMETERS
        -Name <String>
            Name of the Azure Cache for Redis to remove.

        -ResourceGroupName <String>
            Name of the resource group of the cache to remove.

        -Force
            When the Force parameter is provided, the cache is removed without any confirmation prompts.

        -PassThru
            By default Remove-AzRedisCache removes the cache and does not return any value. If the PassThru par
            is provided then Remove-AzRedisCache returns a boolean value indicating the success of the operatio

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

다음 예제에서는 캐시 이름 myCache 가 제거됩니다.

    PS C:\> Remove-AzRedisCache -Name myCache -ResourceGroupName myGroup

    Confirm
    Are you sure you want to remove Azure Cache for Redis 'myCache'?
    [Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): Y

Azure Cache for Redis를 가져오려면

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

Important

가져오기/내보내기는 프리미엄 계층 캐시에만 사용할 수 있습니다. Import/Export에 대한 자세한 내용은 Azure Cache for Redis에서 데이터 가져오기 및 내보내기를 참조하세요.

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

    PS C:\> Get-Help Import-AzRedisCache -detailed

    NAME
        Import-AzRedisCache

    SYNOPSIS
        Import data from blobs to Azure Cache for Redis.


    SYNTAX
        Import-AzRedisCache -Name <String> -ResourceGroupName <String> -Files <String[]> [-Format <String>] [-Force]
        [-PassThru] [<CommonParameters>]


    DESCRIPTION
        The Import-AzRedisCache cmdlet imports data from the specified blobs into Azure Cache for Redis.


    PARAMETERS
        -Name <String>
            The name of the cache.

        -ResourceGroupName <String>
            The name of the resource group that contains the cache.

        -Files <String[]>
            SAS urls of blobs whose content should be imported into the cache.

        -Format <String>
            Format for the blob.  Currently "rdb" is the only supported, with other formats expected in the future.

        -Force
            When the Force parameter is provided, import will be performed without any confirmation prompts.

        -PassThru
            By default Import-AzRedisCache imports data in cache and does not return any value. If the PassThru
            parameter is provided then Import-AzRedisCache returns a boolean value indicating the success of the
            operation.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

다음 명령은 SAS URI가 지정한 Blob에서 Azure Cache for Redis에 데이터를 가져옵니다.

    PS C:\>Import-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -Files @("https://mystorageaccount.blob.core.windows.net/mycontainername/blobname?sv=2015-04-05&sr=b&sig=caIwutG2uDa0NZ8mjdNJdgOY8%2F8mhwRuGNdICU%2B0pI4%3D&st=2016-05-27T00%3A00%3A00Z&se=2016-05-28T00%3A00%3A00Z&sp=rwd") -Force

Azure Cache for Redis를 내보내려면

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

Important

가져오기/내보내기는 프리미엄 계층 캐시에만 사용할 수 있습니다. Import/Export에 대한 자세한 내용은 Azure Cache for Redis에서 데이터 가져오기 및 내보내기를 참조하세요.

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

    PS C:\> Get-Help Export-AzRedisCache -detailed

    NAME
        Export-AzRedisCache

    SYNOPSIS
        Exports data from Azure Cache for Redis to a specified container.


    SYNTAX
        Export-AzRedisCache -Name <String> -ResourceGroupName <String> -Prefix <String> -Container <String> [-Format
        <String>] [-PassThru] [<CommonParameters>]


    DESCRIPTION
        The Export-AzRedisCache cmdlet exports data from Azure Cache for Redis to a specified container.


    PARAMETERS
        -Name <String>
            The name of the cache.

        -ResourceGroupName <String>
            The name of the resource group that contains the cache.

        -Prefix <String>
            Prefix to use for blob names.

        -Container <String>
            SAS url of container where data should be exported.

        -Format <String>
            Format for the blob.  Currently "rdb" is the only supported, with other formats expected in the future.

        -PassThru
            By default Export-AzRedisCache does not return any value. If the PassThru parameter is provided
            then Export-AzRedisCache returns a boolean value indicating the success of the operation.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

다음 명령은 Azure Cache for Redis 인스턴스에서 SAS uri가 지정한 컨테이너로 데이터를 내보냅니다.

    PS C:\>Export-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -Prefix "blobprefix"
    -Container "https://mystorageaccount.blob.core.windows.net/mycontainer?sv=2015-04-05&sr=c&sig=HezZtBZ3DURmEGDduauE7
    pvETY4kqlPI8JCNa8ATmaw%3D&st=2016-05-27T00%3A00%3A00Z&se=2016-05-28T00%3A00%3A00Z&sp=rwdl"

Azure Cache for Redis를 다시 부팅하려면

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

Important

재부팅은 기본, 표준 및 프리미엄 계층 캐시에만 사용할 수 있습니다. 캐시를 재부팅하는 방법에 대한 자세한 내용은 캐시 관리 - 재부팅을 참조하세요.

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

    PS C:\> Get-Help Reset-AzRedisCache -detailed

    NAME
        Reset-AzRedisCache

    SYNOPSIS
        Reboot specified node(s) of an Azure Cache for Redis instance.


    SYNTAX
        Reset-AzRedisCache -Name <String> -ResourceGroupName <String> -RebootType <String> [-ShardId <Integer>]
        [-Force] [-PassThru] [<CommonParameters>]


    DESCRIPTION
        The Reset-AzRedisCache cmdlet reboots the specified node(s) of an Azure Cache for Redis instance.


    PARAMETERS
        -Name <String>
            The name of the cache.

        -ResourceGroupName <String>
            The name of the resource group that contains the cache.

        -RebootType <String>
            Which node to reboot. Possible values are "PrimaryNode", "SecondaryNode", "AllNodes".

        -ShardId <Integer>
            Which shard to reboot when rebooting a premium cache with clustering enabled.

        -Force
            When the Force parameter is provided, reset will be performed without any confirmation prompts.

        -PassThru
            By default Reset-AzRedisCache does not return any value. If the PassThru parameter is provided
            then Reset-AzRedisCache returns a boolean value indicating the success of the operation.

        <CommonParameters>
            This cmdlet supports the common parameters: Verbose, Debug,
            ErrorAction, ErrorVariable, WarningAction, WarningVariable,
            OutBuffer, PipelineVariable, and OutVariable. For more information, see
            about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

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

    PS C:\>Reset-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -RebootType "AllNodes"
    -Force

다음 단계

Azure에서 Windows PowerShell 사용에 대한 자세한 내용은 다음 리소스를 참조하십시오.