使用 Azure PowerShell 管理 Azure Redis

使用 New-AzRedisEnterpriseCache cmdlet 创建新的 Azure 托管 Redis 实例。 ResourceGroupName、 Name、 Location和 Sku 必需参数。 其他参数是可选的，并且具有默认值。

默认情况下，Microsoft Entra 身份验证功能已为所有新缓存启用，建议使用以增强安全性。

有关 New-AzRedisEnterpriseCache 的所有 Azure Managed Redis PowerShell 参数和属性，请参阅 New-AzRedisEnterpriseCache。 若要输出可用参数的列表及其说明，请运行以下命令。

Get-Help New-AzRedisEnterpriseCache -detailed

以下示例命令使用默认参数创建具有指定名称、位置、资源组和 SKU 的 Azure 托管 Redis 实例。 实例的大小为 1 GB，且禁用了非 SSL 端口。

New-AzRedisEnterpriseCache -ResourceGroupName myGroup -Name mycache -Location "China North" -Sku Balanced_B1

可以使用 New-AzRedisEnterpriseCacheDatabase cmdlet 为 Azure 托管 Redis 缓存创建和配置数据库。 若要查看 New-AzRedisEnterpriseCacheDatabase的可用参数列表及其说明，请运行以下命令。

Get-Help New-AzRedisEnterpriseCacheDatabase -detailed

如果在创建缓存期间未配置数据库， 则 New-AzRedisEnterpriseCache 会在默认命名 default 的缓存中创建一个数据库，并且所有缓存数据都会进入此 DB 0 数据库。

可以使用 Update-AzRedisEnterpriseCache cmdlet 更新 Azure 托管 Redis 实例。 若要查看 Update-AzRedisEnterpriseCache的可用参数列表及其说明，请运行以下命令。

Get-Help Update-AzRedisEnterpriseCache -detailed

可以使用 Update-AzRedisEnterpriseCache cmdlet 更新属性，例如 Sku， Tag和 MinimumTlsVersion。 以下命令更新最低传输层安全性（TLS）版本，并将一个标记添加到名为myCache的 Azure 托管 Redis 缓存。

Update-AzRedisEnterpriseCache -Name "myCache" -ResourceGroupName "myGroup" -MinimumTlsVersion "1.2" -Tag @{"tag1" = "value1"}

可以使用 Get-AzRedisEnterpriseCache cmdlet 检索有关缓存的信息。 若要查看 Get-AzRedisEnterpriseCache的可用参数列表及其说明，请运行以下命令。

Get-Help Get-AzRedisEnterpriseCache -detailed

若要返回当前订阅中所有缓存的相关信息，请运行不带任何参数的 Get-AzRedisEnterpriseCache。

Get-AzRedisEnterpriseCache

若要返回特定资源组中所有缓存的相关信息，请结合 Get-AzRedisEnterpriseCache 参数运行 ResourceGroupName。

Get-AzRedisEnterpriseCache -ResourceGroupName myGroup

若要返回有关特定缓存的信息，请使用缓存的 Get-AzRedisEnterpriseCache 和 Name 运行 ResourceGroupName。

Get-AzRedisEnterpriseCache -Name myCache -ResourceGroupName myGroup

若要检索缓存的访问密钥，请使用 Get-AzRedisEnterpriseCacheKey cmdlet。 若要查看 Get-AzRedisEnterpriseCacheKey的可用参数列表及其说明，请运行以下命令。

Get-Help Get-AzRedisEnterpriseCacheKey -detailed

若要检索缓存的密钥，请使用缓存的 Get-AzRedisEnterpriseCacheKey 和 Name 调用 ResourceGroupName cmdlet。

Get-AzRedisEnterpriseCacheKey -Name myCache -ResourceGroupName myGroup

若要重新生成缓存的访问密钥，可以使用 New-AzRedisEnterpriseCacheKey cmdlet。 若要查看 New-AzRedisEnterpriseCacheKey的可用参数列表及其说明，请运行以下命令。

Get-Help New-AzRedisEnterpriseCacheKey -detailed

若要为缓存重新生成主密钥或辅助密钥，请调用 New-AzRedisEnterpriseCacheKey cmdlet，并使用缓存Name和ResourceGroupName，在Primary参数中指定Secondary或KeyType。 以下示例重新生成缓存的辅助访问密钥。

New-AzRedisEnterpriseCacheKey -Name myCache -ResourceGroupName myGroup -KeyType Secondary

