使用 Azure PowerShell 管理 Azure Redis

發行項
11/19/2024

Azure 受控 Redis

若要建立 Azure 受控 Redis （預覽）實例，請登入 Azure 入口網站，然後選取 [建立資源]。
在 [新增] 頁面上選取 [資料庫]，然後選取 [Azure Cache for Redis]。

在 [新的 Redis 快取] 頁面上，設定新快取的設定。

設定	選擇值	描述
訂用帳戶	下拉並選取您的訂用帳戶。	要在其中建立這個新 Azure 受控 Redis 實例的訂用帳戶。
資源群組	下拉並選取資源群組，或選取 [新建] 並輸入新的資源群組名稱。	用來建立快取和其他資源的資源群組名稱。將所有的應用程式資源放在一個資源群組中，您將可輕鬆地一併管理或刪除這些資源。
DNS 名稱	輸入區域中唯一的名稱。	當快取名稱與快取的區域名稱合併 (只包含數字、字母或連字號) 時，必須為介於 1 到 63 個字元之間的字串。（如果快取名稱長度少於 45 個字元，則應該適用於所有目前可用的區域。名稱必須以數位或字母開頭和結尾，且不能包含連續連字元。快取執行個體的主機名稱為 `\<DNS name\>.\<Azure region\>.redis.azure.net`。
地點	下拉並選取位置。	Azure 受控 Redis 可在選取的 Azure 區域中取得。
快取類型	下拉式清單並選取效能層級和快取大小。	層會決定 Redis 實例的效能，而快取大小會決定可用來儲存數據的記憶體。如需選擇正確效能層級的指引，請參閱 Chosing 正確的層級

顯示 [Azure 受控 Redis 基本] 索引標籤的螢幕快照。

選取 [下一步：網络] ，然後選取公用或私人端點。
選取 [下一步：進階]。在這裡，您可以設定任何要新增至實例的 Redis 模組。

將 [叢集原則] 設定為 [企業]，以用於非叢集快取，或設定為叢集快取的 OSS。 如需選擇 叢集原則的詳細資訊，請參閱叢集原則。

如果您使用 主動式異地複寫，則必須在建立期間加以設定。如需如何執行這項操作的指示，請參閱設定 Azure 受控 Redis 實例的作用中異地複寫。

重要

建立 Azure 受控 Redis 實例之後，您無法變更叢集原則。如果您使用 RediSearch，則需要企業叢集原則，而且 NoEviction 是唯一支援的收回原則。

重要

如果您在異地復寫群組中使用這個快取實例，在建立實例之後就無法變更收回原則。建立快取之前，請務必了解主要節點的收回原則。如需主動式異地復寫的詳細資訊，請參閱作用中異地復寫必要條件。

重要

建立快取實例之後，您無法變更模組。您必須在建立 Azure Cache for Redis 執行個體時啟用模組。建立快取之後，沒有選項可啟用模組的設定。
選取 [下一步：標記] 並略過。
完成時，選取 [下一步:檢閱 + 建立]。
檢閱設定並選取 [建立]。

建立 Redis 實例需要幾分鐘的時間。您可以在 Azure 受控 Redis 概觀頁面上監視進度。當 [狀態] 顯示為 [執行中] 時，表示快取已可供使用。

Azure Cache for Redis

若要建立快取，請登入 Azure 入口網站。在入口網站功能表中，選取 [建立資源]。
在 [開始使用] 窗格中，於搜尋列中輸入「Azure Cache for Redis」。在搜尋結果中，尋找「Azure Cache for Redis」，然後選取 [建立]。

在 [新增 Azure Cache for Redis] 窗格的 [基本] 索引標籤上，為您的快取設定下列設定：

