Hantera Azure Redis med Azure PowerShell

• PowerShell
• Azure CLI

Azure Managed Redis

1. Om du vill skapa en Azure Managed Redis-instans (förhandsversion) loggar du in på Azure Portal och väljer Skapa en resurs.

2. På sidan Nytt väljer du Databaser och sedan Azure Cache for Redis.

3. På sidan Ny Redis Cache konfigurerar du inställningarna för din nya cache.

   Inställning	Välj ett värde	beskrivning
   Abonnemang	Listrutan och välj din prenumeration.	Den prenumeration som den nya Azure Managed Redis-instansen ska skapas under.
   Resursgrupp	Listrutan och välj en resursgrupp eller välj Skapa ny och ange ett nytt resursgruppsnamn.	Namn på den resursgrupp där cacheminnet och andra resurser ska skapas. Genom att placera alla dina appresurser i en resursgrupp kan du enkelt hantera eller ta bort dem tillsammans.
   DNS-namn	Ange ett namn som är unikt i regionen.	Cachenamnet måste vara en sträng mellan 1 och 63 tecken när det kombineras med cachens regionnamn som endast innehåller siffror, bokstäver eller bindestreck. (Om cachenamnet är mindre än 45 tecken bör det fungera i alla tillgängliga regioner.) Namnet måste börja och sluta med ett tal eller en bokstav och får inte innehålla bindestreck i följd. Värdnamnet för cacheinstansen är \<DNS name\>.\<Azure region\>.redis.azure.net.
   Plats	Listrutan och välj en plats.	Azure Managed Redis är tillgängligt i valda Azure-regioner.
   Cachetyp	Listrutan och välj prestandanivå och cachestorlek.	Nivån avgör prestanda för Redis-instansen, medan cachestorleken avgör vilket minne som är tillgängligt för lagring av data. Vägledning om hur du väljer rätt prestandanivå finns i Chosing the right tier (Välja rätt nivå)

   

4. Välj Nästa: Nätverk och välj antingen en offentlig eller privat slutpunkt.

5. Välj Nästa: Avancerat. Här kan du konfigurera alla Redis-moduler som ska läggas till i instansen.

   Ange Klustringsprincip till Företag för en icke-grupperad cache eller till OSS för en klustrad cache. Mer information om hur du väljer klustringsprincip finns i Klusterprincip.

   

   Om du använder aktiv geo-replikering måste den konfigureras när du skapar den. Anvisningar om hur du gör för detta finns i Konfigurera aktiv geo-replikering för Azure Managed Redis-instanser.

   Viktigt!

   Du kan inte ändra klustringsprincipen för en Azure Managed Redis-instans (förhandsversion) när du har skapat den. Om du använder RediSearch krävs enterprise-klusterprincipen och NoEviction är den enda borttagningsprincipen som stöds.

   Viktigt!

   Om du använder den här cacheinstansen i en geo-replikeringsgrupp kan borttagningsprinciper inte ändras när instansen har skapats. Se till att känna till borttagningsprinciperna för dina primära noder innan du skapar cacheminnet. Mer information om aktiv geo-replikering finns i Krav för aktiv geo-replikering.

   Viktigt!

   Du kan inte ändra moduler när du har skapat en cacheinstans. Moduler måste aktiveras när du skapar en Azure Cache for Redis-instans. Det finns inget alternativ för att aktivera konfigurationen av en modul när du har skapat en cache.

6. Välj Nästa: Taggar och hoppa över.

7. Välj Nästa: Granska + skapa.

   

8. Granska inställningarna och välj Skapa.

   Det tar flera minuter innan Redis-instansen skapas. Du kan övervaka förloppet på översiktssidan för Azure Managed Redis. När Status visas som Körs är cachen redo att användas.

Azure Cache for Redis

1. Om du vill skapa en cache loggar du in på Azure Portal. På portalmenyn väljer du Skapa en resurs.

   

2. I fönstret Kom igång anger du Azure Cache for Redis i sökfältet. I sökresultaten letar du upp Azure Cache for Redis och väljer sedan Skapa.

   

