Udostępnij za pomocą

Zarządzanie usługą Azure Redis za pomocą programu Azure PowerShell

  • Dotyczy: ✅ Azure Cache for Redis, ✅ Azure Managed Redis

W tym artykule pokazano, jak tworzyć i usuwać wystąpienia usługi Azure Redis oraz zarządzać nimi przy użyciu programu Azure PowerShell.

Wymagania wstępne

  • Upewnij się, że jesteś zalogowany do platformy Azure przy użyciu subskrypcji, w ramach której chcesz utworzyć pamięć podręczną. Aby użyć innej subskrypcji niż ta, za pomocą której się zalogowałeś, uruchom polecenie Select-AzSubscription -SubscriptionName <SubscriptionName>.

Uwaga / Notatka

Usługa Azure Managed Redis używa poleceń Az.RedisEnterpriseCache programu Azure PowerShell.

Usługa Azure Cache for Redis używa Az.RedisEnterpriseCache poleceń dla warstw Enterprise oraz poleceń Az.RedisCache programu Azure PowerShell dla warstw Podstawowa, Standardowa i Premium. Poniższe skrypty umożliwiają tworzenie usługi Azure Managed Redis lub Azure Cache for Redis Enterprise oraz zarządzanie nimi. W przypadku Azure Cache for Redis Basic, Standard, Premium użyj skryptów Azure Cache for Redis.

Utwórz pamięć podręczną Redis zarządzaną przez Azure

Tworzysz nowe wystąpienia usługi Azure Managed Redis przy użyciu polecenia cmdlet New-AzRedisEnterpriseCache. ResourceGroupName, , NameLocationi Sku są wymaganymi parametrami. Pozostałe parametry są opcjonalne i mają wartości domyślne.

Uwierzytelnianie Microsoft Entra jest domyślnie włączone dla wszystkich nowych pamięci podręcznych i jest zalecane dla bezpieczeństwa.

Ważne

Jeśli to możliwe, użyj identyfikatora Entra firmy Microsoft z tożsamościami zarządzanymi, aby autoryzować żądania do pamięci podręcznej. Autoryzacja przy użyciu identyfikatora Entra firmy Microsoft i tożsamości zarządzanej zapewnia lepsze zabezpieczenia i jest łatwiejsza niż autoryzacja klucza dostępu współdzielonego. Aby uzyskać więcej informacji na temat używania tożsamości zarządzanych z pamięcią podręczną, zobacz Use Microsoft Entra for cache authentication with Azure Managed Redis (Używanie usługi Microsoft Entra do uwierzytelniania w pamięci podręcznej za pomocą usługi Azure Managed Redis).

Aby uzyskać informacje o wszystkich parametrach i właściwościach programu PowerShell zarządzanych przez Azure dla New-AzRedisEnterpriseCache, zobacz New-AzRedisEnterpriseCache. Aby wyświetlić listę dostępnych parametrów i ich opisy, uruchom następujące polecenie.

Get-Help New-AzRedisEnterpriseCache -detailed

Uwaga / Notatka

Po raz pierwszy, gdy tworzysz pamięć podręczną Azure Managed Redis Cache w ramach subskrypcji, platforma Azure rejestruje przestrzeń nazw Microsoft.Cache dla Ciebie. Jeśli zostanie wyświetlony monit, możesz użyć polecenia programu Azure PowerShell Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache" , aby zarejestrować przestrzeń nazw.

Poniższe przykładowe polecenie tworzy wystąpienie usługi Azure Managed Redis o określonej nazwie, lokalizacji, grupie zasobów i jednostce SKU przy użyciu parametrów domyślnych. Wystąpienie ma rozmiar 1 GB z wyłączonym portem bez protokołu SSL.

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

Tworzenie i konfigurowanie baz danych