設定	動作	描述
訂用帳戶	選取 Azure 訂閱。	用於建立新 Azure Cache for Redis 執行個體的訂用帳戶。
資源群組	選取資源群組，或選取 [新建] 並輸入新的資源群組名稱。	用來建立快取和其他資源的資源群組名稱。將所有的應用程式資源放在一個資源群組中，您將可輕鬆地一併管理或刪除這些資源。
DNS 名稱	輸入唯一名稱。	快取名稱必須是 1 到 63 個字元的字串，且只能包含數字、字母和連字號。名稱的開頭和結尾必須是數字或字母，且不可包含連續的連字號。快取執行個體的主機名稱為 `\<DNS name>.redis.cache.windows.net`。
地點	選取位置。	靠近使用您快取其他服務的 Azure 區域。
快取 SKU	選取 [SKU]。	快取的可用大小、效能和功能參數取決於 SKU。如需詳細資訊，請參閱 Azure Cache for Redis 概觀。
快取大小	選取快取大小。	如需詳細資訊，請參閱 Azure Cache for Redis 概觀。

選取 [網路] 索引標籤，或選取 [下一步: 網路]。
在 [網路] 索引標籤上，選取要用於快取的連線方法。
選取 [進階] 索引標籤，或選取 [下一步: 進階]。
在 [進階] 窗格中，根據下列資訊驗證或選取驗證方法：
- 根據預設，對於新的基本、標準或進階快取，會啟用 Microsoft Entra 驗證並停用存取金鑰驗證。
- 對於基本或標準快取，您可以選擇非 TLS 連接埠的選取項目。
- 對於標準和進階快取，您可以選擇啟用可用性區域。您無法在建立快取後停用可用性區域。
- 針對進階快取，設定適用於非 TLS 連接埠、叢集、受控識別和資料持續性的設定。
重要

為了獲得最佳安全性，建議您盡可能使用 Microsoft Entra ID 搭配受控識別來授權對快取的要求。使用 Microsoft Entra ID 和受控識別進行授權，提供比共用存取金鑰授權更優異的安全性和易用性。如需搭配快取使用受控識別的詳細資訊，請參閱使用 Microsoft Entra ID 進行快取驗證 (部分機器翻譯)。
(選用) 選取 [標籤] 索引標籤，或選取 [下一步: 標籤]。
(選用) 如果您想要分類快取資源，請在 [標籤] 索引標籤上輸入標籤名稱和值。
選取 [檢閱 + 建立] 按鈕。

在 [檢閱 + 建立] 索引標籤上，Azure 會自動驗證您的設定。
出現綠色的 [通過驗證] 訊息之後，請選取 [建立]。

新的快取部署會在幾分鐘內進行。您可以在 Azure Cache for Redis 概觀窗格上監視部署進度。當 [狀態] 顯示 [執行中] 時，表示快取已可供使用。

本文說明如何建立、更新及調整 Azure Redis 實例。

注意

Azure 有兩種不同的部署模型，可用來建立和處理資源：Azure Resource Manager 和傳統模型。本文涵蓋了 Resource Manager 部署模型的使用。建議您針對新部署使用 Resource Manager 部署模型，而不是傳統部署模型。

如需傳統部署模型的詳細資訊，請參閱 Azure Resource Manager 與傳統部署比較：了解資源的部署模型和狀態。

必要條件

如果您已安裝 Azure PowerShell，則必須有 Azure PowerShell 12.4.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

在使用 Windows PowerShell 搭配 Azure Resource Manager 之前，您需要驗證您的設定：

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-AzRedisEnterpriseCache Cmdlet 的說明，請輸入：

    Get-Help New-AzRedisEnterpriseCache -Detailed

如何連線到其他雲端

根據預設，Azure 環境是 AzureCloud，其代表全域 Azure 雲端執行個體。若要連線至不同的執行個體，請使用 Connect-AzAccount 命令搭配 -Environment 或使用 -EnvironmentName 命令列參數搭配所需的環境或環境名稱。

若要查看可用環境的清單，請執行 Get-AzEnvironment Cmdlet。

連線到 Azure Government 雲端

如果要連線到 Azure Government 雲端，請使用下列其中一個命令。

    Connect-AzAccount -EnvironmentName AzureUSGovernment

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

如果要在 Azure Government 雲端建立快取，請使用下列其中一個位置。

USGov Virginia
美國政府愛荷華州

