Cmdlets

Choose a cmdlet from the list on the left or search for a specific cmdlet. Choose a cmdlet from the list or search for a specific cmdlet.
About Help  Providers
 

Set-AzureManagedCache

Set-AzureManagedCache

microsoft.azure.commands.managedcache.dll

Synopsis

Changes the properties of an Azure Cache.

Syntax

Set-AzureManagedCache [-Name] [-Sku] [-Force] [-Memory] [<CommonParameters>]

Detailed Description

The Set-AzureManagedCache cmdlet changes the properties of an Azure Cache and returns an object that represents the cache with the changes. Use the Name and Location parameters to identify the Azure Cache, and the Sku and Memory parameters to change its properties.An Azure Cache is a secure, dedicated cache that provides extremely fast access to data. This distributed, in-memory, scalable solution enables you to build highly scalable and responsive applications. For more information about Azure Cache, see Azure Cache (http://azure.microsoft.com/en-us/services/cache/).WARNING: When you change the SKU of an Azure Cache, all data in the cache is deleted and a new, empty Azure Cache is created for you with the same name and location. When you use the Sku parameter, Set-AzureManagedCache prompts for confirmation. To suppress the confirmation prompt, use the Force parameter.

Parameters

-Name <String>

Identifies the Azure Cache. Enter the name of an Azure Cache. This parameter is required. The parameter value is case-sensitive. Wildcards are not permitted. You cannot use this cmdlet to change the name of an Azure Cache.

Aliases

None

Required?

true

Position

0

Default value

None

Accept pipeline input?

true (ByPropertyName)

Accept wildcard characters?

false

-Sku <CacheServiceSkuType>

Changes the tier of the Azure Cache. Valid values are Basic (128MB - 1GB), Standard (1GB - 10GB), and Premium (5GB - 150GB). This parameter is optional.

Aliases

None

Required?

false

Position

named

Default value

None

Accept pipeline input?

false

Accept wildcard characters?

false

-Force <SwitchParameter>

Suppresses the confirmation prompt that appears when you use the Sku parameter. Because changing the SKU deletes all data in the Azure Cache, Set-AzureManagedCache prompts you for confirmation before performing the operation.

Aliases

None

Required?

false

Position

named

Default value

None

Accept pipeline input?

false

Accept wildcard characters?

false

-Memory <String>

Changes the Azure Cache to the specified size. The cache size might affect the cost of the service. Enter a value followed by "MB" or "GB" (no intervening space), such as (128MB or 8GB). This value must be compatible with the Sku of the Azure Cache. This parameter is optional. -- When the value of Sku is Basic, the value of Memory must be divisible by 128MB. -- When the value of Sku is Standard, the value of Memory must be divisible by 1GB. -- When the value of Sku is Premium, the value of Memory must be divisible by 5GB.

Aliases

None

Required?

false

Position

named

Default value

None

Accept pipeline input?

false

Accept wildcard characters?

false

-Location <string>

Specifies the location of the Azure Cache. This parameter is required. Enter the name of the Azure data center location where the Azure Cache resides, such as "North Central US" or "West Europe". This parameter identifies the Azure Cache. You cannot use this parameter to change the location of the Azure Cache.

Aliases

None

Required?

true

Position

2

Default value

None

Accept pipeline input?

false

Accept wildcard characters?

false

Input Type

None

Return Type

Microsoft.Azure.Commands.ManagedCache.Models.PsCacheService

Notes

Before using this cmdlet, use Add-AzureAccount or Import-AzurePublishSettingsFile to make your Azure account available to Windows PowerShell. For more information, see How to install and configure Azure PowerShell (http://azure.microsoft.com/en-us/documentation/articles/install-configure-powershell/).

Examples

-------------------------- Example 1: Change the size of an Azure Cache --------------------------

This command increases the size of the contosocache Azure Cache to 256 MB.

PS C:\>Set-AzureManagedCache -Name contosocache -Location "West Europe" -Memory 256MB

-------------------------- Example 2: Change the SKU of an Azure Cache --------------------------

This command changes the SKU of the contosocache Azure Cache from Basic to Standard and the Size to 10 GB.

PS C:\>Set-AzureManagedCache -Name contosocache -Location "West Europe" -Sku Standard -Size 10GB

Confirm
Are you sure you want to perform this action?
Performing the operation "Delete" on target "contosocache".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"):

Online Version