Możesz użyć polecenia cmdlet New-AzRedisEnterpriseCacheDatabase, aby utworzyć i skonfigurować bazy danych dla zarządzanej pamięci podręcznej Redis w Azure. Aby wyświetlić listę dostępnych parametrów i ich opisy dla New-AzRedisEnterpriseCacheDatabaseprogramu , uruchom następujące polecenie.

Get-Help New-AzRedisEnterpriseCacheDatabase -detailed

Jeśli podczas tworzenia pamięci podręcznej nie skonfigurujesz baz danych, usługa New-AzRedisEnterpriseCache tworzy jedną bazę danych w pamięci podręcznej o nazwie default domyślnie, a wszystkie dane pamięci podręcznej przechodzą do tej DB 0 bazy danych.

Zaktualizuj pamięć podręczną Azure Managed Redis Cache

Wystąpienia usługi Redis zarządzanej platformy Azure można zaktualizować używając polecenia cmdlet Update-AzRedisEnterpriseCache. Aby wyświetlić listę dostępnych parametrów i ich opisy dla Update-AzRedisEnterpriseCacheprogramu , uruchom następujące polecenie.

Get-Help Update-AzRedisEnterpriseCache -detailed

Możesz użyć Update-AzRedisEnterpriseCache polecenia cmdlet , aby zaktualizować właściwości, takie jak Sku, Tagi MinimumTlsVersion. Następujące polecenie aktualizuje minimalną wersję protokołu Transport Layer Security (TLS) i dodaje tag do pamięci podręcznej Azure Managed Redis Cache o nazwie myCache.

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

Uzyskiwanie informacji o usłudze Azure Managed Redis Cache

Informacje o pamięci podręcznej można pobrać przy użyciu polecenia cmdlet Get-AzRedisEnterpriseCache . Aby wyświetlić listę dostępnych parametrów i ich opisy dla Get-AzRedisEnterpriseCacheprogramu , uruchom następujące polecenie.

Get-Help Get-AzRedisEnterpriseCache -detailed

Aby zwrócić informacje o wszystkich pamięciach podręcznych w bieżącej subskrypcji, uruchom polecenie Get-AzRedisEnterpriseCache bez żadnych parametrów.

Get-AzRedisEnterpriseCache

Aby zwrócić informacje o wszystkich pamięciach podręcznych w określonej grupie zasobów, uruchom polecenie Get-AzRedisEnterpriseCache z parametrem ResourceGroupName .

Get-AzRedisEnterpriseCache -ResourceGroupName myGroup

Aby zwrócić informacje o określonej pamięci podręcznej, uruchom polecenie Get-AzRedisEnterpriseCache z parametrami Name i ResourceGroupName pamięci podręcznej.

Get-AzRedisEnterpriseCache -Name myCache -ResourceGroupName myGroup

Pobierz klucze dostępu dla zarządzanej pamięci podręcznej Redis w Azure

Aby pobrać klucze dostępu do pamięci podręcznej, użyj polecenia cmdlet Get-AzRedisEnterpriseCacheKey . Aby wyświetlić listę dostępnych parametrów i ich opisy dla Get-AzRedisEnterpriseCacheKeyprogramu , uruchom następujące polecenie.

Get-Help Get-AzRedisEnterpriseCacheKey -detailed

Aby pobrać klucze pamięci podręcznej, wywołaj polecenie cmdlet Get-AzRedisEnterpriseCacheKey za pomocą Name i ResourceGroupName pamięci podręcznej.

Get-AzRedisEnterpriseCacheKey -Name myCache -ResourceGroupName myGroup

Ważne

Operacja ListKeys działa tylko wtedy, gdy klucze dostępu są włączone dla pamięci podręcznej. Dane wyjściowe tego polecenia mogą naruszyć bezpieczeństwo, wyświetlając wpisy tajne i mogą wyzwalać ostrzeżenie o poufnych informacjach.

Ponowne generowanie kluczy dostępu dla pamięci podręcznej w usłudze Azure Managed Redis