如需 Azure Government 雲端的詳細資訊，請參閱 Microsoft Azure Government 和 Microsoft Azure Government 開發人員指南。

連線至由 21Vianet Cloud 營運的 Microsoft Azure

若要連線至由 21Vianet Cloud 營運的 Azure，請使用下列其中一個命令。

    Connect-AzAccount -EnvironmentName AzureChinaCloud

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

若要在由 21Vianet Cloud 營運的 Azure 中建立快取，請使用下列其中一個位置。

中國東部
中國北部

連線到 Microsoft Azure (德國)

若要連線到 Microsoft Azure (德國)，請使用下列其中一個命令。

    Connect-AzAccount -EnvironmentName AzureGermanCloud

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

若要在 Microsoft Azure (德國) 中建立快取，請使用下列其中一個位置。

德國中部
德國東北部

如需有關 Microsoft Azure (德國) 的詳細資訊，請參閱 Microsoft Azure (德國)。

Azure 受控 Redis PowerShell 參數和屬性

如需所有 Azure 受控 Redis PowerShell 參數和屬性的清單，請參閱 New-AzRedisEnterpriseCache。

建立 Azure 受控 Redis

新的 Azure 受控 Redis 實例是使用 New-AzRedisEnterpriseCache Cmdlet 來建立。

重要

第一次使用 Azure 入口網站在訂用帳戶中建立 Azure 受控 Redis 時，入口網站會註冊該訂用帳戶的Microsoft.Cache命名空間。如果您嘗試使用 PowerShell 在訂用帳戶中建立第一個 Azure 受控 Redis，您必須先使用下列命令註冊該命名空間：否則，例如 New-AzRedisEnterpriseCache 和 Get-AzRedisEnterpriseCache 的 Cmdlet 會失敗。

Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache"

若要查看 New-AzRedisEnterpriseCache的可用參數清單及其說明，請執行下列命令。

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

    NAME
        New-AzRedisEnterpriseCache

    SYNOPSIS
        Creates a new Azure Managed Redis.


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


    DESCRIPTION
        The New-AzRedisEnterpriseCache cmdlet creates a new Azure Managed Redis.


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

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

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

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

        -Sku <String>
            Sku of Azure Managed Redis.

        -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 Managed 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 Cluster Cache.

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

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

        -StaticIP <String>
            Required when deploying an Azure Managed 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-AzRedisEnterpriseCache -ResourceGroupName myGroup -Name mycache -Location "North Central US"

ResourceGroupName、Name 和 Location 是必要參數，其餘則為選用且有預設值。執行上述命令會建立具有指定名稱、位置和資源群組的 Azure 受控 Redis 實例。執行個體的大小為 1 GB，且未停用 SSL 連接連接埠。

若要啟用叢集，使用 ShardCount 參數指定分區計數。

若要指定 RedisConfiguration 參數的值，以索引鍵/值組的方式將值括在 {} 內，例如 @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}。下列範例會建立具有 maxmemory 原則和以 KEA設定之keyspace通知的1 GB快allkeys-random取。如需詳細資訊，請參閱 Keyspace 通知 (進階設定) 和記憶體原則。

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

在快取建立期間設定資料庫設定

databases 設定僅可以在快取建立期間設定。下列範例會使用 New-AzRedisEnterpriseCache Cmdlet 建立具有 48 個資料庫的快取。

    New-AzRedisEnterpriseCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku B1 -RedisConfiguration @{"databases" = "48"}

如需屬性的詳細資訊 databases ，請參閱預設 Azure 受控 Redis 伺服器組態。如需使用 New-AzRedisEnterpriseCache Cmdlet 建立快取的詳細資訊，請參閱上一個<若要建立 Azure 受控 Redis>一節。

更新 Azure 受控 Redis

Azure 受控 Redis 實例會使用 [Set-AzRedisEnterpriseCache] Cmdlet 來更新。

