Set-AzureRmStorageAccount

Referencia

Módulo:: AzureRM.Storage

Modifica una cuenta de almacenamiento.

Advertencia

El módulo AzureRM PowerShell ha quedado oficialmente obsoleto a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no recibirá mantenimiento ni soporte técnico, lo que significa que su uso continuado queda a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Sintaxis

Set-AzureRmStorageAccount
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Force]
   [-SkuName <String>]
   [-AccessTier <String>]
   [-CustomDomainName <String>]
   [-UseSubDomain <Boolean>]
   [-Tag <Hashtable>]
   [-EnableHttpsTrafficOnly <Boolean>]
   [-StorageEncryption]
   [-AssignIdentity]
   [-NetworkRuleSet <PSNetworkRuleSet>]
   [-UpgradeToStorageV2]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzureRmStorageAccount
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Force]
   [-SkuName <String>]
   [-AccessTier <String>]
   [-CustomDomainName <String>]
   [-UseSubDomain <Boolean>]
   [-Tag <Hashtable>]
   [-EnableHttpsTrafficOnly <Boolean>]
   [-KeyvaultEncryption]
   -KeyName <String>
   -KeyVersion <String>
   -KeyVaultUri <String>
   [-AssignIdentity]
   [-NetworkRuleSet <PSNetworkRuleSet>]
   [-UpgradeToStorageV2]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Set-AzureRmStorageAccount modifica una cuenta de Azure Storage. Puede usar este cmdlet para modificar el tipo de cuenta, actualizar un dominio de cliente o establecer etiquetas en una cuenta de almacenamiento.

Ejemplos

Ejemplo 1: Establecimiento del tipo de cuenta de almacenamiento

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -Type "Standard_RAGRS"

Este comando establece el tipo de cuenta de almacenamiento en Standard_RAGRS.

Ejemplo 2: Establecimiento de un dominio personalizado para una cuenta de almacenamiento

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -CustomDomainName "www.contoso.com" -UseSubDomain $True

Este comando establece un dominio personalizado para una cuenta de Storage.

Ejemplo 3: Establecimiento del valor del nivel de acceso

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -AccessTier Cool

El comando establece que el valor de Nivel de acceso sea esporádico.

Ejemplo 4: Establecimiento del dominio y las etiquetas personalizados

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -CustomDomainName "www.domainname.com" -UseSubDomain $true -Tag @{tag0="value0";tag1="value1";tag2="value2"}

El comando establece el dominio personalizado y las etiquetas de una cuenta de almacenamiento.

Ejemplo 5: Establecimiento de KeySource de cifrado en Keyvault

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -AssignIdentity
PS C:\>$account = Get-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount"

PS C:\>$keyVault = New-AzureRmKeyVault -VaultName "MyKeyVault" -ResourceGroupName "MyResourceGroup" -Location "EastUS2"
PS C:\>$key = Add-AzureKeyVaultKey -VaultName "MyKeyVault" -Name "MyKey" -Destination 'Software'
PS C:\>Set-AzureRmKeyVaultAccessPolicy -VaultName "MyKeyVault" -ObjectId $account.Identity.PrincipalId -PermissionsToKeys wrapkey,unwrapkey,get

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -KeyvaultEncryption -KeyName $key.Name -KeyVersion $key.Version -KeyVaultUri $keyVault.VaultUri

Este comando establece Encryption KeySource con un nuevo keyvault creado.

Ejemplo 6: Establecer KeySource de cifrado en "Microsoft.Storage"

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -StorageEncryption

Este comando establece Encryption KeySource en "Microsoft.Storage"

Ejemplo 7: Establecimiento de la propiedad NetworkRuleSet de una cuenta de almacenamiento con JSON

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -NetworkRuleSet (@{bypass="Logging,Metrics";
    ipRules=(@{IPAddressOrRange="20.11.0.0/16";Action="allow"},
            @{IPAddressOrRange="10.0.0.0/7";Action="allow"});
    virtualNetworkRules=(@{VirtualNetworkResourceId="/subscriptions/s1/resourceGroups/g1/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1";Action="allow"},
                        @{VirtualNetworkResourceId="/subscriptions/s1/resourceGroups/g1/providers/Microsoft.Network/virtualNetworks/vnet2/subnets/subnet2";Action="allow"});
    defaultAction="allow"})