Aby ponownie wygenerować klucze dostępu dla pamięci podręcznej, możesz użyć polecenia cmdlet New-AzRedisEnterpriseCacheKey . Aby wyświetlić listę dostępnych parametrów i ich opisy dla New-AzRedisEnterpriseCacheKeyprogramu , uruchom następujące polecenie.

Get-Help New-AzRedisEnterpriseCacheKey -detailed

Aby ponownie wygenerować klucz podstawowy lub pomocniczy dla pamięci podręcznej, wywołaj polecenie cmdlet New-AzRedisEnterpriseCacheKey z pamięcią podręczną Name i ResourceGroupName, a następnie określ Primary lub Secondary dla parametru KeyType. Poniższy przykład ponownie generuje pomocniczy klucz dostępu dla pamięci podręcznej.

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

Usuń pamięć podręczną zarządzaną przez Azure Redis

Aby usunąć pamięć podręczną Azure Managed Redis Cache, użyj polecenia cmdlet Remove-AzRedisEnterpriseCache . Aby wyświetlić listę dostępnych parametrów i ich opisy dla Remove-AzRedisEnterpriseCacheprogramu , uruchom następujące polecenie.

Get-Help Remove-AzRedisEnterpriseCache -detailed

Poniższy przykład usuwa pamięć podręczną o nazwie myCache.

Remove-AzRedisEnterpriseCache -Name myCache -ResourceGroupName myGroup

Importowanie danych usługi Azure Managed Redis Cache

Dane można zaimportować do wystąpienia usługi Azure Managed Redis przy użyciu Import-AzRedisEnterpriseCache polecenia cmdlet . Aby wyświetlić listę dostępnych parametrów i ich opisy dla Import-AzRedisEnterpriseCacheprogramu , uruchom następujące polecenie.

Get-Help Import-AzRedisEnterpriseCache -detailed

Pamięć podręczna Name i ResourceGroupName, a także SasUri dla obiektu blob do zaimportowania są wymagane. Następujące polecenie importuje dane z obiektu blob określonego przez SAS URI.

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

Eksportowanie danych usługi Azure Managed Redis Cache

Dane można wyeksportować z wystąpienia usługi Azure Managed Redis przy użyciu Export-AzRedisEnterpriseCache polecenia cmdlet . Aby wyświetlić listę dostępnych parametrów i ich opisy dla Export-AzRedisEnterpriseCacheprogramu , uruchom następujące polecenie.

Get-Help Export-AzRedisEnterpriseCache -detailed

Wymagana jest pamięć podręczna Name, ResourceGroupName oraz SasUri oraz kontener do wyeksportowania. Przykładowe polecenie poniżej eksportuje dane z kontenera określonego przez URI SAS.

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

Ważne

Usługa Azure Cache for Redis używa poleceń Az.RedisCache programu Azure PowerShell dla warstw Podstawowa, Standardowa i Premium oraz poleceń az.RedisEnterpriseCache programu Azure PowerShell dla warstw Enterprise.

Poniższe skrypty umożliwiają tworzenie pamięci podręcznej Azure Cache for Redis w warstwie Podstawowa, Standardowa i Premium oraz zarządzanie nimi. W przypadku usługi Azure Cache for Redis Enterprise lub Azure Managed Redis użyj poleceń Azure Managed Redis .

Właściwości i parametry programu PowerShell w usłudze Azure Cache for Redis

W poniższych tabelach przedstawiono właściwości i opisy programu Azure PowerShell dla typowych parametrów usługi Azure Cache for Redis. Aby uzyskać informacje o wszystkich parametrach i właściwościach Azure PowerShell dla Az.RedisCache, zobacz AzRedisCache.