若要查看 Set-AzRedisEnterpriseCache的可用參數清單及其說明，請執行下列命令。

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

    NAME
        Set-AzRedisEnterpriseCache

    SYNOPSIS
        Set Azure Managed Redis updatable parameters.

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

    DESCRIPTION
        The Set-AzRedisEnterpriseCache cmdlet sets Azure Managed Redis parameters.

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

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

        -Sku <String>
            Sku of Azure Managed Redis.

        -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 Managed 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 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).

Set-AzRedisEnterpriseCache Cmdlet 可用來更新、和 RedisConfiguration 值等SkuEnableNonSslPort屬性。

下列命令會更新名為 myCache 的 Azure 受控 Redis maxmemory-policy。

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

取得 Azure 受控 Redis 的相關信息

您可以使用 Get-AzRedisEnterpriseCache Cmdlet 來擷取快取的相關信息。

若要查看 Get-AzRedisEnterpriseCache的可用參數清單及其說明，請執行下列命令。

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

    NAME
        Get-AzRedisEnterpriseCache

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

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

    DESCRIPTION
        The Get-AzRedisEnterpriseCache cmdlet gets the details about a cache or caches depending on input parameters. If both
        ResourceGroupName and Name parameters are provided then Get-AzRedisEnterpriseCache 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-AzRedisEnterpriseCache
            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-AzRedisEnterpriseCache 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-AzRedisEnterpriseCache。

    Get-AzRedisEnterpriseCache

若要傳回特定資源群組中所有快取的相關資訊，請執行 Get-AzRedisEnterpriseCache 並使用 ResourceGroupName 參數。

    Get-AzRedisEnterpriseCache -ResourceGroupName myGroup

若要傳回特定快取的相關資訊，請執行 Get-AzRedisEnterpriseCache，並使用 Name 參數包含快取名稱，和 ResourceGroupName 參數包含快取的資源群組。

    PS C:\> Get-AzRedisEnterpriseCache -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               : 10000
    ProvisioningState  : Succeeded
    SslPort            : 6380
    RedisConfiguration : {[maxmemory-policy, volatile-lru], [maxmemory-reserved, 62], [notify-keyspace-events, KEA],
                         [maxclients, 1000]...}
    EnableNonSslPort   : False
    RedisVersion       : 3.0
    Sku                : B1
    ResourceGroupName  : myGroup
    VirtualNetwork     :
    Subnet             :
    StaticIP           :
    TenantSettings     : {}
    ShardCount         :

擷取 Azure 受控 Redis 的存取密鑰

若要擷取快取的存取密鑰，您可以使用 Get-AzRedisEnterpriseCacheKey Cmdlet。

若要查看 Get-AzRedisEnterpriseCacheKey的可用參數清單及其說明，請執行下列命令。

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

    NAME
        Get-AzRedisEnterpriseCacheKey

    SYNOPSIS
        Gets the accesskeys for the specified Azure Managed Redis.


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

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

    PARAMETERS
        -Name <String>
            Name of the Azure Managed 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-AzRedisEnterpriseCacheKey Cmdlet，並傳入快取的名稱以及包含快取的資源群組名稱。

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

    PrimaryKey   : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
    SecondaryKey : ABhfB757JgjIgt785JgKH9865eifmekfnn649303JKL=

重新產生 Azure 受控 Redis 的存取金鑰

若要重新產生快取的存取密鑰，您可以使用 New-AzRedisEnterpriseCacheKey Cmdlet。

若要查看 New-AzRedisEnterpriseCacheKey的可用參數清單及其說明，請執行下列命令。

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

    NAME
        New-AzRedisEnterpriseCacheKey

    SYNOPSIS
        Regenerates the access key of an Azure Managed Redis.

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

    DESCRIPTION
        The New-AzRedisEnterpriseCacheKey cmdlet regenerate the access key of an Azure Managed Redis.

    PARAMETERS
        -Name <String>
            Name of the Azure Managed 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-AzRedisEnterpriseCacheKey Cmdlet，並傳入名稱、資源群組，且針對 KeyType 參數指定 Primary 或 Secondary。在下列範例中，會重新產生快取的次要存取金鑰。

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

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


    PrimaryKey   : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
    SecondaryKey : c53hj3kh4jhHjPJk8l0jji785JgKH9865eifmekfnn6=