若要删除 Azure 托管 Redis 缓存，请使用 Remove-AzRedisEnterpriseCache cmdlet。 若要查看 Remove-AzRedisEnterpriseCache的可用参数列表及其说明，请运行以下命令。

Get-Help Remove-AzRedisEnterpriseCache -detailed

以下示例删除名为 myCache 的缓存。

Remove-AzRedisEnterpriseCache -Name myCache -ResourceGroupName myGroup

可以使用 Import-AzRedisEnterpriseCache cmdlet 将数据导入 Azure 托管 Redis 实例。 若要查看 Import-AzRedisEnterpriseCache的可用参数列表及其说明，请运行以下命令。

Get-Help Import-AzRedisEnterpriseCache -detailed

需要缓存 Name 和 ResourceGroupName 以及要导入的 blob 的 SasUri。 以下命令从 SAS URI 指定的 Blob 导入数据。

Import-AzRedisEnterpriseCache -ClusterName "myCache" -ResourceGroupName "myGroup" -SasUri @("<sas-uri>")

可以使用 Export-AzRedisEnterpriseCache cmdlet 将数据从 Azure 托管 Redis 实例导出。 若要查看 Export-AzRedisEnterpriseCache的可用参数列表及其说明，请运行以下命令。

Get-Help Export-AzRedisEnterpriseCache -detailed

需要缓存 Name 和 ResourceGroupName 以及要导出的容器的 SasUri。 以下示例命令从 SAS URI 指定的容器导出数据。

Export-AzRedisEnterpriseCache -Name "myCache" -ResourceGroupName "myGroup" -SasUri "https://mystorageaccount.blob.core.chinacloudapi.cn/mycontainer?sp=signedPermissions&se=signedExpiry&sv=signedVersion&sr=signedResource&sig=signature;mystoragekey"

下表显示了常见 Azure Redis 缓存参数的 Azure PowerShell 属性和说明。 有关所有 Azure PowerShell 参数和属性 Az.RedisCache，请参阅 AzRedisCache。

使用 New-AzRedisCache cmdlet 创建新的 Azure Redis 缓存实例。 ResourceGroupName、 Name和 Location 必需参数。 其他参数是可选的，并且具有默认值。

若要查看 New-AzRedisCache 的可用参数及其说明的列表，请运行以下命令：

Get-Help New-AzRedisCache -detailed>

以下示例命令使用默认参数创建具有指定名称、位置和资源组的 Azure Redis 缓存实例。 该实例是禁用非 SSL 端口的标准 1 GB 缓存。

    New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "China North"

若要指定 RedisConfiguration 参数的值，请将键值对括在大括号 {}中。 以下示例使用 @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"} 创建一个 1-GB 缓存。 有关详细信息，请参阅密钥空间通知（高级设置）以及内存策略。

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

若要创建 Azure Redis 缓存高级层缓存，请指定大小 P1 （6-60 GB）、（13-130 GB）、 P2P3 （26-260 GB）或 P4 （53-530 GB）。 若要启用群集，使用 ShardCount 参数指定分片计数。

以下示例创建包含三个分片的 P1 Premium 缓存。 P1 高级缓存大小为 6 GB，具有三个分片，总大小为 18 GB（3 x 6 GB）。

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

databases New-AzRedisCache cmdlet 中的设置配置缓存中的数据库数。 您只能在创建缓存期间使用 PowerShell 或其他管理客户端为标准层和高级层配置 databases。

如果在创建缓存期间未指定 databases 设置， 则 New-AzRedisCache 会创建一个名为 default的数据库，并且所有缓存数据都会进入此 DB 0 数据库。 数据库限制取决于缓存层和大小，但默认设置为 16。

以下示例创建包含 48 个数据库的高级 P3（26 GB）缓存。

New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "China North" -Sku Premium -Size P3 -RedisConfiguration @{"databases" = "48"}

有关 databases 属性的详细信息，请参阅默认 Azure Redis 缓存服务器配置。

使用 Set-AzRedisCache cmdlet 更新 Azure Redis 缓存实例。 若要查看 Set-AzRedisCache的可用参数列表及其说明，请运行以下命令。

Get-Help Set-AzRedisCache -detailed

可以使用 Set-AzRedisCache cmdlet 更新属性，例如Size，Sku，EnableNonSslPort，以及RedisConfiguration值。 以下示例命令更新名为 maxmemory-policy 的 Azure Cache for Redis 实例的 myCache。

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

当您修改Set-AzRedisCache、Size或Sku属性时，可以使用ShardCount来缩放 Azure Redis 缓存实例。

以下示例演示如何缩放名为 myCache 2.5 GB 大小的缓存。 此命令适用于基本或标准缓存。

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