Parametr Opis Wartość domyślna
Nazwa Nazwa pamięci podręcznej.
Lokalizacja Lokalizacja pamięci podręcznej.
NazwaGrupyZasobów (ResourceGroupName) Nazwa grupy zasobów, w której ma zostać utworzona pamięć podręczna.
Rozmiar Rozmiar pamięci podręcznej. Prawidłowe wartości to: 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. 1 GB
ShardCount Liczba fragmentów do utworzenia podczas tworzenia pamięci podręcznej w warstwie Premium z włączonym klastrowaniem. Prawidłowe wartości to: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10.
SKU SKU pamięci podręcznej. Prawidłowe wartości to: Podstawowa, Standardowa, Premium. Standard
Konfiguracja Redis Ustawienia konfiguracji usługi Redis. Aby uzyskać szczegółowe informacje na temat każdego ustawienia, zobacz następującą tabelę właściwości RedisConfiguration.
WłączNieSslPort Określa, czy port inny niż SSL jest włączony. Nieprawda
MaxMemoryPolicy Ten parametr jest przestarzały. Użyj RedisConfiguration zamiast tego.
StaticIP Podczas hostowania pamięci podręcznej w sieci wirtualnej jest przypisywany unikatowy adres IP w podsieci dla tej pamięci podręcznej. Jeśli nie zostanie podana, zostanie wybrana jedna z podsieci.
Podsieć Podczas hostowania pamięci podręcznej w sieci wirtualnej podaj nazwę podsieci, w której ma być wdrożona pamięć podręczna.
Sieć wirtualna Podczas hostowania pamięci podręcznej w sieci wirtualnej identyfikator zasobu sieci wirtualnej, w której ma zostać wdrożona pamięć podręczna.
Typ klucza Który klucz dostępu należy zregenerować podczas odnawiania kluczy dostępu. Prawidłowe wartości to: Podstawowa, Pomocnicza.

Właściwości parametru RedisConfiguration

Majątek Opis Poziomy cenowe
Obsługa kopii zapasowej bazy danych rdb Czy włączono trwałość danych usługi Redis Tylko wersja Premium
ciąg połączenia do pamięci masowej bazi danych rdb Parametry połączenia z kontem magazynu dla trwałości danych usługi Redis. Tylko wersja Premium
częstotliwość tworzenia kopii zapasowych RDB Częstotliwość tworzenia kopii zapasowych dla trwałości danych usługi Redis. Tylko wersja Premium
maxmemory-reserved (rezerwacja pamięci maksymalnej) Pamięć zarezerwowana dla procesów niecache. Standardowa i Premium
Polityka maksymalnej pamięci [Zasady usuwania]/azure-cache-for-redis/cache-configure.md#memory-policies) dla pamięci podręcznej. Wszystkie warstwy cenowe
powiadomienia-zdarzenia-przestrzeni-kluczowej [Powiadomienia o przestrzeni kluczy]/azure-cache-for-redis/cache-configure.md#powiadomienia-o-przestrzeni-kluczy-zaawansowane-ustawienia). Standardowa i Premium
hash-max-ziplist-wpisy Optymalizacja pamięci dla małych zagregowanych typów danych. Standardowa i Premium
hash-max-ziplist-value Optymalizacja pamięci dla małych zagregowanych typów danych. Standardowa i Premium
set-max-intset-entries (ustaw maksymalną liczbę wpisów w zestawie liczb całkowitych) Optymalizacja pamięci dla małych zagregowanych typów danych. Standardowa i Premium
zset-maksymalna-liczba-wejść-ziplist Optymalizacja pamięci dla małych zagregowanych typów danych. Standardowa i Premium
zset-max-ziplist-value Optymalizacja pamięci dla małych zagregowanych typów danych. Standardowa i Premium
Baz danych Liczba baz danych. Tę właściwość można skonfigurować tylko podczas tworzenia pamięci podręcznej. Standardowa i Premium

Utwórz pamięć podręczną Azure Cache for Redis