刪除 Azure 受控 Redis

若要刪除 Azure 受控 Redis，請使用 Remove-AzRedisEnterpriseCache Cmdlet。

若要查看 Remove-AzRedisEnterpriseCache的可用參數清單及其說明，請執行下列命令。

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

    NAME
        Remove-AzRedisEnterpriseCache

    SYNOPSIS
        Remove Azure Managed Redis if exists.

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

    DESCRIPTION
        The Remove-AzRedisEnterpriseCache cmdlet removes an Azure Managed Redis if it exists.

    PARAMETERS
        -Name <String>
            Name of the Azure Managed 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-AzRedisEnterpriseCache removes the cache and does not return any value. If the PassThru par
            is provided then Remove-AzRedisEnterpriseCache 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-AzRedisEnterpriseCache -Name myCache -ResourceGroupName myGroup

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

匯入 Azure 受控 Redis

您可以使用 Cmdlet 將數據匯入 Azure 受控 Redis 實例 Import-AzRedisEnterpriseCache 。

若要查看 Import-AzRedisEnterpriseCache的可用參數清單及其說明，請執行下列命令。

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

    NAME
        Import-AzRedisEnterpriseCache

    SYNOPSIS
        Import data from blobs to Azure Managed Redis.


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


    DESCRIPTION
        The Import-AzRedisEnterpriseCache cmdlet imports data from the specified blobs into Azure Managed 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-AzRedisEnterpriseCache imports data in cache and does not return any value. If the PassThru
            parameter is provided then Import-AzRedisEnterpriseCache 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 受控 Redis。

    PS C:\>Import-AzRedisEnterpriseCache -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 受控 Redis

您可以使用 Cmdlet 從 Azure 受控 Redis 實例 Export-AzRedisEnterpriseCache 導出數據。

若要查看 Export-AzRedisEnterpriseCache的可用參數清單及其說明，請執行下列命令。

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

    NAME
        Export-AzRedisEnterpriseCache

    SYNOPSIS
        Exports data from Azure Managed Redis to a specified container.


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


    DESCRIPTION
        The Export-AzRedisEnterpriseCache cmdlet exports data from Azure Managed 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-AzRedisEnterpriseCache does not return any value. If the PassThru parameter is provided
            then Export-AzRedisEnterpriseCache 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 受控 Redis 實例的數據匯出至 SAS URI 所指定的容器。

    PS C:\>Export-AzRedisEnterpriseCache -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 受控 Redis （預覽版）

您可以使用 Cmdlet 將 Azure 受控 Redis 實例 Reset-AzRedisEnterpriseCache 重新啟動。

若要查看 Reset-AzRedisEnterpriseCache的可用參數清單及其說明，請執行下列命令。

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

    NAME
        Reset-AzRedisEnterpriseCache

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


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


    DESCRIPTION
        The Reset-AzRedisEnterpriseCache cmdlet reboots the specified node(s) of an Azure Managed 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 cache with clustering enabled.

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

        -PassThru
            By default Reset-AzRedisEnterpriseCache does not return any value. If the PassThru parameter is provided
            then Reset-AzRedisEnterpriseCache 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-AzRedisEnterpriseCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -RebootType "AllNodes"
    -Force

注意

如需傳統部署模型的詳細資訊，請參閱 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

在使用 Windows PowerShell 搭配 Azure Resource Manager 之前，您需要驗證您的設定：

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

如何連線到其他雲端

若要查看可用環境的清單，請執行 Get-AzEnvironment Cmdlet。

連線到 Azure Government 雲端

如果要連線到 Azure Government 雲端，請使用下列其中一個命令。

    Connect-AzAccount -EnvironmentName AzureUSGovernment

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

如果要在 Azure Government 雲端建立快取，請使用下列其中一個位置。

USGov Virginia
美國政府愛荷華州

如需 Azure Government 雲端的詳細資訊，請參閱 Microsoft Azure Government 和 Microsoft Azure Government 開發人員指南。