3. I fönstret Ny Redis Cache på fliken Grundläggande konfigurerar du följande inställningar för din cache:

   Inställning	Åtgärd	beskrivning
   Abonnemang	Välj din Azure-prenumerationen.	Prenumerationen som ska användas för att skapa den nya instansen av Azure Cache for Redis.
   Resursgrupp	Välj en resursgrupp eller välj Skapa ny och ange ett nytt resursgruppsnamn.	Ett namn på resursgruppen där du kan skapa cacheminnet och andra resurser. Genom att placera alla dina appresurser i en resursgrupp kan du enkelt hantera eller ta bort dem tillsammans.
   DNS-namn	Ange ett unikt namn.	Cachenamnet måste vara en sträng på 1 till 63 tecken som endast innehåller siffror, bokstäver och bindestreck. Namnet måste börja och sluta med ett tal eller en bokstav, och det får inte innehålla bindestreck i följd. Värdnamnet för cacheinstansen är \<DNS name>.redis.cache.windows.net.
   Plats	Välj en plats.	En Azure-region som ligger nära andra tjänster som använder din cache.
   Cache-SKU	Välj en SKU.	SKU:n avgör vilka storleks-, prestanda- och funktionsparametrar som är tillgängliga för cachen. Mer information finns i Översikt över Azure Cache for Redis.
   Cachestorlek	Välj en cachestorlek.	Mer information finns i Översikt över Azure Cache for Redis.

4. Välj fliken Nätverk eller välj Nästa: Nätverk.

5. På fliken Nätverk väljer du en anslutningsmetod som ska användas för cacheminnet.

6. Välj fliken Avancerat eller välj Nästa: Avancerat.

7. I fönstret Avancerat kontrollerar eller väljer du en autentiseringsmetod baserat på följande information:

   

   • Som standard aktiveras Microsoft Entra-autentisering för en ny Basic-, Standard- eller Premium-cache och åtkomstnycklarnas autentisering inaktiveras.
   • För Basic- eller Standard-cacheminnen kan du välja valet för en icke-TLS-port.
   • För Standard- och Premium-cacheminnen kan du välja att aktivera tillgänglighetszoner. Du kan inte inaktivera tillgänglighetszoner när cacheminnet har skapats.
   • För en Premium-cache konfigurerar du inställningarna för icke-TLS-port, klustring, hanterad identitet och datapersistence.

   Viktigt!

   För optimal säkerhet rekommenderar vi att du använder Microsoft Entra-ID med hanterade identiteter för att auktorisera begäranden mot din cache om möjligt. Auktorisering med hjälp av Microsoft Entra-ID och hanterade identiteter ger överlägsen säkerhet och användarvänlighet för auktorisering av delad åtkomstnyckel. Mer information om hur du använder hanterade identiteter med din cache finns i Använda Microsoft Entra-ID för cacheautentisering.

8. (Valfritt) Välj fliken Taggar eller välj Nästa: Taggar.

9. (Valfritt) På fliken Taggar anger du ett taggnamn och värde om du vill kategorisera cacheresursen.

10. Välj knappen Granska + skapa.

    På fliken Granska + skapa verifierar Azure automatiskt din konfiguration.

11. När det gröna verifieringsmeddelandet har skickats väljer du Skapa.

En ny cachedistribution sker under flera minuter. Du kan övervaka förloppet för distributionen i översiktsfönstret Azure Cache for Redis. När Status visar Körs är cachen redo att användas.

Den här artikeln visar hur du skapar, uppdaterar och skalar dina Azure Redis-instanser.

Kommentar

Azure har två olika distributionsmodeller som du kan använda för att skapa och arbeta med resurser: Azure Resource Manager och klassisk. Den här artikeln beskriver användningen av Resource Manager-distributionsmodellen. Vi rekommenderar Resource Manager-distributionsmodellen för nya distributioner i stället för den klassiska distributionsmodellen.

Mer information om den klassiska distributionsmodellen finns i Azure Resource Manager jämfört med klassisk distribution: Förstå distributionsmodeller och tillståndet för dina resurser.

Förutsättningar

Om du redan har installerat Azure PowerShell måste du ha Azure PowerShell version 12.4.0 eller senare. Du kan kontrollera versionen av Azure PowerShell med det här kommandot i Azure PowerShell-kommandotolken.

    Get-Module Az | format-table version

Först måste du logga in på Azure med det här kommandot.

    Connect-AzAccount

Ange e-postadressen för ditt Azure-konto och ditt lösenord i microsoft Azure-inloggningsdialogrutan.

Om du sedan har flera Azure-prenumerationer måste du ange din Azure-prenumeration. Om du vill se en lista över dina aktuella prenumerationer kör du det här kommandot.

    Get-AzSubscription | sort SubscriptionName | Select SubscriptionName