Tworzysz nowe wystąpienia usługi Azure Cache for Redis za pomocą polecenia cmdlet New-AzRedisCache. ResourceGroupName, Namei Location są wymaganymi parametrami. Pozostałe parametry są opcjonalne i mają wartości domyślne.

Ważne

Zaleca się uwierzytelnianie Microsoft Entra dla bezpieczeństwa. Uwierzytelnianie Microsoft Entra można włączyć podczas tworzenia pamięci podręcznej lub po utworzeniu pamięci podręcznej.

Jeśli to możliwe, użyj identyfikatora Entra firmy Microsoft z tożsamościami zarządzanymi, aby autoryzować żądania do pamięci podręcznej. Autoryzacja przy użyciu identyfikatora Entra firmy Microsoft i tożsamości zarządzanej zapewnia lepsze zabezpieczenia i jest łatwiejsza niż autoryzacja klucza dostępu współdzielonego. Aby uzyskać więcej informacji na temat używania tożsamości zarządzanych z pamięcią podręczną, zobacz Użyj Microsoft Entra ID do uwierzytelniania pamięci podręcznej.

Aby wyświetlić listę dostępnych parametrów i ich opisy dla New-AzRedisCache, uruchom następujące polecenie:

Get-Help New-AzRedisCache -detailed>

Uwaga / Notatka

Podczas pierwszego tworzenia pamięci podręcznej Azure Cache for Redis w ramach subskrypcji, Azure rejestruje dla Ciebie przestrzeń nazw Microsoft.Cache. Jeśli zostanie wyświetlony monit, możesz użyć polecenia programu Azure PowerShell Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache" , aby zarejestrować przestrzeń nazw.

Poniższe przykładowe polecenie tworzy wystąpienie usługi Azure Cache for Redis o określonej nazwie, lokalizacji i grupie zasobów przy użyciu parametrów domyślnych. Instancja jest pamięcią podręczną o rozmiarze 1 GB w warstwie standardowej, z wyłączonym portem nieobsługującym protokołu SSL.

New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US"

Aby określić wartości parametru RedisConfiguration , należy ująć pary klucz-wartość w nawiasy klamrowe {}. W poniższym przykładzie zostanie utworzona pamięć podręczna o pojemności 1 GB z użyciem @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}. Aby uzyskać więcej informacji, zobacz Powiadomienia dotyczące przestrzeni kluczy (ustawienia zaawansowane) i Zasady pamięci.

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

Utwórz pamięć podręczną Premium

Aby utworzyć pamięć podręczną usługi Azure Cache for Redis w warstwie Premium, określ rozmiar P1 (6–60 GB), (13–130 GB), P2P3 (26–260 GB) lub P4 (53–530 GB). Aby włączyć klastrowanie, określ liczbę fragmentów przy użyciu parametru ShardCount .

Poniższy przykład tworzy pamięć podręczną P1 Premium z trzema fragmentami. Pamięć podręczna P1 Premium ma rozmiar 6 GB, a w przypadku trzech fragmentów całkowity rozmiar to 18 GB (3 x 6 GB).

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

Konfigurowanie ustawienia baz danych

Ustawienie databases w cmdlecie New-AzRedisCache konfiguruje liczbę baz danych w pamięci cache. Można skonfigurować databases tylko dla warstw Standard i Premium oraz tylko podczas tworzenia pamięci podręcznej za pomocą PowerShell lub innych klientów zarządzania.

Jeśli podczas tworzenia pamięci podręcznej nie określisz databases ustawienia, usługa New-AzRedisCache utworzy jedną bazę danych o nazwie default, a wszystkie dane pamięci podręcznej zostaną wprowadzone do tej DB 0 bazy danych. Limit bazy danych zależy od warstwy i rozmiaru pamięci podręcznej, ale ustawienie domyślne to 16.

Poniższy przykład tworzy pamięć podręczną premium P3 (26 GB) z 48 bazami danych.

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

