Set-AzureRmStorageAccount

Referência

Módulo:: AzureRM.Storage

Modifica uma conta de armazenamento.

Aviso

O módulo AzureRM do PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.

Sintaxe

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

O cmdlet Set-AzureRmStorageAccount modifica uma conta de Armazenamento do Azure. Você pode usar esse cmdlet para modificar o tipo de conta, atualizar um domínio de cliente ou definir marcas em uma conta de armazenamento.

Exemplos

Exemplo 1: Definir o tipo de conta de armazenamento

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

Este comando define o tipo de conta de armazenamento como Standard_RAGRS.

Exemplo 2: Definir um domínio personalizado para uma conta de armazenamento

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

Este comando define um domínio personalizado para uma conta de armazenamento.

Exemplo 3: Definir o valor da camada de acesso

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

O comando define o valor da Camada de Acesso como legal.

Exemplo 4: Definir o domínio personalizado e as tags

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

O comando define o domínio personalizado e as tags para uma conta de armazenamento.

Exemplo 5: Definir Encryption KeySource como 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 define Encryption KeySource com um novo Keyvault criado.

Exemplo 6: Definir Encryption KeySource como "Microsoft.Storage"

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

Este comando define Encryption KeySource como "Microsoft.Storage"

Exemplo 7: Definir a propriedade NetworkRuleSet de uma conta de armazenamento com 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 define a propriedade NetworkRuleSet de uma conta de armazenamento com JSON

Exemplo 8: Obter a propriedade NetworkRuleSet de uma conta de armazenamento e defini-la como outra conta de armazenamento

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

Este primeiro comando obtém a propriedade NetworkRuleSet de uma conta de Armazenamento e o segundo comando a define como outra conta de Armazenamento

Exemplo 9: Atualizar uma conta de armazenamento com o tipo "Storage" ou "BlobStorage" para uma conta de armazenamento do tipo "StorageV2"

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

O comando atualize uma conta de armazenamento com o tipo "Storage" ou "BlobStorage" para uma conta de armazenamento do tipo "StorageV2".

Parâmetros

-AccessTier

Especifica a camada de acesso da conta de armazenamento que esse cmdlet modifica. Os valores aceitáveis para este parâmetro são: Hot and Cool. Se alterar o nível de acesso, poderá resultar em custos adicionais. Para obter mais informações, consulte Armazenamento de Blobs do Azure: níveis de armazenamento quentes e frios. Se a conta de armazenamento tiver Kind como StorageV2 ou BlobStorage, você poderá especificar o parâmetro AccessTier . Se a conta de armazenamento tiver Kind como armazenamento, não especifique o parâmetro AccessTier .

Tipo:	String
Valores aceites:	Hot, Cool
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-AsJob

Executar cmdlet em segundo plano

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-AssignIdentity

Gere e atribua uma nova Identidade de conta de Armazenamento para esta conta de Armazenamento para uso com serviços de gerenciamento de chaves, como o Azure KeyVault.

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-CustomDomainName

Especifica o nome do domínio personalizado.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-EnableHttpsTrafficOnly

Indica se a conta de armazenamento habilita ou não apenas o tráfego HTTPS.

Tipo:	Boolean
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-Force

Força a alteração a ser gravada na conta de armazenamento.

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-KeyName

Se estiver usando -KeyvaultEncryption para habilitar a criptografia com o Cofre da Chave, especifique a propriedade Keyname com essa opção.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-KeyvaultEncryption

Indica se o Microsoft KeyVault deve ou não ser usado para as chaves de criptografia ao usar a Criptografia do Serviço de Armazenamento. Se KeyName, KeyVersion e KeyVaultUri estiverem todos definidos, KeySource será definido como Microsoft.Keyvault quer esse parâmetro esteja definido ou não.

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-KeyVaultUri

Ao usar a criptografia do Cofre da Chave especificando o parâmetro -KeyvaultEncryption, use essa opção para especificar o URI para o Cofre da Chave.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-KeyVersion

Ao usar a criptografia do cofre da chave especificando o parâmetro -KeyvaultEncryption, use essa opção para especificar o URI para a versão da chave.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Name