Om du vill ange prenumerationen kör du följande kommando. I följande exempel är ContosoSubscriptionprenumerationsnamnet .

    Select-AzSubscription -SubscriptionName ContosoSubscription

Innan du kan använda Windows PowerShell med Azure Resource Manager måste du kontrollera konfigurationen:

• Windows PowerShell, version 3.0 eller 4.0. Om du vill hitta versionen av Windows PowerShell skriver du:$PSVersionTable och kontrollerar att värdet PSVersion för är 3.0 eller 4.0. Information om hur du installerar en kompatibel version finns i Windows Management Framework 3.0.

Om du vill få detaljerad hjälp för alla cmdletar som du ser i den här självstudien använder du cmdleten Get-Help.

    Get-Help <cmdlet-name> -Detailed

Om du till exempel vill få hjälp med cmdleten New-AzRedisEnterpriseCache skriver du:

    Get-Help New-AzRedisEnterpriseCache -Detailed

Ansluta till andra moln

Som standard är AzureCloudAzure-miljön , som representerar den globala Azure-molninstansen. Om du vill ansluta till en annan instans använder Connect-AzAccount du kommandot med -Environment kommandoradsväxeln eller medEnvironmentName det miljö- eller miljönamn som du vill använda.

Om du vill se listan över tillgängliga miljöer kör du cmdleten Get-AzEnvironment .

Ansluta till Azure Government Cloud

Om du vill ansluta till Azure Government Cloud använder du något av följande kommandon.

    Connect-AzAccount -EnvironmentName AzureUSGovernment

Eller

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

Om du vill skapa en cache i Azure Government Cloud använder du någon av följande platser.

• USGov Virginia
• USGov Iowa

Mer information om Azure Government Cloud finns i Utvecklarguide för Microsoft Azure Government och Microsoft Azure Government.

Ansluta till Microsoft Azure som drivs av 21Vianet Cloud

Om du vill ansluta till Azure som drivs av 21Vianet-molnet använder du något av följande kommandon.

    Connect-AzAccount -EnvironmentName AzureChinaCloud

Eller

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

Om du vill skapa en cache i Azure som drivs av 21Vianet Cloud använder du någon av följande platser.

• Kina, östra
• Kina, norra

Ansluta till Microsoft Azure Tyskland

Om du vill ansluta till Microsoft Azure Tyskland använder du något av följande kommandon.

    Connect-AzAccount -EnvironmentName AzureGermanCloud

Eller

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

Om du vill skapa en cache i Microsoft Azure Tyskland använder du någon av följande platser.

• Tyskland, centrala
• Tyskland, nordöstra

Mer information om Microsoft Azure Tyskland finns i Microsoft Azure Tyskland.

Azure Managed Redis PowerShell-parametrar och egenskaper

En lista över alla Azure Managed Redis PowerShell-parametrar och egenskaper finns i New-AzRedisEnterpriseCache.

Så här skapar du en Azure Managed Redis

Nya Azure Managed Redis-instanser skapas med cmdleten New-AzRedisEnterpriseCache .

Viktigt!

Första gången du skapar en Azure Managed Redis i en prenumeration med hjälp av Azure Portal registrerar portalen namnområdet för den prenumerationenMicrosoft.Cache. Om du försöker skapa den första Azure Managed Redis i en prenumeration med hjälp av PowerShell måste du först registrera namnområdet med hjälp av följande kommando. annars cmdletar som New-AzRedisEnterpriseCache och Get-AzRedisEnterpriseCache misslyckas.

Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache"

Om du vill se en lista över tillgängliga parametrar och deras beskrivningar för New-AzRedisEnterpriseCachekör du följande kommando.

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

Kör följande kommando för att skapa en cache med standardparametrar.

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

ResourceGroupName, Name, och Location är obligatoriska parametrar, men resten är valfria och har standardvärden. När du kör föregående kommando skapas en Azure Managed Redis-instans med angivet namn, plats och resursgrupp. Instansen är 1 GB i storlek med icke-SSL-porten inaktiverad.

Om du vill aktivera klustring anger du ett shardantal med hjälp av parametern ShardCount .

Om du vill ange värden för parametern RedisConfiguration omger du värdena inuti {} som nyckel/värde-par som @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}. I följande exempel skapas en 1 GB cache med allkeys-random maxmemory-princip- och keyspace-meddelanden som konfigurerats med KEA. Mer information finns i Keyspace-meddelanden (avancerade inställningar) och Minnesprinciper.

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

