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

• Program PowerShell
• Interfejs wiersza polecenia platformy Azure

Azure Managed Redis

1. Aby utworzyć wystąpienie usługi Azure Managed Redis (wersja zapoznawcza), zaloguj się do witryny Azure Portal i wybierz pozycję Utwórz zasób.

2. Na stronie Nowy w polu wyszukiwania wpisz Azure Cache for Redis.

3. Na stronie Nowa pamięć podręczna Redis Cache skonfiguruj ustawienia nowej pamięci podręcznej.

   Ustawienie	Wybierz wartość	opis
   Subskrypcja	Z listy rozwijanej i wybierz subskrypcję.	Subskrypcja, w ramach której ma zostać utworzone to nowe wystąpienie usługi Azure Managed Redis.
   Grupa zasobów:	Z listy rozwijanej i wybierz grupę zasobów lub wybierz pozycję Utwórz nową i wprowadź nową nazwę grupy zasobów.	Nazwa grupy zasobów, w której ma zostać utworzona pamięć podręczna i inne zasoby. Umieszczając wszystkie zasoby aplikacji w jednej grupie zasobów, można je łatwo zarządzać lub usuwać razem.
   Nazwa DNS	Wprowadź nazwę unikatową w regionie.	Nazwa pamięci podręcznej musi być ciągiem z zakresu od 1 do 63 znaków w połączeniu z nazwą regionu pamięci podręcznej, która zawiera tylko cyfry, litery lub łączniki. (Jeśli nazwa pamięci podręcznej jest mniejsza niż 45 znaków, powinna działać we wszystkich aktualnie dostępnych regionach). Nazwa musi zaczynać się i kończyć cyfrą lub literą i nie może zawierać kolejnych łączników. Nazwa hosta wystąpienia pamięci podręcznej to \<DNS name\>.\<Azure region\>.redis.azure.net.
   Lokalizacja	Z listy rozwijanej i wybierz lokalizację.	Usługa Azure Managed Redis jest dostępna w wybranych regionach świadczenia usługi Azure.
   Typ pamięci podręcznej	Z listy rozwijanej wybierz warstwę wydajności i rozmiar pamięci podręcznej.	Warstwa określa wydajność wystąpienia usługi Redis, podczas gdy rozmiar pamięci podręcznej określa pamięć dostępną do przechowywania danych. Aby uzyskać wskazówki dotyczące wybierania odpowiedniej warstwy wydajności, zobacz Wybieranie odpowiedniej warstwy

   

4. Wybierz pozycję Dalej: Sieć i wybierz publiczny lub prywatny punkt końcowy.

5. Wybierz pozycję Dalej: Zaawansowane.

   Skonfiguruj wszystkie moduły usługi Redis, które są dodawane do wystąpienia.

   Domyślnie dla nowej zarządzanej pamięci podręcznej:

   • Identyfikator entra firmy Microsoft jest włączony.
   • Uwierzytelnianie kluczy dostępu jest wyłączone ze względów bezpieczeństwa.

   Ważne

   W celu uzyskania optymalnego bezpieczeństwa zalecamy użycie identyfikatora Entra firmy Microsoft z tożsamościami zarządzanymi w celu autoryzowania żądań względem pamięci podręcznej, jeśli to możliwe. Autoryzacja przy użyciu identyfikatora Entra firmy Microsoft i tożsamości zarządzanych zapewnia doskonałe zabezpieczenia i łatwość korzystania z autoryzacji 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 ID for cache authentication (Używanie identyfikatora Entra firmy Microsoft do uwierzytelniania w pamięci podręcznej).

   Ustaw zasady klastrowania na Enterprise dla nieklastrowanej pamięci podręcznej lub na system operacyjny dla klastrowanej pamięci podręcznej. Aby uzyskać więcej informacji na temat wybierania zasad klastrowania, zobacz Zasady klastra.

   

   Jeśli używasz aktywnej replikacji geograficznej, należy ją skonfigurować podczas tworzenia. Aby uzyskać więcej informacji, zobacz Konfigurowanie aktywnej replikacji geograficznej dla wystąpień usługi Azure Managed Redis.

   Ważne

   Po utworzeniu nie można zmienić zasad klastrowania wystąpienia usługi Azure Managed Redis (wersja zapoznawcza). Jeśli używasz narzędzia RediSearch, wymagane są zasady klastra przedsiębiorstwa i NoEviction są jedynymi obsługiwanymi zasadami eksmisji.

   Ważne

   Jeśli używasz tego wystąpienia pamięci podręcznej w grupie replikacji geograficznej, nie można zmienić zasad eksmisji po utworzeniu wystąpienia. Pamiętaj, aby przed utworzeniem pamięci podręcznej znać zasady eksmisji węzłów podstawowych. Aby uzyskać więcej informacji na temat aktywnej replikacji geograficznej, zobacz Wymagania wstępne aktywnej replikacji geograficznej.

   Ważne

   Nie można zmieniać modułów po utworzeniu wystąpienia pamięci podręcznej. Moduły muszą być włączone w momencie tworzenia wystąpienia usługi Azure Cache for Redis. Nie ma możliwości włączenia konfiguracji modułu po utworzeniu pamięci podręcznej.

