Správa Azure Redis pomocí Azure PowerShellu
Azure Managed Redis
Pokud chcete vytvořit instanci Azure Managed Redis (Preview), přihlaste se k webu Azure Portal a vyberte Vytvořit prostředek.
Na stránce Nový zadejte do vyhledávacího pole Azure Cache for Redis.
Na stránce New Redis Cache nakonfigurujte nastavení pro novou mezipaměť.
Nastavení Zvolit hodnotu Popis Předplatné Rozevírací seznam a vyberte své předplatné. Předplatné, ve kterém se má tato nová instance Azure Managed Redis vytvořit. Skupina prostředků Rozevírací seznam a vyberte skupinu prostředků nebo vyberte Vytvořit novou a zadejte nový název skupiny prostředků. Název skupiny prostředků, ve které chcete vytvořit mezipaměť a další prostředky. Když umístíte všechny prostředky aplikace do jedné skupiny prostředků, můžete je snadno spravovat nebo odstraňovat společně. Název DNS Zadejte název, který je v oblasti jedinečný. Název mezipaměti musí být řetězec mezi 1 a 63 znaky v kombinaci s názvem oblasti mezipaměti, který obsahuje pouze číslice, písmena nebo pomlčky. (Pokud je název mezipaměti kratší než 45 znaků, měl by fungovat ve všech aktuálně dostupných oblastech.) Název musí začínat a končit číslicí nebo písmenem a nesmí obsahovat po sobě jdoucí pomlčky. Název hostitele vaší instance mezipaměti je \<DNS name\>.\<Azure region\>.redis.azure.net
.Místo Rozevírací seznam a výběr umístění Azure Managed Redis je k dispozici ve vybraných oblastech Azure. Typ mezipaměti Rozevírací seznam a vyberte úroveň výkonu a velikost mezipaměti. Úroveň určuje výkon instance Redis, zatímco velikost mezipaměti určuje paměť dostupnou k ukládání dat. Pokyny k výběru správné úrovně výkonu najdete v tématu Volba správné úrovně. Vyberte Další: Sítě a vyberte veřejný nebo privátní koncový bod.
Vyberte Další: Upřesnit.
Nakonfigurujte všechny moduly Redis, které wan chcete přidat do instance.
Ve výchozím nastavení pro novou spravovanou mezipaměť:
- Je povoleno ID Microsoft Entra.
- Ověřování přístupových klíčů je zakázáno z bezpečnostních důvodů.
Důležité
Pro zajištění optimálního zabezpečení doporučujeme použít ID Microsoft Entra se spravovanými identitami k autorizaci požadavků v mezipaměti, pokud je to možné. Autorizace pomocí Microsoft Entra ID a spravovaných identit poskytuje vynikající zabezpečení a snadné použití prostřednictvím autorizace sdíleného přístupového klíče. Další informace o používání spravovaných identit s mezipamětí naleznete v tématu Použití MICROSOFT Entra ID pro ověřování mezipaměti.
Nastavte zásady clusteringu na Enterprise pro neclusterovanou mezipaměť nebo na OSS pro clusterovanou mezipaměť. Další informace o výběru zásad clusteringu najdete v tématu Zásady clusteru.
Pokud používáte aktivní geografickou replikaci, musí být nakonfigurovaná během vytváření. Další informace najdete v tématu Konfigurace aktivní geografické replikace pro instance Azure Managed Redis.
Důležité
Po vytvoření nemůžete změnit zásady clusteringu instance Azure Managed Redis (Preview). Pokud používáte RediSearch, vyžaduje se zásada podnikového clusteru a
NoEviction
je to jediná podporovaná zásada vyřazení.Důležité
Pokud tuto instanci mezipaměti používáte ve skupině geografické replikace, zásady vyřazení nelze po vytvoření instance změnit. Před vytvořením mezipaměti nezapomeňte znát zásady vyřazení primárních uzlů. Další informace o aktivní geografické replikaci najdete v tématu Požadavky na aktivní geografickou replikaci.
Důležité
Po vytvoření instance mezipaměti nemůžete měnit moduly. Moduly musí být povolené v době, kdy vytvoříte instanci Azure Cache for Redis. Po vytvoření mezipaměti není možné povolit konfiguraci modulu.
Vyberte Další: Značky a přeskočte.
Vyberte Další: Zkontrolovat a vytvořit.
Zkontrolujte nastavení a vyberte Vytvořit.
Vytvoření instance Redis trvá několik minut. Průběh můžete sledovat na stránce přehledu Azure Managed Redis. Když se stav zobrazí jako Spuštěno, je mezipaměť připravená k použití.
Azure Cache for Redis
Pokud chcete vytvořit mezipaměť, přihlaste se k webu Azure Portal. V nabídce portálu vyberte Vytvořit prostředek.
V podokně Začínáme zadejte azure Cache for Redis na panelu hledání. Ve výsledcích hledání vyhledejte Azure Cache for Redis a pak vyberte Vytvořit.
V podokně New Redis Cache na kartě Základy nakonfigurujte pro mezipaměť následující nastavení:
Nastavení Akce Popis Předplatné Vyberte své předplatné Azure. Předplatné, které se má použít k vytvoření nové instance Azure Cache for Redis. Skupina prostředků Vyberte skupinu prostředků nebo vyberte Vytvořit novou a zadejte název nové skupiny prostředků. Název skupiny prostředků, ve které chcete vytvořit mezipaměť a další prostředky. Když umístíte všechny prostředky aplikace do jedné skupiny prostředků, můžete je snadno spravovat nebo odstraňovat společně. Název DNS Zadejte jedinečný název. Název mezipaměti musí být řetězec 1 až 63 znaků, který obsahuje jenom číslice, písmena a pomlčky. Název musí začínat a končit číslem nebo písmenem a nesmí obsahovat po sobě jdoucí pomlčky. Název hostitele vaší instance mezipaměti je \<DNS name>.redis.cache.windows.net
.Místo Vyberte umístění. Oblast Azure, která je blízko jiných služeb, které používají vaši mezipaměť. Skladová položka mezipaměti Vyberte skladovou položku. Skladová položka určuje velikost, výkon a parametry funkcí, které jsou k dispozici pro mezipaměť. Další informace najdete v přehledu služby Azure Cache for Redis. Velikost mezipaměti Vyberte velikost mezipaměti. Další informace najdete v přehledu služby Azure Cache for Redis. Vyberte kartu Sítě nebo vyberte Další: Sítě.
Na kartě Sítě vyberte metodu připojení, která se má použít pro mezipaměť.
Vyberte kartu Upřesnit nebo vyberte Další: Upřesnit.
V podokně Upřesnit ověřte nebo vyberte metodu ověřování na základě následujících informací:
- Ve výchozím nastavení je pro novou mezipaměť Basic, Standard nebo Premium povolená služba Microsoft Entra Authentication a ověřování přístupových klíčů je zakázané.
- U mezipamětí Basic nebo Standard můžete zvolit výběr pro port jiného typu než TLS.
- U mezipamětí Standard a Premium můžete povolit zóny dostupnosti. Po vytvoření mezipaměti nemůžete zakázat zóny dostupnosti.
- Pro mezipaměť Premium nakonfigurujte nastavení pro port bez protokolu TLS, clustering, spravovanou identitu a trvalost dat.
Důležité
Pro zajištění optimálního zabezpečení doporučujeme použít ID Microsoft Entra se spravovanými identitami k autorizaci požadavků v mezipaměti, pokud je to možné. Autorizace pomocí Microsoft Entra ID a spravovaných identit poskytuje vynikající zabezpečení a snadné použití prostřednictvím autorizace sdíleného přístupového klíče. Další informace o používání spravovaných identit s mezipamětí naleznete v tématu Použití MICROSOFT Entra ID pro ověřování mezipaměti.
(Volitelné) Vyberte kartu Značky nebo vyberte Další: Značky.
(Volitelné) Na kartě Značky zadejte název a hodnotu značky , pokud chcete zařadit prostředek mezipaměti do kategorií.
Vyberte tlačítko Zkontrolovat a vytvořit.
Na kartě Zkontrolovat a vytvořit Azure vaši konfiguraci automaticky ověří.
Jakmile se zobrazí zelená zpráva o úspěšném ověření, vyberte Vytvořit.
Během několika minut dojde k novému nasazení mezipaměti. Průběh nasazení můžete monitorovat v podokně Přehled služby Azure Cache for Redis. Když se zobrazí stav Spuštěno, je mezipaměť připravená k použití.
V tomto článku se dozvíte, jak vytvářet, aktualizovat a škálovat instance Azure Redis.
Poznámka:
Azure má dva různé modely nasazení, které můžete použít k vytváření a práci s prostředky: Azure Resource Manager a Classic. Tento článek popisuje použití modelu nasazení Resource Manager. Pro nová nasazení místo modelu nasazení Classic doporučujeme model nasazení Resource Manager.
Další informace o modelu nasazení Classic najdete v tématu Azure Resource Manager vs. nasazení Classic: Vysvětlení modelů nasazení a stavu vašich prostředků.
Požadavky
Pokud jste už nainstalovali Azure PowerShell, musíte mít Azure PowerShell verze 12.4.0 nebo novější. Verzi Azure PowerShellu můžete zkontrolovat pomocí tohoto příkazu na příkazovém řádku Azure PowerShellu.
Get-Module Az | format-table version
Nejprve se musíte přihlásit k Azure pomocí tohoto příkazu.
Connect-AzAccount
V dialogovém okně pro přihlášení k Microsoft Azure zadejte e-mailovou adresu svého účtu Azure a heslo.
Pokud máte více předplatných Azure, musíte nastavit předplatné Azure. Pokud chcete zobrazit seznam aktuálních předplatných, spusťte tento příkaz.
Get-AzSubscription | sort SubscriptionName | Select SubscriptionName
Pokud chcete zadat předplatné, spusťte následující příkaz. V následujícím příkladu je ContosoSubscription
název předplatného .
Select-AzSubscription -SubscriptionName ContosoSubscription
Než budete moct používat Windows PowerShell s Azure Resource Managerem, musíte ověřit nastavení:
- Windows PowerShell verze 3.0 nebo 4.0. Pokud chcete najít verzi Windows PowerShellu, zadejte:
$PSVersionTable
a ověřte, že je hodnotaPSVersion
3.0 nebo 4.0. Informace o instalaci kompatibilní verze naleznete v tématu Windows Management Framework 3.0.
Pokud chcete získat podrobnou nápovědu pro všechny rutiny, které vidíte v tomto kurzu, použijte rutinu Get-Help.
Get-Help <cmdlet-name> -Detailed
Pokud chcete například získat nápovědu pro rutinu New-AzRedisEnterpriseCache
, zadejte:
Get-Help New-AzRedisEnterpriseCache -Detailed
Jak se připojit k jiným cloudům
Ve výchozím nastavení je AzureCloud
prostředí Azure , které představuje globální cloudovou instanci Azure. Pokud se chcete připojit k jiné instanci, použijte Connect-AzAccount
příkaz s -Environment
přepínačem příkazového řádku neboEnvironmentName
přepínačem příkazového řádku s požadovaným názvem prostředí nebo prostředí.
Pokud chcete zobrazit seznam dostupných prostředí, spusťte rutinu Get-AzEnvironment
.
Připojení ke cloudu Azure Government
Pokud se chcete připojit ke cloudu Azure Government, použijte jeden z následujících příkazů.
Connect-AzAccount -EnvironmentName AzureUSGovernment
Nebo
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureUSGovernment)
Pokud chcete vytvořit mezipaměť v cloudu Azure Government, použijte jedno z následujících umístění.
- USGov Virginia
- USGov Iowa
Další informace o cloudu Azure Government najdete v příručce pro vývojáře Microsoft Azure Government a Microsoft Azure Government.
Připojení k Microsoft Azure provozovanému společností 21Vianet Cloud
Pokud se chcete připojit k Azure provozovanému cloudem 21Vianet, použijte jeden z následujících příkazů.
Connect-AzAccount -EnvironmentName AzureChinaCloud
Nebo
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureChinaCloud)
K vytvoření mezipaměti v Azure provozovaném společností 21Vianet Cloud použijte jedno z následujících umístění.
- Čína – východ
- Čína – sever
Připojení k Microsoft Azure Germany
Pokud se chcete připojit k Microsoft Azure Germany, použijte jeden z následujících příkazů.
Connect-AzAccount -EnvironmentName AzureGermanCloud
Nebo
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureGermanCloud)
Pokud chcete vytvořit mezipaměť v Microsoft Azure Germany, použijte jedno z následujících umístění.
- Německo – střed
- Německo – severovýchod
Další informace o Microsoft Azure Germany naleznete v tématu Microsoft Azure Germany.
Parametry a vlastnosti Azure Managed Redis PowerShellu
Seznam všech parametrů a vlastností Azure Managed Redis PowerShellu najdete v tématu New-AzRedisEnterpriseCache.
Vytvoření Azure Managed Redis
Nové instance Azure Managed Redis se vytvářejí pomocí rutiny New-AzRedisEnterpriseCache .
Důležité
Při prvním vytvoření Azure Managed Redis v předplatném pomocí webu Azure Portal portál zaregistruje Microsoft.Cache
obor názvů pro toto předplatné. Pokud se pokusíte vytvořit první Azure Managed Redis v předplatném pomocí PowerShellu, musíte nejprve zaregistrovat tento obor názvů pomocí následujícího příkazu; jinak rutiny, jako New-AzRedisEnterpriseCache
jsou a Get-AzRedisEnterpriseCache
selžou.
Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache"
Pokud chcete zobrazit seznam dostupných parametrů a jejich popis, New-AzRedisEnterpriseCache
spusťte následující příkaz.
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).
Pokud chcete vytvořit mezipaměť s výchozími parametry, spusťte následující příkaz.
New-AzRedisEnterpriseCache -ResourceGroupName myGroup -Name mycache -Location "North Central US"
ResourceGroupName
, Name
a Location
jsou povinné parametry, ale zbývající hodnoty jsou volitelné a mají výchozí hodnoty. Spuštěním předchozího příkazu se vytvoří instance Azure Managed Redis se zadaným názvem, umístěním a skupinou prostředků. Instance má velikost 1 GB s zakázaným portem bez SSL.
Pokud chcete povolit clustering, zadejte pomocí parametru ShardCount
počet horizontálních oddílů.
Chcete-li zadat hodnoty parametru RedisConfiguration
, uzavřete hodnoty uvnitř {}
jako páry klíč/hodnota, například @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}
. Následující příklad vytvoří mezipaměť 1 GB s allkeys-random
maxmemory zásady a oznámení keyspace nakonfigurovanými .KEA
Další informace najdete v tématu Oznámení služby Keyspace (upřesňující nastavení) a Zásady paměti.
New-AzRedisEnterpriseCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}
Konfigurace nastavení databází během vytváření mezipaměti
Nastavení databases
lze nakonfigurovat pouze během vytváření mezipaměti. Následující příklad vytvoří mezipaměť se 48 databázemi pomocí rutiny New-AzRedisEnterpriseCache .
New-AzRedisEnterpriseCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku B1 -RedisConfiguration @{"databases" = "48"}
Další informace o databases
vlastnosti najdete v tématu Výchozí konfigurace serveru Azure Managed Redis. Další informace o vytvoření mezipaměti pomocí rutiny New-AzRedisEnterpriseCache najdete v předchozí části Vytvoření spravovaného redisu Azure.
Aktualizace Spravovaného Redisu v Azure
Instance Azure Managed Redis se aktualizují pomocí rutiny [Set-AzRedisEnterpriseCache].
Pokud chcete zobrazit seznam dostupných parametrů a jejich popis, Set-AzRedisEnterpriseCache
spusťte následující příkaz.
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).
Rutinu Set-AzRedisEnterpriseCache
lze použít k aktualizaci vlastností, jako Sku
EnableNonSslPort
je , a RedisConfiguration
hodnot.
Následující příkaz aktualizuje zásady maxmemory-policy pro Azure Managed Redis s názvem myCache.
Set-AzRedisEnterpriseCache -ResourceGroupName "myGroup" -Name "myCache" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random"}
Získání informací o Spravovaném redisu Azure
Informace o mezipaměti můžete načíst pomocí rutiny Get-AzRedisEnterpriseCache .
Pokud chcete zobrazit seznam dostupných parametrů a jejich popis, Get-AzRedisEnterpriseCache
spusťte následující příkaz.
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).
Pokud chcete vrátit informace o všech mezipamětí v aktuálním předplatném, spusťte Get-AzRedisEnterpriseCache
bez parametrů.
Get-AzRedisEnterpriseCache
Pokud chcete vrátit informace o všech mezipamětí v konkrétní skupině prostředků, spusťte Get-AzRedisEnterpriseCache
s parametrem ResourceGroupName
.
Get-AzRedisEnterpriseCache -ResourceGroupName myGroup
Pokud chcete vrátit informace o konkrétní mezipaměti, spusťte Get-AzRedisEnterpriseCache
s Name
parametrem obsahujícím název mezipaměti a ResourceGroupName
parametr se skupinou prostředků obsahující danou mezipaměť.
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 :
Načtení přístupových klíčů pro Azure Managed Redis
K načtení přístupových klíčů pro vaši mezipaměť můžete použít rutinu Get-AzRedisEnterpriseCacheKey .
Pokud chcete zobrazit seznam dostupných parametrů a jejich popis, Get-AzRedisEnterpriseCacheKey
spusťte následující příkaz.
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).
Pokud chcete načíst klíče pro vaši mezipaměť, zavolejte rutinu Get-AzRedisEnterpriseCacheKey
a předejte název mezipaměti název skupiny prostředků, která mezipaměť obsahuje.
PS C:\> Get-AzRedisEnterpriseCacheKey -Name myCache -ResourceGroupName myGroup
PrimaryKey : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
SecondaryKey : ABhfB757JgjIgt785JgKH9865eifmekfnn649303JKL=
Opětovné vygenerování přístupových klíčů pro Azure Managed Redis
Pokud chcete znovu vygenerovat přístupové klíče pro vaši mezipaměť, můžete použít rutinu New-AzRedisEnterpriseCacheKey .
Pokud chcete zobrazit seznam dostupných parametrů a jejich popis, New-AzRedisEnterpriseCacheKey
spusťte následující příkaz.
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).
Pokud chcete znovu vygenerovat primární nebo sekundární klíč pro vaši mezipaměť, zavolejte rutinu New-AzRedisEnterpriseCacheKey
a předejte název, skupinu prostředků a zadejte buď Primary
nebo Secondary
pro KeyType
parametr. V následujícím příkladu se sekundární přístupový klíč pro mezipaměť znovu vygeneruje.
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=
Odstranění spravovaného Redisu v Azure
Pokud chcete odstranit Azure Managed Redis, použijte rutinu Remove-AzRedisEnterpriseCache .
Pokud chcete zobrazit seznam dostupných parametrů a jejich popis, Remove-AzRedisEnterpriseCache
spusťte následující příkaz.
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).
V následujícím příkladu je pojmenovaná myCache
mezipaměť odebrána.
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
Import spravovaného Redisu v Azure
Data můžete importovat do instance Azure Managed Redis pomocí této rutiny Import-AzRedisEnterpriseCache
.
Pokud chcete zobrazit seznam dostupných parametrů a jejich popis, Import-AzRedisEnterpriseCache
spusťte následující příkaz.
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).
Následující příkaz naimportuje data z objektu blob určeného identifikátorem URI SAS do Azure Managed 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
Export spravovaného Redisu v Azure
Data z instance Azure Managed Redis můžete exportovat pomocí této rutiny Export-AzRedisEnterpriseCache
.
Pokud chcete zobrazit seznam dostupných parametrů a jejich popis, Export-AzRedisEnterpriseCache
spusťte následující příkaz.
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).
Následující příkaz exportuje data z instance Azure Managed Redis do kontejneru určeného identifikátorem URI SAS.
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"
Restartování Azure Managed Redis (Preview)
Pomocí rutiny Reset-AzRedisEnterpriseCache
můžete restartovat instanci Azure Managed Redis (Preview).
Pokud chcete zobrazit seznam dostupných parametrů a jejich popis, Reset-AzRedisEnterpriseCache
spusťte následující příkaz.
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).
Následující příkaz restartuje oba uzly zadané mezipaměti.
PS C:\>Reset-AzRedisEnterpriseCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -RebootType "AllNodes"
-Force
Poznámka:
Azure má dva různé modely nasazení, které můžete použít k vytváření a práci s prostředky: Azure Resource Manager a Classic. Tento článek popisuje použití modelu nasazení Resource Manager. Pro nová nasazení místo modelu nasazení Classic doporučujeme model nasazení Resource Manager.
Další informace o modelu nasazení Classic najdete v tématu Azure Resource Manager vs. nasazení Classic: Vysvětlení modelů nasazení a stavu vašich prostředků.
Požadavky
Pokud jste už nainstalovali Azure PowerShell, musíte mít Azure PowerShell verze 1.0.0 nebo novější. Verzi Azure PowerShellu můžete zkontrolovat pomocí tohoto příkazu na příkazovém řádku Azure PowerShellu.
Get-Module Az | format-table version
Nejprve se musíte přihlásit k Azure pomocí tohoto příkazu.
Connect-AzAccount
V dialogovém okně pro přihlášení k Microsoft Azure zadejte e-mailovou adresu svého účtu Azure a heslo.
Pokud máte více předplatných Azure, musíte nastavit předplatné Azure. Pokud chcete zobrazit seznam aktuálních předplatných, spusťte tento příkaz.
Get-AzSubscription | sort SubscriptionName | Select SubscriptionName
Pokud chcete zadat předplatné, spusťte následující příkaz. V následujícím příkladu je ContosoSubscription
název předplatného .
Select-AzSubscription -SubscriptionName ContosoSubscription
Než budete moct používat Windows PowerShell s Azure Resource Managerem, musíte ověřit nastavení:
- Windows PowerShell verze 3.0 nebo 4.0. Pokud chcete najít verzi Windows PowerShellu, zadejte:
$PSVersionTable
a ověřte, že je hodnotaPSVersion
3.0 nebo 4.0. Informace o instalaci kompatibilní verze naleznete v tématu Windows Management Framework 3.0.
Pokud chcete získat podrobnou nápovědu pro všechny rutiny, které vidíte v tomto kurzu, použijte rutinu Get-Help.
Get-Help <cmdlet-name> -Detailed
Pokud chcete například získat nápovědu pro rutinu New-AzRedisCache
, zadejte:
Get-Help New-AzRedisCache -Detailed
Jak se připojit k jiným cloudům
Ve výchozím nastavení je AzureCloud
prostředí Azure , které představuje globální cloudovou instanci Azure. Pokud se chcete připojit k jiné instanci, použijte Connect-AzAccount
příkaz s -Environment
přepínačem příkazového řádku neboEnvironmentName
přepínačem příkazového řádku s požadovaným názvem prostředí nebo prostředí.
Pokud chcete zobrazit seznam dostupných prostředí, spusťte rutinu Get-AzEnvironment
.
Připojení ke cloudu Azure Government
Pokud se chcete připojit ke cloudu Azure Government, použijte jeden z následujících příkazů.
Connect-AzAccount -EnvironmentName AzureUSGovernment
Nebo
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureUSGovernment)
Pokud chcete vytvořit mezipaměť v cloudu Azure Government, použijte jedno z následujících umístění.
- USGov Virginia
- USGov Iowa
Další informace o cloudu Azure Government najdete v příručce pro vývojáře Microsoft Azure Government a Microsoft Azure Government.
Připojení k Microsoft Azure provozovanému společností 21Vianet Cloud
Pokud se chcete připojit k Azure provozovanému cloudem 21Vianet, použijte jeden z následujících příkazů.
Connect-AzAccount -EnvironmentName AzureChinaCloud
Nebo
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureChinaCloud)
K vytvoření mezipaměti v Azure provozovaném společností 21Vianet Cloud použijte jedno z následujících umístění.
- Čína – východ
- Čína – sever
Připojení k Microsoft Azure Germany
Pokud se chcete připojit k Microsoft Azure Germany, použijte jeden z následujících příkazů.
Connect-AzAccount -EnvironmentName AzureGermanCloud
Nebo
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureGermanCloud)
Pokud chcete vytvořit mezipaměť v Microsoft Azure Germany, použijte jedno z následujících umístění.
- Německo – střed
- Německo – severovýchod
Další informace o Microsoft Azure Germany naleznete v tématu Microsoft Azure Germany.
Vlastnosti používané pro Azure Cache for Redis PowerShell
Následující tabulka obsahuje vlastnosti a popisy Azure PowerShellu pro běžné parametry při vytváření a správě instancí Azure Cache for Redis.
Parametr | Popis | Výchozí |
---|---|---|
Název | Název mezipaměti | |
Umístění | Umístění mezipaměti | |
ResourceGroupName | Název skupiny prostředků, ve které se má vytvořit mezipaměť | |
Velikost | Velikost mezipaměti. Platné hodnoty jsou: P1, P2, P3, P4, P5, C0, C1, C2, C3, C4, C5, C6, 250 MB, 1 GB, 2,5 GB, 6 GB, 13 GB, 26 GB, 53 GB | 1GB |
ShardCount | Počet horizontálních oddílů, které se mají vytvořit při vytváření mezipaměti Premium s povoleným clusteringem. Platné hodnoty jsou: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 | |
Skladová jednotka (SKU) | Určuje skladovou položku mezipaměti. Platné hodnoty jsou: Basic, Standard, Premium | Standard |
RedisConfiguration | Určuje nastavení konfigurace Redis. Podrobnosti o jednotlivých nastaveních najdete v následující tabulce vlastností RedisConfiguration. | |
EnableNonSslPort | Určuje, jestli je povolený port bez SSL. | False |
MaxMemoryPolicy | Tento parametr je zastaralý – místo toho použijte RedisConfiguration. | |
StaticIP | Při hostování mezipaměti ve virtuální síti určuje jedinečnou IP adresu v podsíti pro mezipaměť. Pokud není k dispozici, vybere se pro vás z podsítě. | |
Podsíť | Při hostování mezipaměti ve virtuální síti určuje název podsítě, ve které se má mezipaměť nasadit. | |
VirtualNetwork | Při hostování mezipaměti ve virtuální síti určuje ID prostředku virtuální sítě, ve které se má mezipaměť nasadit. | |
Typ klíče | Určuje, který přístupový klíč se má znovu vygenerovat při obnovování přístupových klíčů. Platné hodnoty jsou: Primární, Sekundární |
RedisConfiguration – vlastnosti
Vlastnost | Popis | Cenové úrovně |
---|---|---|
Rdb-backup-enabled | Jestli je povolená trvalost dat Redis | Pouze Premium |
rdb-storage-connection-string | Připojovací řetězec k účtu úložiště pro trvalost dat Redis | Pouze Premium |
rdb-backup-frequency | Frekvence zálohování pro trvalost dat Redis | Pouze Premium |
maxmemory-reserved | Nakonfiguruje paměť vyhrazenou pro procesy mimo mezipaměť. | Standard a Premium |
maxmemory-policy | Nakonfiguruje zásadu vyřazení pro mezipaměť. | Všechny cenové úrovně |
notify-keyspace-events | Konfiguruje oznámení o prostoru klíčů. | Standard a Premium |
hash-max-ziplist-entries | Konfiguruje optimalizaci paměti pro malé agregované datové typy. | Standard a Premium |
hash-max-ziplist-value | Konfiguruje optimalizaci paměti pro malé agregované datové typy. | Standard a Premium |
set-max-intset-entries | Konfiguruje optimalizaci paměti pro malé agregované datové typy. | Standard a Premium |
zset-max-ziplist-entries | Konfiguruje optimalizaci paměti pro malé agregované datové typy. | Standard a Premium |
zset-max-ziplist-value | Konfiguruje optimalizaci paměti pro malé agregované datové typy. | Standard a Premium |
V databázích | Konfiguruje počet databází. Tuto vlastnost lze nakonfigurovat pouze při vytváření mezipaměti. | Standard a Premium |
Vytvoření azure Cache for Redis
Nové instance Azure Cache for Redis se vytvářejí pomocí rutiny New-AzRedisCache .
Důležité
Při prvním vytvoření služby Azure Cache for Redis v předplatném pomocí webu Azure Portal portál zaregistruje Microsoft.Cache
obor názvů pro toto předplatné. Pokud se pokusíte vytvořit první službu Azure Cache for Redis v předplatném pomocí PowerShellu, musíte nejprve tento obor názvů zaregistrovat pomocí následujícího příkazu; jinak rutiny, jako New-AzRedisCache
jsou a Get-AzRedisCache
selžou.
Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache"
Pokud chcete zobrazit seznam dostupných parametrů a jejich popis, New-AzRedisCache
spusťte následující příkaz.
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).
Pokud chcete vytvořit mezipaměť s výchozími parametry, spusťte následující příkaz.
New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US"
ResourceGroupName
, Name
a Location
jsou povinné parametry, ale zbývající hodnoty jsou volitelné a mají výchozí hodnoty. Spuštěním předchozího příkazu se vytvoří instance Azure Cache for Redis úrovně Standard se zadaným názvem, umístěním a skupinou prostředků. Instance má velikost 1 GB s zakázaným portem bez SSL.
Pokud chcete vytvořit mezipaměť Premium, zadejte velikost P1 (6 GB – 60 GB), P2 (13 GB – 130 GB), P3 (26 GB – 260 GB) nebo P4 (53 GB až 530 GB). Pokud chcete povolit clustering, zadejte pomocí parametru ShardCount
počet horizontálních oddílů. Následující příklad vytvoří mezipaměť P1 Premium se třemi horizontálními oddíly. Mezipaměť P1 úrovně Premium je velikost 6 GB a vzhledem k tomu, že jsme zadali tři horizontální oddíly, celková velikost je 18 GB (3 x 6 GB).
New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku Premium -Size P1 -ShardCount 3
Chcete-li zadat hodnoty parametru RedisConfiguration
, uzavřete hodnoty uvnitř {}
jako páry klíč/hodnota, například @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}
. Následující příklad vytvoří standardní mezipaměť 1 GB se allkeys-random
zásadami maxmemory a oznámeními o prostoru klíčů nakonfigurovanými pomocí KEA
. Další informace najdete v tématu Oznámení služby Keyspace (upřesňující nastavení) a Zásady paměti.
New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}
Konfigurace nastavení databází během vytváření mezipaměti
Nastavení databases
lze nakonfigurovat pouze během vytváření mezipaměti. Následující příklad vytvoří mezipaměť Premium P3 (26 GB) s 48 databázemi pomocí rutiny New-AzRedisCache .
New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku Premium -Size P3 -RedisConfiguration @{"databases" = "48"}
Další informace o databases
vlastnosti najdete v tématu Výchozí konfigurace serveru Azure Cache for Redis. Další informace o vytvoření mezipaměti pomocí rutiny New-AzRedisCache najdete v předchozí části Vytvoření služby Azure Cache for Redis.
Aktualizace azure Cache for Redis
Instance Azure Cache for Redis se aktualizují pomocí rutiny Set-AzRedisCache .
Pokud chcete zobrazit seznam dostupných parametrů a jejich popis, Set-AzRedisCache
spusťte následující příkaz.
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).
Rutinu Set-AzRedisCache
lze použít k aktualizaci vlastností, jako Size
jsou , Sku
EnableNonSslPort
a RedisConfiguration
hodnoty.
Následující příkaz aktualizuje zásady maxmemory-policy pro Azure Cache for Redis s názvem myCache.
Set-AzRedisCache -ResourceGroupName "myGroup" -Name "myCache" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random"}
Škálování služby Azure Cache for Redis
Set-AzRedisCache
lze použít ke škálování instance Azure Cache for Redis při úpravě Size
Sku
, nebo ShardCount
vlastností.
Poznámka:
Škálování mezipaměti pomocí PowerShellu podléhá stejným omezením a pokynům jako škálování mezipaměti z webu Azure Portal. S následujícími omezeními můžete škálovat na jinou cenovou úroveň.
- Nemůžete škálovat z vyšší cenové úrovně na nižší cenovou úroveň.
- Nejde škálovat z mezipaměti Premium dolů na mezipaměť Úrovně Standard nebo Basic .
- Nejde škálovat z mezipaměti Standard dolů do mezipaměti Basic .
- Velikost můžete škálovat z mezipaměti Basic na mezipaměť Úrovně Standard , ale nemůžete změnit velikost současně. Pokud potřebujete jinou velikost, můžete provést následnou operaci škálování na požadovanou velikost.
- Nemůžete škálovat z mezipaměti Basic přímo do mezipaměti Premium . V jedné operaci škálování je nutné škálovat z úrovně Basic na Standard a potom z úrovně Standard na Premium v následné operaci škálování.
- Nejde škálovat z větší velikosti na velikost C0 (250 MB).
Další informace najdete v tématu Škálování služby Azure Cache for Redis.
Následující příklad ukazuje, jak škálovat mezipaměť s názvem myCache
na mezipaměť o velikosti 2,5 GB. Tento příkaz funguje pro mezipaměť Basic nebo Standard.
Set-AzRedisCache -ResourceGroupName myGroup -Name myCache -Size 2.5GB
Po vydání tohoto příkazu se vrátí stav mezipaměti---similar pro volání Get-AzRedisCache
. Je nastavena ProvisioningState
na Scaling
hodnotu .
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 :
Po dokončení operace škálování se změní na ProvisioningState
Succeeded
. Pokud potřebujete provést další operaci škálování--- například změna z úrovně Basic na standard a následná změna velikosti---počkejte na dokončení předchozí operace nebo se zobrazí chyba podobná následující.
Set-AzRedisCache : Conflict: The resource '...' is not in a stable state, and is currently unable to accept the update request.
Získání informací o službě Azure Cache for Redis
Informace o mezipaměti můžete načíst pomocí rutiny Get-AzRedisCache .
Pokud chcete zobrazit seznam dostupných parametrů a jejich popis, Get-AzRedisCache
spusťte následující příkaz.
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).
Pokud chcete vrátit informace o všech mezipamětí v aktuálním předplatném, spusťte Get-AzRedisCache
bez parametrů.
Get-AzRedisCache
Pokud chcete vrátit informace o všech mezipamětí v konkrétní skupině prostředků, spusťte Get-AzRedisCache
s parametrem ResourceGroupName
.
Get-AzRedisCache -ResourceGroupName myGroup
Pokud chcete vrátit informace o konkrétní mezipaměti, spusťte Get-AzRedisCache
s Name
parametrem obsahujícím název mezipaměti a ResourceGroupName
parametr se skupinou prostředků obsahující danou mezipaměť.
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 :
Načtení přístupových klíčů pro Azure Cache for Redis
K načtení přístupových klíčů pro vaši mezipaměť můžete použít rutinu Get-AzRedisCacheKey .
Pokud chcete zobrazit seznam dostupných parametrů a jejich popis, Get-AzRedisCacheKey
spusťte následující příkaz.
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).
Pokud chcete načíst klíče pro vaši mezipaměť, zavolejte rutinu Get-AzRedisCacheKey
a předejte název mezipaměti název skupiny prostředků, která mezipaměť obsahuje.
PS C:\> Get-AzRedisCacheKey -Name myCache -ResourceGroupName myGroup
PrimaryKey : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
SecondaryKey : ABhfB757JgjIgt785JgKH9865eifmekfnn649303JKL=
Opětovné vygenerování přístupových klíčů pro Azure Cache for Redis
K opětovnému vygenerování přístupových klíčů pro vaši mezipaměť můžete použít rutinu New-AzRedisCacheKey .
Pokud chcete zobrazit seznam dostupných parametrů a jejich popis, New-AzRedisCacheKey
spusťte následující příkaz.
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).
Pokud chcete znovu vygenerovat primární nebo sekundární klíč pro vaši mezipaměť, zavolejte rutinu New-AzRedisCacheKey
a předejte název, skupinu prostředků a zadejte buď Primary
nebo Secondary
pro KeyType
parametr. V následujícím příkladu se sekundární přístupový klíč pro mezipaměť znovu vygeneruje.
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=
Odstranění služby Azure Cache for Redis
Pokud chcete odstranit Azure Cache for Redis, použijte rutinu Remove-AzRedisCache .
Pokud chcete zobrazit seznam dostupných parametrů a jejich popis, Remove-AzRedisCache
spusťte následující příkaz.
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).
V následujícím příkladu je pojmenovaná myCache
mezipaměť odebrána.
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
Import služby Azure Cache for Redis
Data můžete importovat do instance Azure Cache for Redis pomocí této rutiny Import-AzRedisCache
.
Důležité
Import/export je k dispozici pouze pro mezipaměti úrovně Premium. Další informace o importu a exportu najdete v tématu Import a export dat ve službě Azure Cache for Redis.
Pokud chcete zobrazit seznam dostupných parametrů a jejich popis, Import-AzRedisCache
spusťte následující příkaz.
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).
Následující příkaz naimportuje data z objektu blob určeného identifikátorem URI SAS do 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
Export služby Azure Cache for Redis
Data z instance Azure Cache for Redis můžete exportovat pomocí rutiny Export-AzRedisCache
.
Důležité
Import/export je k dispozici pouze pro mezipaměti úrovně Premium. Další informace o importu a exportu najdete v tématu Import a export dat ve službě Azure Cache for Redis.
Pokud chcete zobrazit seznam dostupných parametrů a jejich popis, Export-AzRedisCache
spusťte následující příkaz.
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).
Následující příkaz exportuje data z instance Azure Cache for Redis do kontejneru určeného identifikátorem URI SAS.
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"
Restartování služby Azure Cache for Redis
Instanci Azure Cache for Redis můžete restartovat pomocí této rutiny Reset-AzRedisCache
.
Důležité
Restartování je k dispozici pouze pro mezipaměti úrovně Basic, Standard a Premium . Další informace o restartování mezipaměti naleznete v tématu Správa mezipaměti – restartování.
Pokud chcete zobrazit seznam dostupných parametrů a jejich popis, Reset-AzRedisCache
spusťte následující příkaz.
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).
Následující příkaz restartuje oba uzly zadané mezipaměti.
PS C:\>Reset-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -RebootType "AllNodes"
-Force
Další kroky
Další informace o používání Windows PowerShellu s Azure najdete v následujících zdrojích informací:
- Dokumentace k rutině Azure Cache for Redis na webu MSDN
- Rutiny Azure Resource Manageru: Naučte se používat rutiny v modulu Azure Resource Manager.
- Použití skupin prostředků ke správě prostředků Azure: Naučte se vytvářet a spravovat skupiny prostředků na webu Azure Portal.
- Blog Azure: Seznamte se s novými funkcemi v Azure.
- Blog Windows PowerShellu: Přečtěte si informace o nových funkcích v prostředí Windows PowerShell.
- "Hej, Chlápek skriptování!" Blog: Získejte tipy a triky z reálného světa od komunity Windows PowerShellu.