Especifica o nome da conta de armazenamento a ser modificada.

Tipo:	String
Aliases:	StorageAccountName, AccountName
Position:	1
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-NetworkRuleSet

NetworkRuleSet é usado para definir um conjunto de regras de configuração para firewalls e redes virtuais, bem como para definir valores para propriedades de rede, como serviços permitidos para ignorar as regras e como lidar com solicitações que não correspondem a nenhuma das regras definidas.

Tipo:	PSNetworkRuleSet
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ResourceGroupName

Especifica o nome do grupo de recursos no qual modificar a conta de armazenamento.

Tipo:	String
Position:	0
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-SkuName

Especifica o nome da SKU da conta de armazenamento. Os valores aceitáveis para este parâmetro são:

Standard_LRS - Armazenamento com redundância local.
Standard_ZRS - Armazenamento com redundância de zona.
Standard_GRS - Armazenamento com redundância geográfica.
Standard_RAGRS - Armazenamento com redundância geográfica de acesso de leitura.
Premium_LRS - Armazenamento com redundância local premium. Não é possível alterar Standard_ZRS e Premium_LRS tipos para outros tipos de conta. Não é possível alterar outros tipos de conta para Standard_ZRS ou Premium_LRS.

Tipo:	String
Aliases:	StorageAccountType, AccountType, Type
Valores aceites:	Standard_LRS, Standard_ZRS, Standard_GRS, Standard_RAGRS, Premium_LRS
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-StorageEncryption

Indica se a criptografia da conta de armazenamento deve ou não ser definida para usar chaves gerenciadas pela Microsoft.

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Tag

Pares chave-valor na forma de uma tabela de hash definida como tags no servidor. Por exemplo: @{key0="value0"; chave1=$null; key2="valor2"}

Tipo:	Hashtable
Aliases:	Tags
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-UpgradeToStorageV2

Atualize o tipo de conta de armazenamento de armazenamento ou BlobStorage para StorageV2.

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-UseSubDomain

Indica se a validação CName indireta deve ser habilitada.

Tipo:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

Entradas

String

Hashtable

Boolean

Saídas

PSStorageAccount

Partilhar via

Set-AzureRmStorageAccount

Sintaxe

Description

Exemplos

Exemplo 1: Definir o tipo de conta de armazenamento

Exemplo 2: Definir um domínio personalizado para uma conta de armazenamento

Exemplo 3: Definir o valor da camada de acesso

Exemplo 4: Definir o domínio personalizado e as tags

Exemplo 5: Definir Encryption KeySource como Keyvault

Exemplo 6: Definir Encryption KeySource como "Microsoft.Storage"

Exemplo 7: Definir a propriedade NetworkRuleSet de uma conta de armazenamento com JSON

Exemplo 8: Obter a propriedade NetworkRuleSet de uma conta de armazenamento e defini-la como outra conta de armazenamento

Exemplo 9: Atualizar uma conta de armazenamento com o tipo "Storage" ou "BlobStorage" para uma conta de armazenamento do 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

Saídas

Recursos adicionais

Partilhar via

Set-AzureRmStorageAccount

Sintaxe

Description

Exemplos

Exemplo 1: Definir o tipo de conta de armazenamento

Exemplo 2: Definir um domínio personalizado para uma conta de armazenamento

Exemplo 3: Definir o valor da camada de acesso

Exemplo 4: Definir o domínio personalizado e as tags

Exemplo 5: Definir Encryption KeySource como Keyvault

Exemplo 6: Definir Encryption KeySource como "Microsoft.Storage"

Exemplo 7: Definir a propriedade NetworkRuleSet de uma conta de armazenamento com JSON

Exemplo 8: Obter a propriedade NetworkRuleSet de uma conta de armazenamento e defini-la como outra conta de armazenamento

Exemplo 9: Atualizar uma conta de armazenamento com o tipo "Storage" ou "BlobStorage" para uma conta de armazenamento do 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

Saídas

Ligações Relacionadas

Recursos adicionais