Aby uzyskać więcej informacji na temat właściwości, zobacz Domyślna databases konfiguracja serwera usługi Azure Cache for Redis.

Aktualizowanie pamięci podręcznej Azure Cache for Redis

Wystąpienia usługi Azure Cache for Redis są aktualizowane przy użyciu polecenia cmdlet Set-AzRedisCache . Aby wyświetlić listę dostępnych parametrów i ich opisy dla Set-AzRedisCacheprogramu , uruchom następujące polecenie.

Get-Help Set-AzRedisCache -detailed

Możesz użyć polecenia Set-AzRedisCache cmdlet, aby zaktualizować właściwości, takie jak Size, Sku, EnableNonSslPort, i wartości RedisConfiguration. Następujące przykładowe polecenie aktualizuje instancję Azure Cache for Redis o nazwie maxmemory-policy.

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

Skalowanie pamięci podręcznej Azure Cache for Redis Cache

Możesz użyć Set-AzRedisCache, aby skalować instancję Azure Cache for Redis, podczas modyfikowania właściwości Size, Sku lub ShardCount.

Uwaga / Notatka

Skalowanie pamięci podręcznej przy użyciu programu PowerShell ma te same limity i wytyczne co skalowanie pamięci podręcznej przy użyciu witryny Azure Portal. Możesz skalować do innej warstwy cenowej z następującymi ograniczeniami:

  • Nie można skalować z wyższej warstwy cenowej do niższej, na przykład z pamięci podręcznej Premium do Standardowej lub Podstawowej, ani z pamięci podręcznej Standardowej do Podstawowej.
  • Można skalować z pamięci podręcznej w warstwie Podstawowa do pamięci podręcznej w warstwie Standardowa, ale nie można jednocześnie zmieniać rozmiaru. Jeśli potrzebujesz innego rozmiaru, możesz wykonać inną operację skalowania do żądanego rozmiaru.
  • Nie można bezpośrednio przejść z pamięci podręcznej Podstawowej do pamięci podręcznej Premium. Należy skalować z warstwy Podstawowej do warstwy Standardowej w ramach jednej operacji skalowania, a następnie z warstwy Standardowej do warstwy Premium w innej operacji.
  • Nie można skalować z większego rozmiaru do rozmiaru C0 (250 MB).

Aby uzyskać więcej informacji, zobacz Jak skalować usługę Azure Cache for Redis.

W poniższym przykładzie pokazano, jak skalować pamięć podręczną o nazwie myCache do rozmiaru 2,5 GB. To polecenie działa w przypadku pamięci podręcznej w warstwie Podstawowa lub Standardowa.

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

Po wydaniu tego polecenia zwrócony zostanie stan pamięci podręcznej, podobnie jak po wywołaniu Get-AzRedisCache. ProvisioningState jest ustawiony na Scaling.

Po zakończeniu operacji skalowania zmienia się ProvisioningState wartość Succeeded. Jeśli musisz wykonać inną operację skalowania, taką jak zmiana rozmiaru po zmianie z warstwy Podstawowa na Standardowa, musisz poczekać na ukończenie poprzedniej operacji. W przeciwnym razie zostanie wyświetlony błąd podobny do poniższego komunikatu.

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

Uzyskiwanie informacji o pamięci podręcznej Azure Cache for Redis

Informacje o pamięci podręcznej można pobrać przy użyciu polecenia cmdlet Get-AzRedisCache . Aby wyświetlić listę dostępnych parametrów i ich opisy dla Get-AzRedisCacheprogramu , uruchom następujące polecenie.

Get-Help Get-AzRedisCache -detailed

Aby zwrócić informacje o wszystkich pamięciach podręcznych w bieżącej subskrypcji, uruchom polecenie Get-AzRedisCache bez żadnych parametrów.

Get-AzRedisCache