Så här konfigurerar du databasinställningen när cacheminnet skapas

Inställningen databases kan endast konfigureras när cacheminnet skapas. I följande exempel skapas en cache med 48 databaser med cmdleten New-AzRedisEnterpriseCache .

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

Mer information om egenskapen finns i Standardkonfiguration för databases Azure Managed Redis-server. Mer information om hur du skapar en cache med hjälp av cmdleten New-AzRedisEnterpriseCache finns i föregående avsnitt Om du vill skapa en Azure Managed Redis.

Så här uppdaterar du en Azure Managed Redis

Azure Managed Redis-instanser uppdateras med cmdleten [Set-AzRedisEnterpriseCache].

Om du vill se en lista över tillgängliga parametrar och deras beskrivningar för Set-AzRedisEnterpriseCachekör du följande kommando.

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

Cmdleten Set-AzRedisEnterpriseCache kan användas för att uppdatera egenskaper som Sku, EnableNonSslPortoch RedisConfiguration värdena.

Följande kommando uppdaterar maxmemory-policyn för Azure Managed Redis med namnet myCache.

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

Så här hämtar du information om en Azure Managed Redis

Du kan hämta information om en cache med hjälp av cmdleten Get-AzRedisEnterpriseCache .

Om du vill se en lista över tillgängliga parametrar och deras beskrivningar för Get-AzRedisEnterpriseCachekör du följande kommando.

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

Om du vill returnera information om alla cacheminnen i den aktuella prenumerationen kör du Get-AzRedisEnterpriseCache utan parametrar.

    Get-AzRedisEnterpriseCache

Om du vill returnera information om alla cacheminnen i en specifik resursgrupp kör du Get-AzRedisEnterpriseCache med parametern ResourceGroupName .

    Get-AzRedisEnterpriseCache -ResourceGroupName myGroup

Om du vill returnera information om en specifik cache kör Get-AzRedisEnterpriseCache du med parametern Name som innehåller namnet på cachen och parametern ResourceGroupName med resursgruppen som innehåller cacheminnet.

    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         :

Hämta åtkomstnycklarna för en Azure Managed Redis

Om du vill hämta åtkomstnycklarna för cacheminnet kan du använda cmdleten Get-AzRedisEnterpriseCacheKey .

Om du vill se en lista över tillgängliga parametrar och deras beskrivningar för Get-AzRedisEnterpriseCacheKeykör du följande kommando.

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

Om du vill hämta nycklarna för cacheminnet anropar du cmdleten Get-AzRedisEnterpriseCacheKey och skickar namnet på cachen till namnet på den resursgrupp som innehåller cacheminnet.

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

    PrimaryKey   : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
    SecondaryKey : ABhfB757JgjIgt785JgKH9865eifmekfnn649303JKL=

Återskapa åtkomstnycklar för din Azure Managed Redis

Om du vill återskapa åtkomstnycklarna för cacheminnet kan du använda cmdleten New-AzRedisEnterpriseCacheKey .

Om du vill se en lista över tillgängliga parametrar och deras beskrivningar för New-AzRedisEnterpriseCacheKeykör du följande kommando.

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

Om du vill återskapa den primära eller sekundära nyckeln för cacheminnet anropar du cmdleten New-AzRedisEnterpriseCacheKey och skickar in namnet, resursgruppen och anger antingen Primary eller Secondary för parametern KeyType . I följande exempel återskapas den sekundära åtkomstnyckeln för en cache.

    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=

Ta bort en Azure Managed Redis

Om du vill ta bort en Azure Managed Redis använder du cmdleten Remove-AzRedisEnterpriseCache .

Om du vill se en lista över tillgängliga parametrar och deras beskrivningar för Remove-AzRedisEnterpriseCachekör du följande kommando.

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

I följande exempel tas cachen med namnet myCache bort.

    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

Så här importerar du en Azure Managed Redis

Du kan importera data till en Azure Managed Redis-instans med hjälp av cmdleten Import-AzRedisEnterpriseCache .

Om du vill se en lista över tillgängliga parametrar och deras beskrivningar för Import-AzRedisEnterpriseCachekör du följande kommando.

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

Följande kommando importerar data från den blob som anges av SAS-URI:n till 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

Så här exporterar du en Azure Managed Redis

Du kan exportera data från en Azure Managed Redis-instans med hjälp av cmdleten Export-AzRedisEnterpriseCache .

