You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/redis/how-to-manage-redis-cache-powershell.md
+21-7Lines changed: 21 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -37,6 +37,11 @@ This article shows you how to create, manage, and delete your Azure Redis instan
37
37
38
38
You create new Azure Managed Redis instances using the [New-AzRedisEnterpriseCache](/powershell/module/az.redisenterprisecache/new-AzRedisEnterpriseCache) cmdlet. `ResourceGroupName`, `Name`, `Location`, and `Sku` are required parameters. The other parameters are optional and have default values.
39
39
40
+
Microsoft Entra authentication is enabled by default for all new caches and is recommended for security.
41
+
42
+
>[!IMPORTANT]
43
+
>Use Microsoft Entra ID with managed identities to authorize requests against your cache if possible. Authorization using Microsoft Entra ID and managed identity provides better security and is easier to use than shared access key authorization. For more information about using managed identities with your cache, see [Use Microsoft Entra for cache authentication with Azure Managed Redis](entra-for-authentication.md).
44
+
40
45
For all Azure Managed Redis PowerShell parameters and properties for `New-AzRedisEnterpriseCache`, see [New-AzRedisEnterpriseCache](/powershell/module/az.redisenterprisecache/new-azredisenterprisecache). To output a list of available parameters and their descriptions, run the following command.
41
46
42
47
```azurepowershell
@@ -245,8 +250,19 @@ The following tables show Azure PowerShell properties and descriptions for commo
245
250
246
251
You create new Azure Cache for Redis instances using the [New-AzRedisCache](/powershell/module/az.rediscache/new-AzRedisCache) cmdlet. `ResourceGroupName`, `Name`, and `Location` are required parameters. The other parameters are optional and have default values.
247
252
248
-
> [!NOTE]
249
-
> The first time you create an Azure Cache for Redis cache in a subscription, Azure registers the `Microsoft.Cache` namespace for you. If prompted, you can use the Azure PowerShell `Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache"` command to register the namespace.
253
+
>[!IMPORTANT]
254
+
>Microsoft Entra authentication is recommended for security. You can enable Microsoft Entra Authentication during or after cache creation.
255
+
>
256
+
>Use Microsoft Entra ID with managed identities to authorize requests against your cache if possible. Authorization using Microsoft Entra ID and managed identity provides better security and is easier to use than shared access key authorization. For more information about using managed identities with your cache, see [Use Microsoft Entra ID for cache authentication](../azure-cache-for-redis/cache-azure-active-directory-for-authentication.md).
257
+
258
+
To see a list of available parameters and their descriptions for [New-AzRedisCache](/powershell/module/az.rediscache/new-AzRedisCache), run the following command:
259
+
260
+
```azurepowershell
261
+
Get-Help New-AzRedisCache -detailed>
262
+
```
263
+
264
+
>[!NOTE]
265
+
>The first time you create an Azure Cache for Redis cache in a subscription, Azure registers the `Microsoft.Cache` namespace for you. If prompted, you can use the Azure PowerShell `Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache"` command to register the namespace.
250
266
251
267
The following example command creates an Azure Cache for Redis instance with the specified name, location, and resource group, using default parameters. The instance is a Standard 1-GB cache with the non-SSL port disabled.
The `databases` setting in the [New-AzRedisCache](/powershell/module/az.rediscache/New-azRedisCache) cmdlet configures the number of databases in the cache. You can configure this setting only during Standard and Premium cache creation using PowerShell, Azure CLI, or other management clients.
277
293
278
-
If you don't specify a `databases` setting during cache creation, [New-AzRedisCache](/powershell/module/az.RedisCache/New-AzRedisCache) creates one database named `default`, and all cache data goes into this DB 0 database. The database limit depends on cache tier and size, but the default setting is 16.
294
+
If you don't specify a `databases` setting during cache creation, [New-AzRedisCache](/powershell/module/az.RedisCache/New-AzRedisCache) creates one database named `default`, and all cache data goes into this `DB 0` database. The database limit depends on cache tier and size, but the default setting is 16.
279
295
280
296
The following example creates a premium P3 (26 GB) cache with 48 databases.
281
297
@@ -368,7 +384,6 @@ To see a list of available parameters and their descriptions for `Get-AzRedisCac
368
384
369
385
```azurepowershell
370
386
Get-Help Get-AzRedisCacheKey -detailed
371
-
372
387
```
373
388
374
389
To retrieve the keys for your cache, call the `Get-AzRedisCacheKey` cmdlet with the cache `Name` and `ResourceGroupName`.
@@ -388,7 +403,6 @@ To see a list of available parameters and their descriptions for `New-AzRedisCac
388
403
389
404
```azurepowershell
390
405
Get-Help New-AzRedisCacheKey -detailed
391
-
392
406
```
393
407
394
408
To regenerate the primary or secondary key for your cache, call the `New-AzRedisCacheKey` cmdlet with the cache `Name` and `ResourceGroupName`, and specify either `Primary` or `Secondary` for the `KeyType` parameter. The following example regenerates the secondary access key for a cache.
You can import data into an Azure Cache for Redis instance using the `Import-AzRedisCache` cmdlet.
420
434
421
435
> [!IMPORTANT]
422
-
> Import is available only for [Premium tier]/azure-cache-for-redis/cache-overview.md#service-tiers) caches. For more information, see [Import and export data in Azure Cache for Redis](../azure-cache-for-redis/cache-how-to-import-export-data.md).
436
+
> Import is available only for [Premium tier](../azure-cache-for-redis/cache-overview.md#service-tiers) caches. For more information, see [Import and export data in Azure Cache for Redis](../azure-cache-for-redis/cache-how-to-import-export-data.md).
423
437
424
438
To see a list of available parameters and their descriptions for `Import-AzRedisCache`, run the following command.
425
439
@@ -461,7 +475,7 @@ The following command exports data from an Azure Cache for Redis instance into t
461
475
You can reboot your Azure Cache for Redis instance using the `Reset-AzRedisCache` cmdlet.
462
476
463
477
> [!IMPORTANT]
464
-
> Reboot is only available for [Basic, Standard, and Premium tier]/azure-cache-for-redis/cache-overview.md#service-tiers) Azure Cache for Redis caches. For more information, see [Cache administration - reboot](../azure-cache-for-redis/cache-administration.md#reboot).
478
+
> Reboot is only available for [Basic, Standard, and Premium tier](../azure-cache-for-redis/cache-overview.md#service-tiers) Azure Cache for Redis caches. For more information, see [Cache administration - reboot](../azure-cache-for-redis/cache-administration.md#reboot).
465
479
466
480
To see a list of available parameters and their descriptions for `Reset-AzRedisCache`, run the following command.
0 commit comments