Aby zwrócić informacje o wszystkich pamięciach podręcznych w określonej grupie zasobów, uruchom polecenie Get-AzRedisCache z parametrem ResourceGroupName .

Get-AzRedisCache -ResourceGroupName myGroup

Aby zwrócić informacje o określonej pamięci podręcznej, wykonaj Get-AzRedisCache z użyciem pamięci podręcznej Name oraz ResourceGroupName.

Get-AzRedisCache -Name myCache -ResourceGroupName myGroup

Pobierz klucze dostępu do pamięci podręcznej Azure Cache for Redis

Aby pobrać klucze dostępu do pamięci podręcznej, możesz użyć polecenia cmdlet Get-AzRedisCacheKey . Aby wyświetlić listę dostępnych parametrów i ich opisy dla Get-AzRedisCacheKeyprogramu , uruchom następujące polecenie.

Get-Help Get-AzRedisCacheKey -detailed

Aby pobrać klucze pamięci podręcznej, użyj polecenia Get-AzRedisCacheKey cmdlet z pamięcią podręczną Name i ResourceGroupName.

Get-AzRedisCacheKey -Name myCache -ResourceGroupName myGroup

Ważne

Operacja ListKeys działa tylko wtedy, gdy klucze dostępu są włączone dla pamięci podręcznej. Dane wyjściowe tego polecenia mogą naruszyć bezpieczeństwo, wyświetlając wpisy tajne i mogą wyzwalać ostrzeżenie o poufnych informacjach.

Regenerowanie kluczy dostępu dla pamięci podręcznej Azure Cache for Redis

Aby ponownie wygenerować klucze dostępu dla pamięci podręcznej, możesz użyć polecenia cmdlet New-AzRedisCacheKey . Aby wyświetlić listę dostępnych parametrów i ich opisy dla New-AzRedisCacheKeyprogramu , uruchom następujące polecenie.

Get-Help New-AzRedisCacheKey -detailed

Aby ponownie wygenerować klucz podstawowy lub pomocniczy dla pamięci podręcznej, wywołaj polecenie cmdlet New-AzRedisCacheKey z pamięcią podręczną Name i ResourceGroupName, a następnie określ Primary lub Secondary dla parametru KeyType. Poniższy przykład ponownie generuje pomocniczy klucz dostępu dla pamięci podręcznej.

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

Usuwanie pamięci podręcznej Azure Cache for Redis

Aby usunąć pamięć podręczną Azure Cache for Redis, użyj polecenia cmdlet Remove-AzRedisCache. Aby wyświetlić listę dostępnych parametrów i ich opisy dla Remove-AzRedisCacheprogramu , uruchom następujące polecenie.

Get-Help Remove-AzRedisCache -detailed

Poniższy przykład usuwa pamięć podręczną o nazwie myCache.

Remove-AzRedisCache -Name myCache -ResourceGroupName myGroup

Importowanie danych do Azure Cache for Redis

Dane można zaimportować do wystąpienia usługi Azure Cache for Redis przy użyciu Import-AzRedisCache polecenia cmdlet .

Ważne

Importowanie jest dostępne tylko dla pamięci podręcznych w warstwie Premium. Aby uzyskać więcej informacji, zobacz Importowanie i eksportowanie danych w usłudze Azure Cache for Redis.

Aby wyświetlić listę dostępnych parametrów i ich opisy dla Import-AzRedisCacheprogramu , uruchom następujące polecenie.

Get-Help Import-AzRedisCache -detailed

Następujące polecenie importuje dane z określonego przez parametr Files bloba do usługi Azure Cache for Redis.

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

Eksportowanie danych usługi Azure Cache for Redis

Dane można wyeksportować z wystąpienia usługi Azure Cache for Redis przy użyciu Export-AzRedisCache polecenia cmdlet .

Ważne

Eksport jest dostępny tylko dla pamięci podręcznej Tier Premium. Aby uzyskać więcej informacji, zobacz Importowanie i eksportowanie danych w usłudze Azure Cache for Redis.