6. Wybierz pozycję Dalej: Tagi i pomiń.

7. Wybierz pozycję Dalej: Przeglądanie i tworzenie.

8. Przejrzyj ustawienia i wybierz pozycję Utwórz.

   Utworzenie wystąpienia usługi Redis trwa kilka minut. Postęp można monitorować na stronie Omówienie usługi Azure Managed Redis. Gdy stan jest wyświetlany jako Uruchomiono, pamięć podręczna jest gotowa do użycia.

Azure Cache for Redis

1. Aby utworzyć pamięć podręczną, zaloguj się do witryny Azure Portal. W menu portalu wybierz pozycję Utwórz zasób.

   

2. W okienku Wprowadzenie wprowadź ciąg Azure Cache for Redis na pasku wyszukiwania. W wynikach wyszukiwania znajdź usługę Azure Cache for Redis, a następnie wybierz pozycję Utwórz.

   

3. W okienku Nowa pamięć podręczna Redis Cache na karcie Podstawy skonfiguruj następujące ustawienia dla pamięci podręcznej:

   Ustawienie	Akcja	opis
   Subskrypcja	Wybierz subskrypcję platformy Azure.	Subskrypcja do użycia w celu utworzenia nowego wystąpienia usługi Azure Cache for Redis.
   Grupa zasobów:	Wybierz grupę zasobów lub wybierz pozycję Utwórz nową i wprowadź nową nazwę grupy zasobów.	Nazwa grupy zasobów, w której ma zostać utworzona pamięć podręczna i inne zasoby. Umieszczając wszystkie zasoby aplikacji w jednej grupie zasobów, można je łatwo zarządzać lub usuwać razem.
   Nazwa DNS	Wprowadź unikatową nazwę.	Nazwa pamięci podręcznej musi być ciągiem od 1 do 63 znaków, który zawiera tylko cyfry, litery i łączniki. Nazwa musi zaczynać się i kończyć cyfrą lub literą i nie może zawierać kolejnych łączników. Nazwa hosta wystąpienia pamięci podręcznej to \<DNS name>.redis.cache.windows.net.
   Lokalizacja	Wybierz lokalizację.	Region platformy Azure, który znajduje się w pobliżu innych usług korzystających z pamięci podręcznej.
   Jednostka SKU pamięci podręcznej	Wybierz jednostkę SKU.	Jednostka SKU określa rozmiar, wydajność i parametry funkcji, które są dostępne dla pamięci podręcznej. Aby uzyskać więcej informacji, zobacz Omówienie usługi Azure Cache for Redis.
   Rozmiar pamięci podręcznej	Wybierz rozmiar pamięci podręcznej.	Aby uzyskać więcej informacji, zobacz Omówienie usługi Azure Cache for Redis.

4. Wybierz kartę Sieć lub wybierz pozycję Dalej: Sieć.

5. Na karcie Sieć wybierz metodę łączności do użycia dla pamięci podręcznej.

6. Wybierz kartę Zaawansowane lub wybierz pozycję Dalej: Zaawansowane.

7. W okienku Zaawansowane sprawdź lub wybierz metodę uwierzytelniania na podstawie następujących informacji:

   

   • Domyślnie w przypadku nowej pamięci podręcznej w warstwie Podstawowa, Standardowa lub Premium jest włączone uwierzytelnianie Entra firmy Microsoft, a uwierzytelnianie kluczy dostępu jest wyłączone.
   • W przypadku pamięci podręcznych w warstwie Podstawowa lub Standardowa można wybrać opcję portu innego niż TLS.
   • W przypadku pamięci podręcznych w warstwie Standardowa i Premium można włączyć strefy dostępności. Po utworzeniu pamięci podręcznej nie można wyłączyć stref dostępności.
   • W przypadku pamięci podręcznej Premium skonfiguruj ustawienia portów innych niż TLS, klastrowanie, tożsamość zarządzana i trwałość danych.

   Ważne

   W celu uzyskania optymalnego bezpieczeństwa zalecamy użycie identyfikatora Entra firmy Microsoft z tożsamościami zarządzanymi w celu autoryzowania żądań względem pamięci podręcznej, jeśli to możliwe. Autoryzacja przy użyciu identyfikatora Entra firmy Microsoft i tożsamości zarządzanych zapewnia doskonałe zabezpieczenia i łatwość korzystania z autoryzacji 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 ID for cache authentication (Używanie identyfikatora Entra firmy Microsoft do uwierzytelniania w pamięci podręcznej).