Om du vill se en lista över tillgängliga parametrar och deras beskrivningar för Export-AzRedisEnterpriseCachekör du följande kommando.

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

Följande kommando exporterar data från en Azure Managed Redis-instans till containern som anges av SAS-URI:n.

    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"

Starta om en Azure Managed Redis (förhandsversion)

Du kan starta om din Azure Managed Redis-instans (förhandsversion) med hjälp av cmdleten Reset-AzRedisEnterpriseCache .

Om du vill se en lista över tillgängliga parametrar och deras beskrivningar för Reset-AzRedisEnterpriseCachekör du följande kommando.

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

Följande kommando startar om båda noderna i den angivna cachen.

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

Kommentar

Azure har två olika distributionsmodeller som du kan använda för att skapa och arbeta med resurser: Azure Resource Manager och klassisk. Den här artikeln beskriver användningen av Resource Manager-distributionsmodellen. Vi rekommenderar Resource Manager-distributionsmodellen för nya distributioner i stället för den klassiska distributionsmodellen.

Mer information om den klassiska distributionsmodellen finns i Azure Resource Manager jämfört med klassisk distribution: Förstå distributionsmodeller och tillståndet för dina resurser.

Förutsättningar

Om du redan har installerat Azure PowerShell måste du ha Azure PowerShell version 1.0.0 eller senare. Du kan kontrollera versionen av Azure PowerShell med det här kommandot i Azure PowerShell-kommandotolken.

    Get-Module Az | format-table version

Först måste du logga in på Azure med det här kommandot.

    Connect-AzAccount

Ange e-postadressen för ditt Azure-konto och ditt lösenord i microsoft Azure-inloggningsdialogrutan.

Om du sedan har flera Azure-prenumerationer måste du ange din Azure-prenumeration. Om du vill se en lista över dina aktuella prenumerationer kör du det här kommandot.

    Get-AzSubscription | sort SubscriptionName | Select SubscriptionName

Om du vill ange prenumerationen kör du följande kommando. I följande exempel är ContosoSubscriptionprenumerationsnamnet .

    Select-AzSubscription -SubscriptionName ContosoSubscription

Innan du kan använda Windows PowerShell med Azure Resource Manager måste du kontrollera konfigurationen:

• Windows PowerShell, version 3.0 eller 4.0. Om du vill hitta versionen av Windows PowerShell skriver du:$PSVersionTable och kontrollerar att värdet PSVersion för är 3.0 eller 4.0. Information om hur du installerar en kompatibel version finns i Windows Management Framework 3.0.

Om du vill få detaljerad hjälp för alla cmdletar som du ser i den här självstudien använder du cmdleten Get-Help.

    Get-Help <cmdlet-name> -Detailed

Om du till exempel vill få hjälp med cmdleten New-AzRedisCache skriver du:

    Get-Help New-AzRedisCache -Detailed

Ansluta till andra moln

Som standard är AzureCloudAzure-miljön , som representerar den globala Azure-molninstansen. Om du vill ansluta till en annan instans använder Connect-AzAccount du kommandot med -Environment kommandoradsväxeln eller medEnvironmentName det miljö- eller miljönamn som du vill använda.

Om du vill se listan över tillgängliga miljöer kör du cmdleten Get-AzEnvironment .

Ansluta till Azure Government Cloud

Om du vill ansluta till Azure Government Cloud använder du något av följande kommandon.

    Connect-AzAccount -EnvironmentName AzureUSGovernment

Eller

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

Om du vill skapa en cache i Azure Government Cloud använder du någon av följande platser.

• USGov Virginia
• USGov Iowa

Mer information om Azure Government Cloud finns i Utvecklarguide för Microsoft Azure Government och Microsoft Azure Government.

Ansluta till Microsoft Azure som drivs av 21Vianet Cloud

Om du vill ansluta till Azure som drivs av 21Vianet-molnet använder du något av följande kommandon.

    Connect-AzAccount -EnvironmentName AzureChinaCloud

Eller

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

Om du vill skapa en cache i Azure som drivs av 21Vianet Cloud använder du någon av följande platser.

• Kina, östra
• Kina, norra

Ansluta till Microsoft Azure Tyskland

Om du vill ansluta till Microsoft Azure Tyskland använder du något av följande kommandon.

    Connect-AzAccount -EnvironmentName AzureGermanCloud

Eller

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

Om du vill skapa en cache i Microsoft Azure Tyskland använder du någon av följande platser.