連線至由 21Vianet Cloud 營運的 Microsoft Azure

若要連線至由 21Vianet Cloud 營運的 Azure，請使用下列其中一個命令。

    Connect-AzAccount -EnvironmentName AzureChinaCloud

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

若要在由 21Vianet Cloud 營運的 Azure 中建立快取，請使用下列其中一個位置。

中國東部
中國北部

連線到 Microsoft Azure (德國)

若要連線到 Microsoft Azure (德國)，請使用下列其中一個命令。

    Connect-AzAccount -EnvironmentName AzureGermanCloud

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

若要在 Microsoft Azure (德國) 中建立快取，請使用下列其中一個位置。

德國中部
德國東北部

如需有關 Microsoft Azure (德國) 的詳細資訊，請參閱 Microsoft Azure (德國)。

用於 Azure Cache for Redis PowerShell 的屬性

下表包含建立和管理您的 Azure Cache for Redis 執行個體時常用參數的 Azure PowerShell 屬性和描述。

參數	描述	預設
名稱	快取的名稱
Location	快取的位置
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。有效值為：Basic、Standard、Premium	標準
RedisConfiguration	指定 Redis 組態設定。如需每個設定的詳細資訊，請參閱以下的 RedisConfiguration 屬性表格。
EnableNonSslPort	指出是否已啟用非 SSL 連接埠。	False
MaxMemoryPolicy	這個參數已被取代，請改用 RedisConfiguration。
StaticIP	當快取是裝載在 VNET 中，為快取在子網路中指定唯一 IP 位址。如果未提供，則會從子網路中為您選擇一個。
子網路	當快取是裝載在 VNET 中，指定要在其中部署快取的子網路。
VirtualNetwork	當快取是裝載在 VNET 中，指定要在其中部署快取的 VNET 之資源識別碼。
KeyType	指定更新存取金鑰時要重新產生哪一個存取金鑰。有效值為：Primary、Secondary

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	設定小型彙總資料類型的記憶體最佳化	標準和進階
資料庫	設定資料庫數目。這個屬性僅可以在建立快取時設定。	標準和進階

建立 Azure Cache for Redis

建立新的「Azure Redis 快取」執行個體時，會使用 New-AzRedisCache Cmdlet 來建立。

重要

您第一次使用 Azure 入口網站在訂用帳戶中建立 Azure Cache for Redis 時，入口網站會為該訂用帳戶註冊 Microsoft.Cache 命名空間。如果您嘗試使用 PowerShell 在訂用帳戶中建立第一個 Azure Cache for Redis，您必須先使用下列命令註冊該命名空間；否則 Cmdlet (例如 New-AzRedisCache 和 Get-AzRedisCache) 會失敗。

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 執行個體。執行個體的大小為 1 GB，且未停用 SSL 連接連接埠。

若要建立進階快取，請指定大小為 P1 (6 GB - 60 GB)、P2 (13 GB - 130 GB)、P3 (26 GB - 260 GB) 或 P4 (53 GB - 530 GB)。若要啟用叢集，使用 ShardCount 參數指定分區計數。下列範例會建立具有三個分區的 P1 進階快取。 P1 進階快取的大小為 6 GB，因為我們指定三個分區，大小總計為 18 GB (3 x 6 GB)。

    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"}。下列範例會建立標準 1 GB 快取，具有 allkeys-random maxmemory 原則，且 keyspace 通知設為 KEA。如需詳細資訊，請參閱 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 (26 GB) 快取。

    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 Redis 快取＞一節。

更新 Azure Cache for Redis

更新「Azure Redis 快取」執行個體時，會使用 Set-AzRedisCache Cmdlet 來更新。

若要查看 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).

Set-AzRedisCache Cmdlet 可用來更新屬性，例如 Size、Sku、EnableNonSslPort 和 RedisConfiguration 的值。

下列命令會更新名為 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 屬性時，可使用 Set-AzRedisCache 來調整 Azure Cache for Redis 執行個體。

注意

使用 PowerShell 調整快取，和從 Azure 入口網站調整快取有相同的限制和準則。您可以調整具有下列限制的不同定價層。