8. (Opcjonalnie) Wybierz kartę Tagi lub wybierz pozycję Dalej: Tagi.

9. (Opcjonalnie) Na karcie Tagi wprowadź nazwę i wartość tagu, jeśli chcesz podzielić zasób pamięci podręcznej.

10. Wybierz przycisk Przejrzyj i utwórz.

    Na karcie Przeglądanie i tworzenie platforma Azure automatycznie weryfikuje konfigurację.

11. Po pojawieniu się zielonego komunikatu Weryfikacja przekazana wybierz pozycję Utwórz.

Nowe wdrożenie pamięci podręcznej odbywa się w ciągu kilku minut. Postęp wdrażania można monitorować w okienku Przegląd usługi Azure Cache for Redis. Gdy zostanie wyświetlony stan Uruchomiono, pamięć podręczna jest gotowa do użycia.

W tym artykule pokazano, jak tworzyć, aktualizować i skalować wystąpienia usługi Azure Redis.

Uwaga

Platforma Azure ma dwa różne modele wdrażania, których można użyć do tworzenia zasobów i pracy z nimi: usługi Azure Resource Manager i klasycznej. W tym artykule opisano użycie modelu wdrażania przy użyciu usługi Resource Manager. Zalecamy model wdrażania przy użyciu usługi Resource Manager dla nowych wdrożeń zamiast klasycznego modelu wdrażania.

Aby uzyskać więcej informacji na temat klasycznego modelu wdrażania, zobacz Azure Resource Manager vs. wdrożenie klasyczne: Omówienie modeli wdrażania i stanu zasobów.

Wymagania wstępne

Jeśli masz już zainstalowany program Azure PowerShell, musisz mieć program Azure PowerShell w wersji 12.4.0 lub nowszej. Możesz sprawdzić wersję programu Azure PowerShell za pomocą tego polecenia w wierszu polecenia programu Azure PowerShell.

    Get-Module Az | format-table version

Najpierw musisz zalogować się do platformy Azure za pomocą tego polecenia.

    Connect-AzAccount

Określ adres e-mail konta platformy Azure i hasło w oknie dialogowym logowania platformy Microsoft Azure.

Następnie, jeśli masz wiele subskrypcji platformy Azure, musisz ustawić subskrypcję platformy Azure. Aby wyświetlić listę bieżących subskrypcji, uruchom to polecenie.

    Get-AzSubscription | sort SubscriptionName | Select SubscriptionName

Aby określić subskrypcję, uruchom następujące polecenie. W poniższym przykładzie nazwa subskrypcji to ContosoSubscription.

    Select-AzSubscription -SubscriptionName ContosoSubscription

Przed rozpoczęciem korzystania z programu Windows PowerShell z usługą Azure Resource Manager należy zweryfikować konfigurację:

• Windows PowerShell, wersja 3.0 lub 4.0. Aby znaleźć wersję programu Windows PowerShell, wpisz:$PSVersionTable i sprawdź, czy wartość PSVersion to 3.0 lub 4.0. Aby zainstalować zgodną wersję, zobacz Windows Management Framework 3.0.

Aby uzyskać szczegółową pomoc dotyczącą dowolnego polecenia cmdlet widocznego w tym samouczku, użyj polecenia cmdlet Get-Help.

    Get-Help <cmdlet-name> -Detailed

Aby na przykład uzyskać pomoc dotyczącą New-AzRedisEnterpriseCache polecenia cmdlet, wpisz:

    Get-Help New-AzRedisEnterpriseCache -Detailed

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

Domyślnie środowisko platformy Azure to AzureCloud, które reprezentuje globalne wystąpienie chmury platformy Azure. Aby nawiązać połączenie z innym wystąpieniem, użyj Connect-AzAccount polecenia z przełącznikiem -Environment wiersza polecenia lubEnvironmentName z odpowiednią nazwą środowiska lub środowiska.

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

Aby nawiązać połączenie z chmurą Azure Government

Aby nawiązać połączenie z chmurą Azure Government Cloud, użyj jednego z następujących poleceń.

    Connect-AzAccount -EnvironmentName AzureUSGovernment

Or

    Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureUSGovernment)

Aby utworzyć pamięć podręczną w chmurze Azure Government, użyj jednej z następujących lokalizacji.

• USGov Wirginia
• 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).

Aby nawiązać połączenie z platformą Microsoft Azure obsługiwaną przez firmę 21Vianet Cloud