• Tyskland, centrala
• Tyskland, nordöstra

Mer information om Microsoft Azure Tyskland finns i Microsoft Azure Tyskland.

Egenskaper som används för Azure Cache for Redis PowerShell

Följande tabell innehåller Azure PowerShell-egenskaper och beskrivningar för vanliga parametrar när du skapar och hanterar dina Azure Cache for Redis-instanser.

Parameter	Description	Standard
Name	Namnet på cachen
Plats	Platsen för cachen
ResourceGroupName	Namn på resursgrupp där cacheminnet ska skapas
Storlek	Cachens storlek. Giltiga värden är: P1, P2, P3, P4, P5, C0, C1, C2, C3, C4, C5, C6, 250MB, 1GB, 2.5GB, 6GB, 13GB, 26GB, 53GB	1 GB
ShardCount	Antalet shards som ska skapas när du skapar en Premium-cache med klustring aktiverat. Giltiga värden är: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
SKU	Anger SKU:n för cacheminnet. Giltiga värden är: Basic, Standard, Premium	Standard
RedisConfiguration	Anger Redis-konfigurationsinställningar. Mer information om varje inställning finns i följande redisConfiguration-egenskapstabell .
EnableNonSslPort	Anger om icke-SSL-porten är aktiverad.	Falsk
MaxMemoryPolicy	Den här parametern har blivit inaktuell – använd RedisConfiguration i stället.
StaticIP	När du är värd för din cache i ett virtuellt nätverk anger du en unik IP-adress i undernätet för cachen. Om det inte anges väljs en åt dig från undernätet.
Undernät	När du är värd för din cache i ett virtuellt nätverk anger du namnet på det undernät som cachen ska distribueras i.
VirtualNetwork	När du är värd för din cache i ett virtuellt nätverk anger du resurs-ID för det virtuella nätverk där cachen ska distribueras.
KeyType	Anger vilken åtkomstnyckel som ska återskapas när åtkomstnycklar förnyas. Giltiga värden är: Primär, Sekundär

RedisConfiguration-egenskaper

Property	beskrivning	Prisnivåer
rdb-backup-enabled	Om Redis-datapersistence är aktiverat	Endast Premium
rdb-storage-connection-string	Anslutningssträng till lagringskontot för Redis-datapersistence	Endast Premium
rdb-backup-frequency	Säkerhetskopieringsfrekvensen för Redis-datapersistence	Endast Premium
maxmemory-reserved	Konfigurerar minnet som är reserverat för processer som inte är cachelagrade	Standard och Premium
maxmemory-policy	Konfigurerar borttagningsprincipen för cacheminnet	Alla prisnivåer
notify-keyspace-events	Konfigurerar keyspace-meddelanden	Standard och Premium
hash-max-ziplist-entries	Konfigurerar minnesoptimering för små mängddatatyper	Standard och Premium
hash-max-ziplist-value	Konfigurerar minnesoptimering för små mängddatatyper	Standard och Premium
set-max-intset-entries	Konfigurerar minnesoptimering för små mängddatatyper	Standard och Premium
zset-max-ziplist-entries	Konfigurerar minnesoptimering för små mängddatatyper	Standard och Premium
zset-max-ziplist-value	Konfigurerar minnesoptimering för små mängddatatyper	Standard och Premium
databaser	Konfigurerar antalet databaser. Den här egenskapen kan endast konfigureras när cacheminnet skapas.	Standard och Premium

Så här skapar du en Azure Cache for Redis

Nya Azure Cache for Redis-instanser skapas med cmdleten New-AzRedisCache .

Viktigt!

Första gången du skapar en Azure Cache for Redis i en prenumeration med hjälp av Azure Portal registrerar portalen namnområdet för den prenumerationenMicrosoft.Cache. Om du försöker skapa den första Azure Cache for Redis i en prenumeration med Hjälp av PowerShell måste du först registrera namnområdet med hjälp av följande kommando. annars cmdletar som New-AzRedisCache och Get-AzRedisCache misslyckas.

Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache"

Om du vill se en lista över tillgängliga parametrar och deras beskrivningar för New-AzRedisCachekör du följande kommando.

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

Kör följande kommando för att skapa en cache med standardparametrar.

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

ResourceGroupName, Name, och Location är obligatoriska parametrar, men resten är valfria och har standardvärden. När du kör föregående kommando skapas en Standard SKU Azure Cache for Redis-instans med det angivna namnet, platsen och resursgruppen. Instansen är 1 GB i storlek med icke-SSL-porten inaktiverad.