发出此命令后，将返回缓存的状态，类似于调用 Get-AzRedisCache。 ProvisioningState 设置为 Scaling。

缩放操作完成后，ProvisioningState 更改为 Succeeded。 如果需要执行另一个操作，例如在从“基本”更改为“标准”后调整大小，则必须等到前一操作完成。 否则，会收到类似于以下消息的错误。

Set-AzRedisCache : Conflict: The resource '...' is not in a stable state, and is currently unable to accept the update request.

可以使用 Get-AzRedisCache cmdlet 检索有关缓存的信息。 若要查看 Get-AzRedisCache的可用参数列表及其说明，请运行以下命令。

Get-Help Get-AzRedisCache -detailed

若要返回当前订阅中所有缓存的相关信息，请运行不带任何参数的 Get-AzRedisCache。

Get-AzRedisCache

若要返回特定资源组中所有缓存的相关信息，请结合 Get-AzRedisCache 参数运行 ResourceGroupName。

Get-AzRedisCache -ResourceGroupName myGroup

若要返回有关特定缓存的信息，请运行命令 Get-AzRedisCache 并使用缓存参数 Name 和 ResourceGroupName.

Get-AzRedisCache -Name myCache -ResourceGroupName myGroup

若要检索缓存的访问密钥，可以使用 Get-AzRedisCacheKey cmdlet。 若要查看 Get-AzRedisCacheKey的可用参数列表及其说明，请运行以下命令。

Get-Help Get-AzRedisCacheKey -detailed

若要检索缓存的密钥，请使用缓存 Get-AzRedisCacheKey 和 Name 调用 ResourceGroupName cmdlet。

Get-AzRedisCacheKey -Name myCache -ResourceGroupName myGroup

若要重新生成缓存的访问密钥，可以使用 New-AzRedisCacheKey cmdlet。 若要查看 New-AzRedisCacheKey的可用参数列表及其说明，请运行以下命令。

Get-Help New-AzRedisCacheKey -detailed

若要为缓存重新生成主密钥或辅助密钥，请调用 New-AzRedisCacheKey cmdlet，并使用缓存Name和ResourceGroupName，在Primary参数中指定Secondary或KeyType。 以下示例重新生成缓存的辅助访问密钥。

New-AzRedisCacheKey -Name myCache -ResourceGroupName myGroup -KeyType Secondary

若要删除 Azure Redis 缓存，请使用 Remove-AzRedisCache cmdlet。 若要查看 Remove-AzRedisCache的可用参数列表及其说明，请运行以下命令。

Get-Help Remove-AzRedisCache -detailed

以下示例删除名为 myCache 的缓存。

Remove-AzRedisCache -Name myCache -ResourceGroupName myGroup

可以使用 Import-AzRedisCache cmdlet 将数据导入 Azure Redis 缓存实例。

若要查看 Import-AzRedisCache的可用参数列表及其说明，请运行以下命令。

Get-Help Import-AzRedisCache -detailed

以下命令将数据从参数指定的 Files Blob 导入 Azure Redis 缓存中。

Import-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -Files @("https://mystorageaccount.blob.core.chinacloudapi.cn/mycontainername/blobname?sv=signedVersion&sr=signedResource&sig=signature&st=signTime&se=signedExpiry&sp=signedPermissions") -Force

可以使用 Export-AzRedisCache cmdlet 将数据从 Azure Redis 缓存实例导出。

若要查看 Export-AzRedisCache的可用参数列表及其说明，请运行以下命令。

Get-Help Export-AzRedisCache -detailed

以下命令将数据从 Azure Cache for Redis 实例导出到参数指定的 Container 容器中。

Export-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -Prefix "blobprefix" -Container "https://mystorageaccount.blob.core.chinacloudapi.cn/mycontainer?sv=signedResource&sig=signature&st=signTime&se=signedExpiry&sp=signedPermissions"

可以使用 Reset-AzRedisCache cmdlet 重启 Azure Redis 缓存实例。

若要查看 Reset-AzRedisCache的可用参数列表及其说明，请运行以下命令。

Get-Help Reset-AzRedisCache -detailed

以下命令重新启动指定缓存的两个节点。

Reset-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -RebootType "AllNodes" -Force

Get-Module Az | format-table version

Connect-AzAccount -Environment AzureChinaCloud

Get-AzSubscription | sort SubscriptionName | Select SubscriptionName

Select-AzSubscription -SubscriptionName ContosoSubscription

Get-Help <cmdlet-name> -Detailed