Aby nawiązać połączenie z platformą Azure obsługiwaną przez chmurę 21Vianet, użyj jednego z następujących poleceń.

    Connect-AzAccount -EnvironmentName AzureChinaCloud

Or

    Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureChinaCloud)

Aby utworzyć pamięć podręczną na platformie Azure obsługiwanej przez usługę 21Vianet Cloud, użyj jednej z następujących lokalizacji.

• Chiny Wschodnie
• Chiny Północne

Aby nawiązać połączenie z platformą Microsoft Azure (Niemcy)

Aby nawiązać połączenie z platformą Microsoft Azure (Niemcy), użyj jednego z następujących poleceń.

    Connect-AzAccount -EnvironmentName AzureGermanCloud

Or

    Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureGermanCloud)

Aby utworzyć pamięć podręczną na platformie Microsoft Azure (Niemcy), użyj jednej z następujących lokalizacji.

• Niemcy Środkowe
• Niemcy Północno-Wschodnie

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

Azure Managed Redis PowerShell Parameters and Properties

Aby uzyskać listę wszystkich parametrów i właściwości programu PowerShell zarządzanych przez usługę Azure Redis, zobacz New-AzRedisEnterpriseCache.

Aby utworzyć usługę Azure Managed Redis

Nowe wystąpienia usługi Redis zarządzanej platformy Azure są tworzone przy użyciu polecenia cmdlet New-AzRedisEnterpriseCache .

Ważne

Przy pierwszym utworzeniu usługi Azure Managed Redis w subskrypcji przy użyciu witryny Azure Portal portal rejestruje Microsoft.Cache przestrzeń nazw dla tej subskrypcji. Jeśli spróbujesz utworzyć pierwszą usługę Azure Managed Redis w subskrypcji przy użyciu programu PowerShell, musisz najpierw zarejestrować tę przestrzeń nazw przy użyciu następującego polecenia; w przeciwnym razie polecenia cmdlet, takie jak New-AzRedisEnterpriseCache i Get-AzRedisEnterpriseCache niepowodzenie.

Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache"

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

    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).

Aby utworzyć pamięć podręczną z domyślnymi parametrami, uruchom następujące polecenie.

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

ResourceGroupName, Namei Location są wymaganymi parametrami, ale pozostałe są opcjonalne i mają wartości domyślne. Uruchomienie poprzedniego polecenia powoduje utworzenie wystąpienia usługi Azure Managed Redis o określonej nazwie, lokalizacji i grupie zasobów. Wystąpienie ma rozmiar 1 GB z wyłączonym portem bez protokołu SSL.

Aby włączyć klastrowanie, określ liczbę fragmentów przy użyciu parametru ShardCount .

Aby określić wartości parametru RedisConfiguration , należy ująć wartości wewnątrz {} jako pary klucz/wartość, takie jak @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}. Poniższy przykład tworzy pamięć podręczną o rozmiarze 1 GB z zasadami allkeys-random maxmemory i powiadomieniami o przestrzeni kluczy skonfigurowanymi przy użyciu polecenia KEA. Aby uzyskać więcej informacji, zobacz Powiadomienia dotyczące przestrzeni kluczy (ustawienia zaawansowane) i Zasady pamięci.

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

Aby skonfigurować ustawienie baz danych podczas tworzenia pamięci podręcznej

Ustawienie databases można skonfigurować tylko podczas tworzenia pamięci podręcznej. Poniższy przykład tworzy pamięć podręczną z 48 bazami danych przy użyciu polecenia cmdlet New-AzRedisEnterpriseCache .

    New-AzRedisEnterpriseCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku B1 -RedisConfiguration @{"databases" = "48"}

Aby uzyskać więcej informacji na temat właściwości, zobacz Domyślna databases konfiguracja serwera Azure Managed Redis. Aby uzyskać więcej informacji na temat tworzenia pamięci podręcznej przy użyciu polecenia cmdlet New-AzRedisEnterpriseCache , zobacz poprzednią sekcję Aby utworzyć usługę Azure Managed Redis.

Aby zaktualizować usługę Azure Managed Redis

Wystąpienia usługi Azure Managed Redis są aktualizowane przy użyciu polecenia cmdlet [Set-AzRedisEnterpriseCache].

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

    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).

Polecenie Set-AzRedisEnterpriseCache cmdlet może służyć do aktualizowania właściwości, takich jak Sku, EnableNonSslPorti RedisConfiguration wartości.

Następujące polecenie aktualizuje zasady maxmemory-policy dla usługi Azure Managed Redis o nazwie myCache.

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

Aby uzyskać informacje o usłudze Azure Managed Redis

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.

    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).

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 Name parametrem zawierającym nazwę pamięci podręcznej i ResourceGroupName parametr z grupą zasobów zawierającą tę pamięć podręczną.

    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         :