Aby wyświetlić listę dostępnych parametrów i ich opisy dla Export-AzRedisCacheprogramu , uruchom następujące polecenie.

Get-Help Export-AzRedisCache -detailed

Następujące polecenie eksportuje dane z wystąpienia usługi Azure Cache for Redis do kontenera określonego przez parametr Container.

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

Zrestartować usługę Azure Cache for Redis

Możesz ponownie uruchomić wystąpienie usługi Azure Cache for Redis przy użyciu Reset-AzRedisCache polecenia cmdlet .

Ważne

Ponowne uruchomienie jest dostępne tylko dla pamięci podręcznych Azure Cache for Redis w warstwach Podstawowej, Standardowej i Premium. Aby uzyskać więcej informacji, zobacz Administracja pamięcią podręczną — ponowny rozruch.

Aby wyświetlić listę dostępnych parametrów i ich opisy dla Reset-AzRedisCacheprogramu , uruchom następujące polecenie.

Get-Help Reset-AzRedisCache -detailed

Następujące polecenie uruchamia ponownie oba węzły określonej pamięci podręcznej.

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

Ogólne polecenia programu Azure PowerShell

Uruchom te polecenia w wierszu polecenia programu Azure PowerShell.

Sprawdź wersję programu Azure PowerShell:

Get-Module Az | format-table version

Zaloguj się do platformy Azure:

Connect-AzAccount

Zobacz listę bieżących subskrypcji:

Get-AzSubscription | sort SubscriptionName | Select SubscriptionName

Określ subskrypcję platformy Azure do użycia:

Select-AzSubscription -SubscriptionName ContosoSubscription

Uzyskaj szczegółową pomoc dotyczącą dowolnego cmdletu.

Get-Help <cmdlet-name> -Detailed

Jak nawiązać połączenie z innymi chmurami

Domyślnie środowisko platformy Azure to AzureCloud, które reprezentuje globalną chmurę platformy Azure. Aby nawiązać połączenie z innym wystąpieniem chmury, użyj polecenia Connect-AzAccount z przełącznikiem wiersza poleceń -Environment lub -EnvironmentName wraz z nazwą środowiska, z którym chcesz się połączyć.

Aby wyświetlić listę dostępnych środowisk, uruchom polecenie Get-AzEnvironment.

Azure Government Cloud

Aby nawiązać połączenie z Azure Government, użyj
Connect-AzAccount -EnvironmentName AzureUSGovernment
lub
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureUSGovernment)

Aby utworzyć pamięć podręczną w chmurze Azure Government, użyj lokalizacji USGov Virginia lub USGov Iowa.

Aby uzyskać więcej informacji na temat chmury Azure Government, zobacz Microsoft Azure Government i Microsoft Azure Government Developer Guide (Przewodnik dla deweloperów platformy Microsoft Azure Government).

Platforma Azure obsługiwana przez firmę 21Vianet

Aby nawiązać połączenie z platformą Azure obsługiwaną przez chmurę 21Vianet (Chiny), użyj polecenia
Connect-AzAccount -EnvironmentName AzureChinaCloud
lub
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureChinaCloud)

Aby utworzyć pamięć podręczną na platformie Azure obsługiwanej przez chmurę 21Vianet, użyj lokalizacji China East lub China North.

Microsoft Azure (Niemcy)

Aby nawiązać połączenie z Microsoft Azure Germany, użyj
Connect-AzAccount -EnvironmentName AzureGermanCloud
lub
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureGermanCloud)

Aby utworzyć pamięć podręczną na platformie Microsoft Azure (Niemcy), użyj lokalizacji Germany Central lub Germany Northeast .

Aby uzyskać więcej informacji na temat platformy Microsoft Azure (Niemcy), zobacz Microsoft Azure (Niemcy).

Treści powiązane

  • Last updated on