Om du vill skapa en Premium-cache anger du storleken P1 (6 GB – 60 GB), P2 (13 GB – 130 GB), P3 (26 GB – 260 GB) eller P4 (53 GB – 530 GB). Om du vill aktivera klustring anger du ett shardantal med hjälp av parametern ShardCount . I följande exempel skapas en P1 Premium-cache med tre shards. En P1 Premium-cache är 6 GB stor och eftersom vi har angett tre shards är den totala storleken 18 GB (3 x 6 GB).

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

Om du vill ange värden för parametern RedisConfiguration omger du värdena inuti {} som nyckel/värde-par som @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}. I följande exempel skapas en standardcache på 1 GB med allkeys-random maxmemory-princip- och keyspace-meddelanden som konfigurerats med KEA. Mer information finns i Keyspace-meddelanden (avancerade inställningar) och Minnesprinciper.

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

Så här konfigurerar du databasinställningen när cacheminnet skapas

Inställningen databases kan endast konfigureras när cacheminnet skapas. I följande exempel skapas en Premium P3-cache (26 GB) med 48 databaser med cmdleten New-AzRedisCache .

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

Mer information om egenskapen finns i Standardkonfiguration för databases Azure Cache for Redis-server. Mer information om hur du skapar en cache med hjälp av cmdleten New-AzRedisCache finns i föregående avsnitt Om du vill skapa en Azure Cache for Redis.

Uppdatera en Azure Cache for Redis

Azure Cache for Redis-instanser uppdateras med hjälp av cmdleten Set-AzRedisCache .

Om du vill se en lista över tillgängliga parametrar och deras beskrivningar för Set-AzRedisCachekör du följande kommando.

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

Cmdleten Set-AzRedisCache kan användas för att uppdatera egenskaper som Size, Sku, EnableNonSslPortoch RedisConfiguration värdena.

Följande kommando uppdaterar maxmemory-policyn för Azure Cache for Redis med namnet myCache.

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

Skala en Azure Cache for Redis

Set-AzRedisCache kan användas för att skala en Azure Cache for Redis-instans när Sizeegenskaperna , Skueller ShardCount ändras.

Kommentar

Skalning av en cache med PowerShell omfattas av samma gränser och riktlinjer som att skala en cache från Azure Portal. Du kan skala till en annan prisnivå med följande begränsningar.

• Du kan inte skala från en högre prisnivå till en lägre prisnivå.
• Du kan inte skala från en Premium-cache till en Standard- eller Basic-cache.
• Du kan inte skala från en Standard-cache till en Basic-cache .
• Du kan skala från en Basic-cache till en Standard-cache , men du kan inte ändra storleken på samma gång. Om du behöver en annan storlek kan du utföra en efterföljande skalningsåtgärd till önskad storlek.
• Du kan inte skala från en Basic-cache direkt till en Premium-cache . Du måste skala från Basic till Standard i en skalningsåtgärd och sedan från Standard till Premium i en efterföljande skalningsåtgärd.
• Du kan inte skala från en större storlek ned till storleken C0 (250 MB).

Mer information finns i Skala Azure Cache for Redis.

I följande exempel visas hur du skalar en cache med namnet myCache till en cache på 2,5 GB. Det här kommandot fungerar för både en Basic- eller Standard-cache.

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

När det här kommandot har utfärdats returneras statusen för cacheminnet---similar till anropet Get-AzRedisCache. ProvisioningState är inställt på Scaling.

    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         :

När skalningsåtgärden är klar ändras till ProvisioningState Succeeded. Om du behöver göra en annan skalningsåtgärd--- till exempel ändra från Basic till Standard och sedan ändra storlek--- måste du vänta tills den föregående åtgärden har slutförts eller så får du ett fel som liknar följande.

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

Så här hämtar du information om en Azure Cache for Redis

Du kan hämta information om en cache med hjälp av cmdleten Get-AzRedisCache .

Om du vill se en lista över tillgängliga parametrar och deras beskrivningar för Get-AzRedisCachekör du följande kommando.

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

Om du vill returnera information om alla cacheminnen i den aktuella prenumerationen kör du Get-AzRedisCache utan parametrar.

    Get-AzRedisCache

Om du vill returnera information om alla cacheminnen i en specifik resursgrupp kör du Get-AzRedisCache med parametern ResourceGroupName .

    Get-AzRedisCache -ResourceGroupName myGroup