Aby pobrać klucze dostępu dla usługi Azure Managed Redis

Aby pobrać klucze dostępu do pamięci podręcznej, możesz użyć polecenia cmdlet Get-AzRedisEnterpriseCacheKey .

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

    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).

Aby pobrać klucze pamięci podręcznej, wywołaj Get-AzRedisEnterpriseCacheKey polecenie cmdlet i przekaż nazwę pamięci podręcznej nazwę grupy zasobów zawierającej pamięć podręczną.

    PS C:\> Get-AzRedisEnterpriseCacheKey -Name myCache -ResourceGroupName myGroup

    PrimaryKey   : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
    SecondaryKey : ABhfB757JgjIgt785JgKH9865eifmekfnn649303JKL=

Aby ponownie wygenerować klucze dostępu dla usługi 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.

    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).

Aby ponownie wygenerować podstawowy lub pomocniczy klucz pamięci podręcznej, wywołaj New-AzRedisEnterpriseCacheKey polecenie cmdlet i przekaż nazwę, grupę zasobów i określ Primary parametr lub Secondary .KeyType W poniższym przykładzie pomocniczy klucz dostępu dla pamięci podręcznej jest ponownie wygenerowany.

    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=

Aby usunąć usługę Azure Managed Redis

Aby usunąć usługę Azure Managed Redis, 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.

    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).

W poniższym przykładzie pamięć podręczna o nazwie myCache zostanie usunięta.

    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

Aby zaimportować usługę Azure Managed Redis

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.

    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).

Następujące polecenie importuje dane z obiektu blob określonego przez identyfikator URI sygnatury dostępu współdzielonego do usługi 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

Aby wyeksportować usługę Azure Managed Redis

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.

    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).

Następujące polecenie eksportuje dane z wystąpienia usługi Azure Managed Redis do kontenera określonego przez identyfikator URI sygnatury dostępu współdzielonego.

    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"

Aby ponownie uruchomić usługę Azure Managed Redis (wersja zapoznawcza)

Możesz ponownie uruchomić wystąpienie usługi Azure Managed Redis (wersja zapoznawcza) przy użyciu Reset-AzRedisEnterpriseCache polecenia cmdlet .

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

    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).

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

    PS C:\>Reset-AzRedisEnterpriseCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -RebootType "AllNodes"
    -Force

Uwaga

Platforma Azure ma dwa różne modele wdrażania, których można użyć do tworzenia zasobów i pracy z nimi: usługi Azure Resource Manager i klasycznej. W tym artykule opisano użycie modelu wdrażania przy użyciu usługi Resource Manager. Zalecamy model wdrażania przy użyciu usługi Resource Manager dla nowych wdrożeń zamiast klasycznego modelu wdrażania.

Aby uzyskać więcej informacji na temat klasycznego modelu wdrażania, zobacz Azure Resource Manager vs. wdrożenie klasyczne: Omówienie modeli wdrażania i stanu zasobów.

Wymagania wstępne

Jeśli masz już zainstalowany program Azure PowerShell, musisz mieć program Azure PowerShell w wersji 1.0.0 lub nowszej. Możesz sprawdzić wersję programu Azure PowerShell za pomocą tego polecenia w wierszu polecenia programu Azure PowerShell.

    Get-Module Az | format-table version

Najpierw musisz zalogować się do platformy Azure za pomocą tego polecenia.

    Connect-AzAccount

Określ adres e-mail konta platformy Azure i hasło w oknie dialogowym logowania platformy Microsoft Azure.

Następnie, jeśli masz wiele subskrypcji platformy Azure, musisz ustawić subskrypcję platformy Azure. Aby wyświetlić listę bieżących subskrypcji, uruchom to polecenie.

    Get-AzSubscription | sort SubscriptionName | Select SubscriptionName

Aby określić subskrypcję, uruchom następujące polecenie. W poniższym przykładzie nazwa subskrypcji to ContosoSubscription.

    Select-AzSubscription -SubscriptionName ContosoSubscription

Przed rozpoczęciem korzystania z programu Windows PowerShell z usługą Azure Resource Manager należy zweryfikować konfigurację:

• Windows PowerShell, wersja 3.0 lub 4.0. Aby znaleźć wersję programu Windows PowerShell, wpisz:$PSVersionTable i sprawdź, czy wartość PSVersion to 3.0 lub 4.0. Aby zainstalować zgodną wersję, zobacz Windows Management Framework 3.0.

Aby uzyskać szczegółową pomoc dotyczącą dowolnego polecenia cmdlet widocznego w tym samouczku, użyj polecenia cmdlet Get-Help.

    Get-Help <cmdlet-name> -Detailed

