Správa služby Azure Cache for Redis pomocí Azure PowerShellu
V tomto článku se dozvíte, jak vytvářet, aktualizovat a škálovat instance Azure Cache for Redis. Článek také ukazuje, jak znovu vygenerovat přístupové klíče a jak zobrazit informace o vašich mezipamětí. Úplný seznam rutin PowerShellu pro Azure Cache for Redis najdete v tématu Rutiny Azure Cache for 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 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.