Om du vill returnera information om en specifik cache kör Get-AzRedisCache du med parametern Name som innehåller namnet på cachen och parametern ResourceGroupName med resursgruppen som innehåller cacheminnet.

    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         :

Hämta åtkomstnycklarna för en Azure Cache for Redis

Om du vill hämta åtkomstnycklarna för cacheminnet kan du använda cmdleten Get-AzRedisCacheKey .

Om du vill se en lista över tillgängliga parametrar och deras beskrivningar för Get-AzRedisCacheKeykör du följande kommando.

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

Om du vill hämta nycklarna för cacheminnet anropar du cmdleten Get-AzRedisCacheKey och skickar namnet på cachen till namnet på den resursgrupp som innehåller cacheminnet.

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

    PrimaryKey   : b2wdt43sfetlju4hfbryfnregrd9wgIcc6IA3zAO1lY=
    SecondaryKey : ABhfB757JgjIgt785JgKH9865eifmekfnn649303JKL=

Återskapa åtkomstnycklar för Azure Cache for Redis

Om du vill återskapa åtkomstnycklarna för cacheminnet kan du använda cmdleten New-AzRedisCacheKey .

Om du vill se en lista över tillgängliga parametrar och deras beskrivningar för New-AzRedisCacheKeykör du följande kommando.

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

Om du vill återskapa den primära eller sekundära nyckeln för cacheminnet anropar du cmdleten New-AzRedisCacheKey och skickar in namnet, resursgruppen och anger antingen Primary eller Secondary för parametern KeyType . I följande exempel återskapas den sekundära åtkomstnyckeln för en cache.

    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=

Ta bort en Azure Cache for Redis

Om du vill ta bort en Azure Cache for Redis använder du cmdleten Remove-AzRedisCache .

Om du vill se en lista över tillgängliga parametrar och deras beskrivningar för Remove-AzRedisCachekör du följande kommando.

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

I följande exempel tas cachen med namnet myCache bort.

    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

Importera en Azure Cache for Redis

Du kan importera data till en Azure Cache for Redis-instans med hjälp av cmdleten Import-AzRedisCache .

Viktigt!

Import/export är endast tillgängligt för Premium-nivåcacheminnen . Mer information om import/export finns i Importera och exportera data i Azure Cache for Redis.

Om du vill se en lista över tillgängliga parametrar och deras beskrivningar för Import-AzRedisCachekör du följande kommando.

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

Följande kommando importerar data från bloben som anges av SAS-URI:n till 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

Så här exporterar du en Azure Cache for Redis

Du kan exportera data från en Azure Cache for Redis-instans med hjälp av cmdleten Export-AzRedisCache .

Viktigt!

Import/export är endast tillgängligt för Premium-nivåcacheminnen . Mer information om import/export finns i Importera och exportera data i Azure Cache for Redis.

Om du vill se en lista över tillgängliga parametrar och deras beskrivningar för Export-AzRedisCachekör du följande kommando.

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

Följande kommando exporterar data från en Azure Cache for Redis-instans till containern som anges av SAS-URI:n.

    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"

Starta om en Azure Cache for Redis

Du kan starta om Azure Cache for Redis-instansen med hjälp av cmdleten Reset-AzRedisCache .

Viktigt!

Omstart är endast tillgängligt för cacheminnen på Basic-, Standard- och Premium-nivå . Mer information om hur du startar om cacheminnet finns i Cacheadministration – omstart.

Om du vill se en lista över tillgängliga parametrar och deras beskrivningar för Reset-AzRedisCachekör du följande kommando.

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

Följande kommando startar om båda noderna i den angivna cachen.

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

Nästa steg

Mer information om hur du använder Windows PowerShell med Azure finns i följande resurser:

• Dokumentation om Azure Cache for Redis-cmdlet på MSDN
• Azure Resource Manager-cmdletar: Lär dig att använda cmdletarna i Azure Resource Manager-modulen.
• Använda resursgrupper för att hantera dina Azure-resurser: Lär dig hur du skapar och hanterar resursgrupper i Azure Portal.
• Azure-blogg: Lär dig mer om nya funktioner i Azure.
• Windows PowerShell-blogg: Lär dig mer om nya funktioner i Windows PowerShell.
• "Hej, skriptkillen!" Blogg: Få verkliga tips och tricks från Windows PowerShell-communityn.