Aby na przykład uzyskać pomoc dotyczącą New-AzRedisCache polecenia cmdlet, wpisz:

    Get-Help New-AzRedisCache -Detailed

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

Domyślnie środowisko platformy Azure to AzureCloud, które reprezentuje globalne wystąpienie chmury platformy Azure. Aby nawiązać połączenie z innym wystąpieniem, użyj Connect-AzAccount polecenia z przełącznikiem -Environment wiersza polecenia lubEnvironmentName z odpowiednią nazwą środowiska lub środowiska.

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

Aby nawiązać połączenie z chmurą Azure Government

Aby nawiązać połączenie z chmurą Azure Government Cloud, użyj jednego z następujących poleceń.

    Connect-AzAccount -EnvironmentName AzureUSGovernment

Or

    Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureUSGovernment)

Aby utworzyć pamięć podręczną w chmurze Azure Government, użyj jednej z następujących lokalizacji.

• USGov Wirginia
• 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).

Aby nawiązać połączenie z platformą Microsoft Azure obsługiwaną przez firmę 21Vianet Cloud

Aby nawiązać połączenie z platformą Azure obsługiwaną przez chmurę 21Vianet, użyj jednego z następujących poleceń.

    Connect-AzAccount -EnvironmentName AzureChinaCloud

Or

    Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureChinaCloud)

Aby utworzyć pamięć podręczną na platformie Azure obsługiwanej przez usługę 21Vianet Cloud, użyj jednej z następujących lokalizacji.

• Chiny Wschodnie
• Chiny Północne

Aby nawiązać połączenie z platformą Microsoft Azure (Niemcy)

Aby nawiązać połączenie z platformą Microsoft Azure (Niemcy), użyj jednego z następujących poleceń.

    Connect-AzAccount -EnvironmentName AzureGermanCloud

Or

    Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureGermanCloud)

Aby utworzyć pamięć podręczną na platformie Microsoft Azure (Niemcy), użyj jednej z następujących lokalizacji.

• Niemcy Środkowe
• Niemcy Północno-Wschodnie

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

Właściwości używane w usłudze Azure Cache for Redis PowerShell

Poniższa tabela zawiera właściwości i opisy programu Azure PowerShell dla typowych parametrów podczas tworzenia wystąpień usługi Azure Cache for Redis i zarządzania nimi.

Parametr	Opis	Wartość domyślna
Nazwisko	Nazwa pamięci podręcznej
Lokalizacja	Lokalizacja pamięci podręcznej
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, 6, 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	Określa jednostkę SKU pamięci podręcznej. Prawidłowe wartości to: Podstawowa, Standardowa, Premium	Standardowa
RedisConfiguration	Określa 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.
EnableNonSslPort	Wskazuje, czy port inny niż SSL jest włączony.	Fałsz
MaxMemoryPolicy	Ten parametr został przestarzały — zamiast tego użyj polecenia RedisConfiguration.
StaticIP	Podczas hostowania pamięci podręcznej w sieci wirtualnej określa unikatowy adres IP w podsieci pamięci podręcznej. Jeśli nie zostanie podana, zostanie wybrana jedna z podsieci.
Podsieć	Podczas hostowania pamięci podręcznej w sieci wirtualnej określa nazwę podsieci, w której ma zostać wdrożona pamięć podręczna.
VirtualNetwork	Podczas hostowania pamięci podręcznej w sieci wirtualnej określa identyfikator zasobu sieci wirtualnej, w której ma zostać wdrożona pamięć podręczna.
Typ klucza	Określa, który klucz dostępu ma być ponownie wygenerowany podczas odnawiania kluczy dostępu. Prawidłowe wartości to: Podstawowa, Pomocnicza

Właściwości redisConfiguration

Właściwości	opis	Warstwy cenowe
Obsługa kopii zapasowej bazy danych rdb	Czy włączono trwałość danych usługi Redis	Tylko wersja Premium
rdb-storage-connection-string	Parametry połączenia do konta magazynu dla trwałości danych usługi Redis	Tylko wersja Premium
rdb-backup-frequency	Częstotliwość tworzenia kopii zapasowych dla trwałości danych usługi Redis	Tylko wersja Premium
maxmemory-reserved	Konfiguruje pamięć zarezerwowaną dla procesów innych niż pamięć podręczna	Standardowa i Premium
maxmemory-policy	Konfiguruje zasady eksmisji dla pamięci podręcznej	Wszystkie warstwy cenowe
notify-keyspace-events	Konfiguruje powiadomienia dotyczące przestrzeni kluczy	Standardowa i Premium
hash-max-ziplist-entries	Konfiguruje optymalizację pamięci dla małych zagregowanych typów danych	Standardowa i Premium
hash-max-ziplist-value	Konfiguruje optymalizację pamięci dla małych zagregowanych typów danych	Standardowa i Premium
set-max-intset-entries	Konfiguruje optymalizację pamięci dla małych zagregowanych typów danych	Standardowa i Premium
zset-max-ziplist-entries	Konfiguruje optymalizację pamięci dla małych zagregowanych typów danych	Standardowa i Premium
zset-max-ziplist-value	Konfiguruje optymalizację pamięci dla małych zagregowanych typów danych	Standardowa i Premium
bazy danych	Konfiguruje liczbę baz danych. Tę właściwość można skonfigurować tylko podczas tworzenia pamięci podręcznej.	Standardowa i Premium