您無法從較高的定價層調整至較低的定價層。
您無法從進階快取向下調整至標準或基本快取。
您無法從標準快取向下調整到基本快取。
您可以從基本快取調整到標準快取，但您無法同時變更大小。如果您需要不同的大小，您可以進行後續調整作業，調整到您需要的大小。
您無法直接從基本快取調整至進階快取。您必須在單一調整作業中從基本調整至標準，然後在後續的調整作業中從標準調整至進階。
您無法從較大的大小向下調整至 C0 (250 MB) 的大小。

如需詳細資訊，請參閱如何調整 Azure Cache for Redis。

下列範例示範如何將名為 myCache 的快取縮放為 2.5 GB 快取。此命令可同時用於基本或標準快取。

    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

若要傳回特定資源群組中所有快取的相關資訊，請執行 Get-AzRedisCache 並使用 ResourceGroupName 參數。

    Get-AzRedisCache -ResourceGroupName myGroup

若要傳回特定快取的相關資訊，請執行 Get-AzRedisCache，並使用 Name 參數包含快取名稱，和 ResourceGroupName 參數包含快取的資源群組。

    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 的存取金鑰

若要重新產生您快取的存取金鑰，您可以使用 New-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 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 執行個體中。

重要

匯入/匯出僅供進階層快取使用。如需匯入/匯出的詳細資訊，請參閱在 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 執行個體匯出資料。

重要

匯入/匯出僅供進階層快取使用。如需匯入/匯出的詳細資訊，請參閱在 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 執行個體重新啟動。

重要

重新啟動僅適用於基本、標準和進階層快取。如需重新啟動快取的詳細資訊，請參閱快取管理 - 重新啟動。

若要查看 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

下一步

若要深入了解如何將 Windows PowerShell 與 Azure 搭配使用，請參閱下列資源：

MSDN 上的 Azure Cache for Redis Cmdlet 文件
Azure Resource Manager Cmdlet：了解如何使用 Azure Resource Manager 模組中的 Cmdlet。
使用資源群組管理 Azure 資源：了解如何在 Azure 入口網站中建立和管理資源群組。
Azure 部落格：深入了解 Azure 的新功能。
Windows PowerShell 部落格：深入了解 Windows PowerShell 的新功能。
"Hey, Scripting Guy!"部落格：從 Windows PowerShell 社群中取得實際的秘訣及訣竅。

共用方式為

使用 Azure PowerShell 管理 Azure Redis

Azure 受控 Redis

Azure Cache for Redis

必要條件

如何連線到其他雲端

連線到 Azure Government 雲端

連線至由 21Vianet Cloud 營運的 Microsoft Azure

連線到 Microsoft Azure (德國)

Azure 受控 Redis PowerShell 參數和屬性

建立 Azure 受控 Redis

在快取建立期間設定資料庫設定

更新 Azure 受控 Redis

取得 Azure 受控 Redis 的相關信息

擷取 Azure 受控 Redis 的存取密鑰

重新產生 Azure 受控 Redis 的存取金鑰

刪除 Azure 受控 Redis

匯入 Azure 受控 Redis

匯出 Azure 受控 Redis

重新啟動 Azure 受控 Redis （預覽版）

必要條件

如何連線到其他雲端

連線到 Azure Government 雲端

連線至由 21Vianet Cloud 營運的 Microsoft Azure

連線到 Microsoft Azure (德國)

用於 Azure Cache for Redis PowerShell 的屬性

RedisConfiguration 屬性

建立 Azure Cache for Redis

在快取建立期間設定資料庫設定

更新 Azure Cache for Redis

調整 Azure Cache for Redis

取得 Azure Cache for Redis 的相關資訊

擷取 Azure Cache for Redis 的存取金鑰

重新產生 Azure Cache for Redis 的存取金鑰

刪除 Azure Cache for Redis

匯入 Azure Cache for Redis

匯出 Azure Cache for Redis

重新啟動 Azure Cache for Redis

下一步

意見反應

其他資源