Este comando establece la propiedad NetworkRuleSet de una cuenta de almacenamiento con JSON.

Ejemplo 8: Obtener la propiedad NetworkRuleSet de una cuenta de almacenamiento y establecerla en otra cuenta de almacenamiento

PS C:\> $networkRuleSet = (Get-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount").NetworkRuleSet 
PS C:\> Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount2" -NetworkRuleSet $networkRuleSet

Este primer comando obtiene la propiedad NetworkRuleSet de una cuenta de almacenamiento y el segundo comando lo establece en otra cuenta de almacenamiento.

Ejemplo 9: Actualización de una cuenta de almacenamiento con el tipo "Storage" o "BlobStorage" a la cuenta de almacenamiento de tipo "StorageV2"

PS C:\> Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -UpgradeToStorageV2

El comando actualiza una cuenta de almacenamiento con el tipo "Storage" o "BlobStorage" a la cuenta de almacenamiento de tipo "StorageV2".

Parámetros

-AccessTier

Especifica el nivel de acceso de la cuenta de almacenamiento que modifica este cmdlet. Los valores aceptables para este parámetro son: Frecuente y Esporádico. Si cambia el nivel de acceso, puede dar lugar a cargos adicionales. Para más información, consulte Azure Blob Storage: niveles de almacenamiento frecuente y esporádico. Si la cuenta de almacenamiento tiene kind as StorageV2 o BlobStorage, puede especificar el parámetro AccessTier . Si la cuenta de almacenamiento tiene kind as Storage, no especifique el parámetro AccessTier .

Tipo:	String
Valores aceptados:	Hot, Cool
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AsJob

Ejecución del cmdlet en segundo plano

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AssignIdentity

Genere y asigne una nueva identidad de cuenta de almacenamiento para esta cuenta de Storage para su uso con servicios de administración de claves como Azure KeyVault.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CustomDomainName

Especifica el nombre del dominio personalizado.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Tipo:	IAzureContextContainer
Alias:	AzureRmContext, AzureCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-EnableHttpsTrafficOnly

Indica si la cuenta de almacenamiento solo habilita el tráfico HTTPS.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Force

Obliga a escribir el cambio en la cuenta de almacenamiento.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-KeyName

Si usa -KeyvaultEncryption para habilitar el cifrado con Key Vault, especifique la propiedad Keyname con esta opción.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-KeyvaultEncryption

Indica si se va a usar Microsoft KeyVault para las claves de cifrado al usar Storage Service Encryption. Si se establecen KeyName, KeyVersion y KeyVaultUri, KeySource se establecerá en Microsoft.Keyvault si este parámetro está establecido o no.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-KeyVaultUri

Al usar el cifrado de Key Vault especificando el parámetro -KeyvaultEncryption, use esta opción para especificar el URI en Key Vault.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-KeyVersion

Al usar el cifrado de Key Vault especificando el parámetro -KeyvaultEncryption, use esta opción para especificar el URI en la versión de clave.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Name

Especifica el nombre de la cuenta de almacenamiento que se va a modificar.

Tipo:	String
Alias:	StorageAccountName, AccountName
Posición:	1
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-NetworkRuleSet

NetworkRuleSet se usa para definir un conjunto de reglas de configuración para firewalls y redes virtuales, así como para establecer valores para propiedades de red como servicios que pueden omitir las reglas y cómo controlar las solicitudes que no coinciden con ninguna de las reglas definidas.

Tipo:	PSNetworkRuleSet
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ResourceGroupName

Especifica el nombre del grupo de recursos en el que se va a modificar la cuenta de almacenamiento.

Tipo:	String
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-SkuName

Especifica el nombre de la SKU de la cuenta de almacenamiento. Los valores permitidos para este parámetro son los siguientes:

Standard_LRS: almacenamiento con redundancia local.
Standard_ZRS: almacenamiento con redundancia de zona.
Standard_GRS: almacenamiento con redundancia geográfica.
Standard_RAGRS: almacenamiento con redundancia geográfica con acceso de lectura.
Premium_LRS: almacenamiento con redundancia local Premium. No puede cambiar Standard_ZRS y tipos de Premium_LRS a otros tipos de cuenta. No puede cambiar otros tipos de cuenta a Standard_ZRS o Premium_LRS.

Tipo:	String
Alias:	StorageAccountType, AccountType, Type
Valores aceptados:	Standard_LRS, Standard_ZRS, Standard_GRS, Standard_RAGRS, Premium_LRS
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-StorageEncryption

Indica si se va a establecer o no el cifrado de la cuenta de almacenamiento para usar claves administradas por Microsoft.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Tag

Pares clave-valor en forma de tabla hash establecida como etiquetas en el servidor. Por ejemplo: @{key0="value0"; key1=$null; key2="value2"}

Tipo:	Hashtable
Alias:	Tags
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-UpgradeToStorageV2

Actualice el tipo de cuenta de almacenamiento de Storage o BlobStorage a StorageV2.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-UseSubDomain

Indica si se va a habilitar la validación indirecta de CName.

Tipo:	Nullable<T>[Boolean]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

String

Hashtable

Boolean

Salidas

PSStorageAccount

Compartir a través de

Set-AzureRmStorageAccount

Sintaxis

Description

Ejemplos

Ejemplo 1: Establecimiento del tipo de cuenta de almacenamiento

Ejemplo 2: Establecimiento de un dominio personalizado para una cuenta de almacenamiento

Ejemplo 3: Establecimiento del valor del nivel de acceso

Ejemplo 4: Establecimiento del dominio y las etiquetas personalizados

Ejemplo 5: Establecimiento de KeySource de cifrado en Keyvault

Ejemplo 6: Establecer KeySource de cifrado en "Microsoft.Storage"

Ejemplo 7: Establecimiento de la propiedad NetworkRuleSet de una cuenta de almacenamiento con JSON

Ejemplo 8: Obtener la propiedad NetworkRuleSet de una cuenta de almacenamiento y establecerla en otra cuenta de almacenamiento

Ejemplo 9: Actualización de una cuenta de almacenamiento con el tipo "Storage" o "BlobStorage" a la cuenta de almacenamiento de tipo "StorageV2"

Parámetros

-AccessTier

-AsJob

-AssignIdentity

-Confirm

-CustomDomainName

-DefaultProfile

-EnableHttpsTrafficOnly

-Force

-KeyName

-KeyvaultEncryption

-KeyVaultUri

-KeyVersion

-Name

-NetworkRuleSet

-ResourceGroupName

-SkuName

-StorageEncryption

-Tag

-UpgradeToStorageV2

-UseSubDomain

-WhatIf

Entradas

Salidas

Recursos adicionales

Compartir a través de

Set-AzureRmStorageAccount

Sintaxis

Description

Ejemplos

Ejemplo 1: Establecimiento del tipo de cuenta de almacenamiento

Ejemplo 2: Establecimiento de un dominio personalizado para una cuenta de almacenamiento

Ejemplo 3: Establecimiento del valor del nivel de acceso

Ejemplo 4: Establecimiento del dominio y las etiquetas personalizados

Ejemplo 5: Establecimiento de KeySource de cifrado en Keyvault

Ejemplo 6: Establecer KeySource de cifrado en "Microsoft.Storage"

Ejemplo 7: Establecimiento de la propiedad NetworkRuleSet de una cuenta de almacenamiento con JSON

Ejemplo 8: Obtener la propiedad NetworkRuleSet de una cuenta de almacenamiento y establecerla en otra cuenta de almacenamiento

Ejemplo 9: Actualización de una cuenta de almacenamiento con el tipo "Storage" o "BlobStorage" a la cuenta de almacenamiento de tipo "StorageV2"

Parámetros

-AccessTier

-AsJob

-AssignIdentity

-Confirm

-CustomDomainName

-DefaultProfile

-EnableHttpsTrafficOnly

-Force

-KeyName

-KeyvaultEncryption

-KeyVaultUri

-KeyVersion

-Name

-NetworkRuleSet

-ResourceGroupName

-SkuName

-StorageEncryption

-Tag

-UpgradeToStorageV2

-UseSubDomain

-WhatIf

Entradas

Salidas

Vínculos relacionados

Recursos adicionales