Aby utworzyć usługę Azure Cache for Redis

Nowe wystąpienia usługi Azure Cache for Redis są tworzone przy użyciu polecenia cmdlet New-AzRedisCache .

Ważne

Przy pierwszym utworzeniu usługi Azure Cache for Redis w subskrypcji przy użyciu witryny Azure Portal portal rejestruje Microsoft.Cache przestrzeń nazw dla tej subskrypcji. Jeśli spróbujesz utworzyć pierwszą usługę Azure Cache for Redis w subskrypcji przy użyciu programu PowerShell, musisz najpierw zarejestrować tę przestrzeń nazw przy użyciu następującego polecenia; w przeciwnym razie polecenia cmdlet, takie jak New-AzRedisCache i Get-AzRedisCache niepowodzenie.

Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache"

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

    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).

Aby utworzyć pamięć podręczną z domyślnymi parametrami, uruchom następujące polecenie.

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

ResourceGroupName, Namei Location są wymaganymi parametrami, ale pozostałe są opcjonalne i mają wartości domyślne. Uruchomienie poprzedniego polecenia powoduje utworzenie wystąpienia usługi Azure Cache for Redis w warstwie Standardowa z określoną nazwą, lokalizacją i grupą zasobów. Wystąpienie ma rozmiar 1 GB z wyłączonym portem bez protokołu SSL.

Aby utworzyć pamięć podręczną w warstwie Premium, określ rozmiar P1 (6 GB – 60 GB), P2 (13 GB – 130 GB), P3 (26 GB – 260 GB) lub P4 (53 GB – 530 GB– 530 GB). Aby włączyć klastrowanie, określ liczbę fragmentów przy użyciu parametru ShardCount . W poniższym przykładzie zostanie utworzona pamięć podręczna P1 w warstwie Premium z trzema fragmentami. Pamięć podręczna P1 Premium ma rozmiar 6 GB, a ponieważ określono trzy fragmenty, 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

Aby określić wartości parametru RedisConfiguration , należy ująć wartości wewnątrz {} jako pary klucz/wartość, takie jak @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}. Poniższy przykład tworzy standardową pamięć podręczną o rozmiarze 1 GB z zasadami allkeys-random maxmemory i powiadomieniami o przestrzeni kluczy skonfigurowanymi przy użyciu polecenia 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"}

Aby skonfigurować ustawienie baz danych podczas tworzenia pamięci podręcznej

Ustawienie databases można skonfigurować tylko podczas tworzenia pamięci podręcznej. W poniższym przykładzie jest tworzona pamięć podręczna premium P3 (26 GB) z 48 bazami danych przy użyciu polecenia cmdlet New-AzRedisCache .

    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. Aby uzyskać więcej informacji na temat tworzenia pamięci podręcznej przy użyciu polecenia cmdlet New-AzRedisCache , zobacz poprzednią sekcję Aby utworzyć pamięć podręczną Azure Cache for Redis.

Aby zaktualizować usługę 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.

    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).

Polecenie Set-AzRedisCache cmdlet może służyć do aktualizowania właściwości, takich jak Size, Sku, EnableNonSslPorti RedisConfiguration wartości.

Następujące polecenie aktualizuje zasady maxmemory-policy dla usługi Azure Cache for Redis o nazwie myCache.

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

Skalowanie usługi Azure Cache for Redis

Set-AzRedisCache Można użyć do skalowania wystąpienia usługi Azure Cache for Redis w przypadku Sizemodyfikacji właściwości , Skulub ShardCount .

Uwaga

Skalowanie pamięci podręcznej przy użyciu programu PowerShell podlega tym samym limitom i wytycznymi co skalowanie pamięci podręcznej z 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 warstwy cenowej.
• Nie można skalować z pamięci podręcznej Premium w dół do pamięci podręcznej w warstwie Standardowa lub Podstawowa.
• Nie można skalować z pamięci podręcznej w warstwie Standardowa do pamięci podręcznej w warstwie Podstawowa.
• 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ć kolejną operację skalowania do żądanego rozmiaru.
• Nie można skalować z pamięci podręcznej w warstwie Podstawowa bezpośrednio do pamięci podręcznej Premium. Należy skalować z warstwy Podstawowa do Standardowa w ramach jednej operacji skalowania, a następnie z warstwy Standardowa do Warstwy Premium w kolejnej operacji skalowania.
• 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 pamięci podręcznej o rozmiarze 2,5 GB. To polecenie działa zarówno dla pamięci podręcznej w warstwie Podstawowa, jak i Standardowa.

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

Po wydaniu tego polecenia zostanie zwrócony stan pamięci podręcznej---similar do wywołania metody Get-AzRedisCache. Właściwość jest ustawiona ProvisioningState na Scalingwartość .

    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 zakończeniu operacji skalowania zmienia się ProvisioningState wartość Succeeded. Jeśli musisz wykonać inną operację skalowania--- na przykład zmiana z warstwy Podstawowa na Standardowa, a następnie zmiana rozmiaru--- musisz poczekać, aż poprzednia operacja zostanie ukończona lub zostanie wyświetlony błąd podobny do poniższego.

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

Aby uzyskać informacje o usłudze 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.

    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).

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, uruchom polecenie Get-AzRedisCache z Name parametrem zawierającym nazwę pamięci podręcznej i ResourceGroupName parametr z grupą zasobów zawierającą tę pamięć podręczną.

    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         :

Aby pobrać klucze dostępu dla usługi 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.

    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).

Aby pobrać klucze pamięci podręcznej, wywołaj Get-AzRedisCacheKey polecenie cmdlet i przekaż nazwę pamięci podręcznej nazwę grupy zasobów zawierającej pamięć podręczną.

    PS C:\> Get-AzRedisCacheKey -Name myCache -ResourceGroupName myGroup

    PrimaryKey   : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
    SecondaryKey : ABhfB757JgjIgt785JgKH9865eifmekfnn649303JKL=

Aby ponownie wygenerować klucze dostępu dla usługi 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.

    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).

Aby ponownie wygenerować podstawowy lub pomocniczy klucz pamięci podręcznej, wywołaj New-AzRedisCacheKey polecenie cmdlet i przekaż nazwę, grupę zasobów i określ Primary parametr lub Secondary .KeyType W poniższym przykładzie pomocniczy klucz dostępu dla pamięci podręcznej jest ponownie wygenerowany.

    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=

Aby usunąć usługę Azure Cache for Redis

Aby usunąć usługę 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.

    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).

W poniższym przykładzie pamięć podręczna o nazwie myCache zostanie usunięta.

    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

Aby zaimportować usługę 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/eksportowanie jest dostępne tylko dla pamięci podręcznych w warstwie Premium. Aby uzyskać więcej informacji na temat importowania/eksportowania, 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.

    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).

Następujące polecenie importuje dane z obiektu blob określonego przez identyfikator URI sygnatury dostępu współdzielonego do usługi 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

Aby wyeksportować usługę 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

Importowanie/eksportowanie jest dostępne tylko dla pamięci podręcznych w warstwie Premium. Aby uzyskać więcej informacji na temat importowania/eksportowania, 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.

    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).

Następujące polecenie eksportuje dane z wystąpienia usługi Azure Cache for Redis do kontenera określonego przez identyfikator URI sygnatury dostępu współdzielonego.

    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"

Aby ponownie uruchomić 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

Ponowny rozruch jest dostępny tylko dla pamięci podręcznych w warstwie Podstawowa, Standardowa i Premium. Aby uzyskać więcej informacji na temat ponownego uruchamiania pamięci podręcznej, 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.

    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).

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

    PS C:\>Reset-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -RebootType "AllNodes"
    -Force

Następne kroki

Aby dowiedzieć się więcej na temat korzystania z programu Windows PowerShell z platformą Azure, zobacz następujące zasoby:

• Dokumentacja poleceń cmdlet usługi Azure Cache for Redis w witrynie MSDN
• Polecenia cmdlet usługi Azure Resource Manager: dowiedz się, jak używać poleceń cmdlet w module usługi Azure Resource Manager.
• Używanie grup zasobów do zarządzania zasobami platformy Azure: dowiedz się, jak tworzyć grupy zasobów i zarządzać nimi w witrynie Azure Portal.
• Blog platformy Azure: Informacje o nowych funkcjach na platformie Azure.
• Blog programu Windows PowerShell: informacje o nowych funkcjach w programie Windows PowerShell.
• "Hej, Scripting Guy!" Blog: Uzyskiwanie rzeczywistych wskazówek i wskazówek od społeczności programu Windows PowerShell.