Set-AzStorageAccount

Módulo:: Az.Storage Module

Modifica uma conta de armazenamento.

Sintaxe

StorageEncryption (Predefinição)

Set-AzStorageAccount
    [-ResourceGroupName] <String>
    [-Name] <String>
    [-Force]
    [-SkuName <String>]
    [-AccessTier <String>]
    [-CustomDomainName <String>]
    [-UseSubDomain <Boolean>]
    [-Tag <Hashtable>]
    [-EnableHttpsTrafficOnly <Boolean>]
    [-StorageEncryption]
    [-AssignIdentity]
    [-UserAssignedIdentityId <String>]
    [-KeyVaultUserAssignedIdentityId <String>]
    [-KeyVaultFederatedClientId <String>]
    [-IdentityType <String>]
    [-NetworkRuleSet <PSNetworkRuleSet>]
    [-UpgradeToStorageV2]
    [-EnableAzureActiveDirectoryDomainServicesForFile <Boolean>]
    [-EnableLargeFileShare]
    [-PublishMicrosoftEndpoint <Boolean>]
    [-PublishInternetEndpoint <Boolean>]
    [-EnableSmbOAuth <Boolean>]
    [-AllowBlobPublicAccess <Boolean>]
    [-MinimumTlsVersion <String>]
    [-AllowSharedKeyAccess <Boolean>]
    [-SasExpirationPeriod <TimeSpan>]
    [-SasExpirationAction <String>]
    [-KeyExpirationPeriodInDay <Int32>]
    [-AllowCrossTenantReplication <Boolean>]
    [-DefaultSharePermission <String>]
    [-PublicNetworkAccess <String>]
    [-ImmutabilityPeriod <Int32>]
    [-ImmutabilityPolicyState <String>]
    [-EnableSftp <Boolean>]
    [-EnableLocalUser <Boolean>]
    [-AllowedCopyScope <String>]
    [-Zone <String[]>]
    [-ZonePlacementPolicy <String>]
    [-EnableBlobGeoPriorityReplication <Boolean>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-RoutingChoice <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

KeyvaultEncryption

Set-AzStorageAccount
    [-ResourceGroupName] <String>
    [-Name] <String>
    -KeyName <String>
    -KeyVaultUri <String>
    [-Force]
    [-SkuName <String>]
    [-AccessTier <String>]
    [-CustomDomainName <String>]
    [-UseSubDomain <Boolean>]
    [-Tag <Hashtable>]
    [-EnableHttpsTrafficOnly <Boolean>]
    [-KeyvaultEncryption]
    [-KeyVersion <String>]
    [-AssignIdentity]
    [-UserAssignedIdentityId <String>]
    [-KeyVaultUserAssignedIdentityId <String>]
    [-KeyVaultFederatedClientId <String>]
    [-IdentityType <String>]
    [-NetworkRuleSet <PSNetworkRuleSet>]
    [-UpgradeToStorageV2]
    [-EnableAzureActiveDirectoryDomainServicesForFile <Boolean>]
    [-EnableLargeFileShare]
    [-PublishMicrosoftEndpoint <Boolean>]
    [-PublishInternetEndpoint <Boolean>]
    [-EnableSmbOAuth <Boolean>]
    [-AllowBlobPublicAccess <Boolean>]
    [-MinimumTlsVersion <String>]
    [-AllowSharedKeyAccess <Boolean>]
    [-SasExpirationPeriod <TimeSpan>]
    [-SasExpirationAction <String>]
    [-KeyExpirationPeriodInDay <Int32>]
    [-AllowCrossTenantReplication <Boolean>]
    [-DefaultSharePermission <String>]
    [-PublicNetworkAccess <String>]
    [-ImmutabilityPeriod <Int32>]
    [-ImmutabilityPolicyState <String>]
    [-EnableSftp <Boolean>]
    [-EnableLocalUser <Boolean>]
    [-AllowedCopyScope <String>]
    [-Zone <String[]>]
    [-ZonePlacementPolicy <String>]
    [-EnableBlobGeoPriorityReplication <Boolean>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-RoutingChoice <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AzureActiveDirectoryKerberosForFile

Set-AzStorageAccount
    [-ResourceGroupName] <String>
    [-Name] <String>
    [-Force]
    [-SkuName <String>]
    [-AccessTier <String>]
    [-CustomDomainName <String>]
    [-UseSubDomain <Boolean>]
    [-Tag <Hashtable>]
    [-EnableHttpsTrafficOnly <Boolean>]
    [-AssignIdentity]
    [-UserAssignedIdentityId <String>]
    [-KeyVaultUserAssignedIdentityId <String>]
    [-KeyVaultFederatedClientId <String>]
    [-IdentityType <String>]
    [-NetworkRuleSet <PSNetworkRuleSet>]
    [-UpgradeToStorageV2]
    [-EnableLargeFileShare]
    [-PublishMicrosoftEndpoint <Boolean>]
    [-PublishInternetEndpoint <Boolean>]
    [-EnableAzureActiveDirectoryKerberosForFile <Boolean>]
    [-ActiveDirectoryDomainName <String>]
    [-ActiveDirectoryDomainGuid <String>]
    [-EnableSmbOAuth <Boolean>]
    [-AllowBlobPublicAccess <Boolean>]
    [-MinimumTlsVersion <String>]
    [-AllowSharedKeyAccess <Boolean>]
    [-SasExpirationPeriod <TimeSpan>]
    [-SasExpirationAction <String>]
    [-KeyExpirationPeriodInDay <Int32>]
    [-AllowCrossTenantReplication <Boolean>]
    [-DefaultSharePermission <String>]
    [-PublicNetworkAccess <String>]
    [-ImmutabilityPeriod <Int32>]
    [-ImmutabilityPolicyState <String>]
    [-EnableSftp <Boolean>]
    [-EnableLocalUser <Boolean>]
    [-AllowedCopyScope <String>]
    [-Zone <String[]>]
    [-ZonePlacementPolicy <String>]
    [-EnableBlobGeoPriorityReplication <Boolean>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-RoutingChoice <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ActiveDirectoryDomainServicesForFile

Set-AzStorageAccount
    [-ResourceGroupName] <String>
    [-Name] <String>
    -EnableActiveDirectoryDomainServicesForFile <Boolean>
    [-Force]
    [-SkuName <String>]
    [-AccessTier <String>]
    [-CustomDomainName <String>]
    [-UseSubDomain <Boolean>]
    [-Tag <Hashtable>]
    [-EnableHttpsTrafficOnly <Boolean>]
    [-AssignIdentity]
    [-UserAssignedIdentityId <String>]
    [-KeyVaultUserAssignedIdentityId <String>]
    [-KeyVaultFederatedClientId <String>]
    [-IdentityType <String>]
    [-NetworkRuleSet <PSNetworkRuleSet>]
    [-UpgradeToStorageV2]
    [-EnableLargeFileShare]
    [-PublishMicrosoftEndpoint <Boolean>]
    [-PublishInternetEndpoint <Boolean>]
    [-ActiveDirectoryDomainName <String>]
    [-ActiveDirectoryNetBiosDomainName <String>]
    [-ActiveDirectoryForestName <String>]
    [-ActiveDirectoryDomainGuid <String>]
    [-ActiveDirectoryDomainSid <String>]
    [-ActiveDirectoryAzureStorageSid <String>]
    [-ActiveDirectorySamAccountName <String>]
    [-ActiveDirectoryAccountType <String>]
    [-EnableSmbOAuth <Boolean>]
    [-AllowBlobPublicAccess <Boolean>]
    [-MinimumTlsVersion <String>]
    [-AllowSharedKeyAccess <Boolean>]
    [-SasExpirationPeriod <TimeSpan>]
    [-SasExpirationAction <String>]
    [-KeyExpirationPeriodInDay <Int32>]
    [-AllowCrossTenantReplication <Boolean>]
    [-DefaultSharePermission <String>]
    [-PublicNetworkAccess <String>]
    [-ImmutabilityPeriod <Int32>]
    [-ImmutabilityPolicyState <String>]
    [-EnableSftp <Boolean>]
    [-EnableLocalUser <Boolean>]
    [-AllowedCopyScope <String>]
    [-Zone <String[]>]
    [-ZonePlacementPolicy <String>]
    [-EnableBlobGeoPriorityReplication <Boolean>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-RoutingChoice <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O cmdlet Set-AzStorageAccount modifica uma conta Azure Storage. 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

Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -SkuName "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

Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "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

Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -AccessTier Cool

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

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

Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "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

Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -AssignIdentity
$account = Get-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount"

$keyVault = New-AzKeyVault -VaultName "MyKeyVault" -ResourceGroupName "MyResourceGroup" -Location "EastUS2"
$key = Add-AzKeyVaultKey -VaultName "MyKeyVault" -Name "MyKey" -Destination 'Software'
Set-AzKeyVaultAccessPolicy -VaultName "MyKeyVault" -ObjectId $account.Identity.PrincipalId -PermissionsToKeys wrapkey,unwrapkey,get

# In case to enable key auto rotation, don't set KeyVersion
Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -KeyvaultEncryption -KeyName $key.Name -KeyVersion $key.Version -KeyVaultUri $keyVault.VaultUri

# In case to enable key auto rotation after set keyvault properties with KeyVersion, can update account by set KeyVersion to empty
Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -KeyvaultEncryption -KeyName $key.Name -KeyVersion "" -KeyVaultUri $keyVault.VaultUri

Este comando define Encryption KeySource com um novo Keyvault criado. Se quiser ativar a rotação automática de chaves, não defina keyversion quando definir propriedades Keyvault pela primeira vez, ou limpe-a definindo propriedades keyvault novamente com keyversion como vazia.

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

Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -StorageEncryption

Este comando define Encryption KeySource como "Microsoft.Storage"

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

Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "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

$networkRuleSet = (Get-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount").NetworkRuleSet
Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "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"

Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -UpgradeToStorageV2

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

Exemplo 10: Atualize uma conta de Armazenamento ativando Azure Files Microsoft Entra Autenticação dos Serviços de Domínio e defina o DefaultSharePermission.

$account = Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -EnableAzureActiveDirectoryDomainServicesForFile $true -DefaultSharePermission StorageFileDataSmbShareContributor

$account.AzureFilesIdentityBasedAuth

DirectoryServiceOptions ActiveDirectoryProperties                                                      DefaultSharePermission
----------------------- -------------------------                                                      ----------------------
AADDS                   Microsoft.Azure.Commands.Management.Storage.Models.PSActiveDirectoryProperties StorageFileDataSmbShareContributor

O comando atualiza uma conta de Armazenamento ativando Azure Files Microsoft Entra Autenticação dos Serviços de Domínio.

Exemplo 11: Atualize uma conta de Armazenamento ativando a autenticação do serviço Files Active Directory Domain Service e depois mostre a definição de autenticação baseada em identidade de ficheiro

$account = Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -EnableActiveDirectoryDomainServicesForFile $true `
        -ActiveDirectoryDomainName "mydomain.com" `
        -ActiveDirectoryNetBiosDomainName "mydomain.com" `
        -ActiveDirectoryForestName "mydomain.com" `
        -ActiveDirectoryDomainGuid "12345678-1234-1234-1234-123456789012" `
        -ActiveDirectoryDomainSid "S-1-5-21-1234567890-1234567890-1234567890" `
        -ActiveDirectoryAzureStorageSid "S-1-5-21-1234567890-1234567890-1234567890-1234" `
        -ActiveDirectorySamAccountName "samaccountname" `
        -ActiveDirectoryAccountType Computer

$account.AzureFilesIdentityBasedAuth.DirectoryServiceOptions
AD

$account.AzureFilesIdentityBasedAuth.ActiveDirectoryProperties

DomainName        : mydomain.com
NetBiosDomainName : mydomain.com
ForestName        : mydomain.com
DomainGuid        : 12345678-1234-1234-1234-123456789012
DomainSid         : S-1-5-21-1234567890-1234567890-1234567890
AzureStorageSid   : S-1-5-21-1234567890-1234567890-1234567890-1234
SamAccountName    : samaccountname
AccountType       : Computer

O comando atualiza uma conta de Armazenamento ao ativar Azure Files Active Directory Domain Autenticação de Serviço e depois mostra a definição de autenticação baseada em Identidade de Ficheiro

Exemplo 12: Definir MinimumTlsVersion, AllowBlobPublicAccess e AllowSharedKeyAccess

$account = Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -MinimumTlsVersion TLS1_1 -AllowBlobPublicAccess $false -AllowSharedKeyAccess $true

$account.MinimumTlsVersion
TLS1_1

$account.AllowBlobPublicAccess
False

$a.AllowSharedKeyAccess
True

O comando define MinimumTlsVersion, AllowBlobPublicAccess e AllowSharedKeyAccess e, em seguida, mostra as 3 propriedades da conta

Exemplo 13: Atualizar uma conta de armazenamento com a configuração RoutingPreference

$account = Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -PublishMicrosoftEndpoint $false -PublishInternetEndpoint $true -RoutingChoice InternetRouting

$account.RoutingPreference

RoutingChoice   PublishMicrosoftEndpoints PublishInternetEndpoints
-------------   ------------------------- ------------------------
InternetRouting                     False                     True

$account.PrimaryEndpoints

Blob               : https://mystorageaccount.blob.core.windows.net/
Queue              : https://mystorageaccount.queue.core.windows.net/
Table              : https://mystorageaccount.table.core.windows.net/
File               : https://mystorageaccount.file.core.windows.net/
Web                : https://mystorageaccount.z2.web.core.windows.net/
Dfs                : https://mystorageaccount.dfs.core.windows.net/
MicrosoftEndpoints :
InternetEndpoints  : {"Blob":"https://mystorageaccount-internetrouting.blob.core.windows.net/","File":"https://mystorageaccount-internetrouting.file.core.windows.net/","Web":"https://mystorageaccount-internetrouting.z2.web.core.windows.net/","Dfs":"https://w
                     eirp3-internetrouting.dfs.core.windows.net/"}

Este comando atualiza uma conta de armazenamento com a configuração RoutingPreference: PublishMicrosoftEndpoint como false, PublishInternetEndpoint como true e RoutingChoice como MicrosoftRouting.

Exemplo 14: Atualizar uma conta de armazenamento com KeyExpirationPeriod e SasExpirationPeriod com SasExpirationAction

$account = Set-AzStorageAccount -ResourceGroupName "myresourcegroup" -Name "mystorageaccount" -KeyExpirationPeriodInDay 5 -SasExpirationPeriod "1.12:05:06" -SasExpirationAction Log

$account.KeyPolicy.KeyExpirationPeriodInDays
5

$account.SasPolicy.SasExpirationPeriod

SasExpirationPeriod ExpirationAction
------------------- ----------------
1.12:05:06          Log

Este comando atualiza uma conta de armazenamento com KeyExpirationPeriod e SasExpirationPeriod com SasExpirationAction e, em seguida, mostra as propriedades relacionadas à conta atualizada.

Exemplo 15: Atualizar uma conta de armazenamento para criptografia Keyvault e acessar Keyvault com identidade atribuída pelo usuário

# Create KeyVault (no need if using exist keyvault)
$keyVault = New-AzKeyVault -VaultName $keyvaultName -ResourceGroupName $resourceGroupName -Location eastus2euap -EnablePurgeProtection
$key = Add-AzKeyVaultKey -VaultName $keyvaultName -Name $keyname -Destination 'Software'

# create user assigned identity and grant access to keyvault (no need if using exist user assigned identity)
$userId = New-AzUserAssignedIdentity -ResourceGroupName $resourceGroupName -Name $userIdName
Set-AzKeyVaultAccessPolicy -VaultName $keyvaultName -ResourceGroupName $resourceGroupName -ObjectId $userId.PrincipalId -PermissionsToKeys get,wrapkey,unwrapkey -BypassObjectIdValidation
$useridentityId= $userId.Id

# Update Storage account with Keyvault encryption and access Keyvault with user assigned identity, then show properties
$account = Set-AzStorageAccount -ResourceGroupName $resourceGroupName -Name $storageAccountName `
                -IdentityType UserAssigned  -UserAssignedIdentityId $useridentityId  `
                -KeyVaultUri $keyVault.VaultUri -KeyName $keyname -KeyVaultUserAssignedIdentityId $useridentityId

$account.Encryption.EncryptionIdentity.EncryptionUserAssignedIdentity
/subscriptions/{subscription-id}/resourceGroups/myresourcegroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myuserid

$account.Encryption.KeyVaultProperties

KeyName                       : wrappingKey
KeyVersion                    :
KeyVaultUri                   : https://mykeyvault.vault.azure.net:443
CurrentVersionedKeyIdentifier : https://mykeyvault.vault.azure.net/keys/wrappingKey/8e74036e0d534e58b3bd84b319e31d8f
LastKeyRotationTimestamp      : 4/12/2021 8:17:57 AM

Este comando primeiro cria um keyvault e uma identidade atribuída ao usuário, em seguida, atualiza uma conta de armazenamento com criptografia keyvault, o acesso ao armazenamento keyvault com a identidade atribuída ao usuário.

Exemplo 16: Atualizar uma conta de armazenamento criptografada Keyvault, de acessar Keyvault com identidade atribuída pelo usuário, para acessar Keyvault com identidade atribuída ao sistema

# Assign System identity to the account, and give the system assigned identity access to the keyvault
$account = Set-AzStorageAccount -ResourceGroupName $resourceGroupName -Name $storageAccountName  -IdentityType SystemAssignedUserAssigned
Set-AzKeyVaultAccessPolicy -VaultName $keyvaultName -ResourceGroupName $resourceGroupName -ObjectId $account.Identity.PrincipalId -PermissionsToKeys get,wrapkey,unwrapkey -BypassObjectIdValidation

# Update account from access Keyvault with user assigned identity to access Keyvault with system assigned identity
$account = Set-AzStorageAccount -ResourceGroupName $resourceGroupName -Name $storageAccountName -IdentityType SystemAssignedUserAssigned -KeyName $keyname -KeyVaultUri $keyvaultUri -KeyVaultUserAssignedIdentityId ""

# EncryptionUserAssignedIdentity is empty, so the account access keyvault with system assigned identity
$account.Encryption.EncryptionIdentity

EncryptionUserAssignedIdentity
------------------------------

$account.Encryption.KeyVaultProperties

KeyName                       : wrappingKey
KeyVersion                    :
KeyVaultUri                   : https://mykeyvault.vault.azure.net:443
CurrentVersionedKeyIdentifier : https://mykeyvault.vault.azure.net/keys/wrappingKey/8e74036e0d534e58b3bd84b319e31d8f
LastKeyRotationTimestamp      : 4/12/2021 8:17:57 AM

Este comando primeiro atribui a identidade do sistema à conta e dá ao sistema acesso à identidade atribuída ao keyvault; em seguida, atualiza a conta de armazenamento para acessar o Keyvault com a identidade atribuída ao sistema.

Exemplo 17: Atualize o Keyvault e a identidade atribuída ao usuário para acessar o keyvault

# Update to another user assigned identity
$account = Set-AzStorageAccount -ResourceGroupName $resourceGroupName -Name $storageAccountName -IdentityType SystemAssignedUserAssigned -UserAssignedIdentityId $useridentity2 -KeyVaultUserAssignedIdentityId $useridentity2

# Update to encrypt with another keyvault
$account = Set-AzStorageAccount -ResourceGroupName $resourceGroupName -Name $storageAccountName -KeyVaultUri $keyvaultUri2 -KeyName $keyname2 -KeyVersion $keyversion2

Este comando primeiro atualiza a identidade atribuída ao usuário para acessar o keyvault e, em seguida, atualiza o keyvault para criptografia. Para atualizar o Keyvault e a identidade atribuída ao usuário, precisamos atualizar com as 2 etapas acima.

Exemplo 18: Atualizar uma conta de armazenamento com AllowCrossTenantReplication

$account = Set-AzStorageAccount -ResourceGroupName "myresourcegroup" -Name "mystorageaccount" -AllowCrossTenantReplication $false -EnableHttpsTrafficOnly $true

$account.AllowCrossTenantReplication

False

Este comando atualiza uma conta de armazenamento definindo AllowCrossTenantReplication como false e, em seguida, mostra as propriedades relacionadas à conta atualizada.

Exemplo 18: Atualizar uma conta de armazenamento habilitando PublicNetworkAccess

$account = Set-AzStorageAccount -ResourceGroupName "myresourcegroup" -Name "mystorageaccount" -PublicNetworkAccess Enabled

$account.PublicNetworkAccess

Enabled

Este comando atualiza uma conta de armazenamento definindo PublicNetworkAccess como habilitado.

Exemplo 19: Atualizar a política de imutabilidade no nível da conta

$account = Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -ImmutabilityPeriod 2 -ImmutabilityPolicyState Unlocked

$account.ImmutableStorageWithVersioning.Enabled
True

$account.ImmutableStorageWithVersioning.ImmutabilityPolicy

ImmutabilityPeriodSinceCreationInDays State
------------------------------------- -----
                                    2 Unlocked

O comando atualiza as propriedades da política de imutabilidade no nível da conta em uma conta de armazenamento existente e mostra o resultado. A conta de armazenamento deve ser criada com a imutabilidade em nível de conta habilitada com controle de versão. A política de imutabilidade no nível da conta será herdada e aplicada a objetos que não possuem uma política de imutabilidade explícita no nível do objeto.

Exemplo 20: Atualizar uma conta de armazenamento habilitando Sftp e localuser

$account = Set-AzStorageAccount -ResourceGroupName "myresourcegroup" -AccountName "mystorageaccount" -EnableSftp $true -EnableLocalUser $true

$account.EnableSftp
True

$account.EnableLocalUser
True

Este comando atualiza uma conta de armazenamento habilitando Sftp e localuser. Para executar o comando com êxito, a conta de armazenamento já deve habilitar o namespace hierárquico.

Exemplo 21: Atualizar uma conta de armazenamento com Keyvault de outro locatário (acessar Keyvault com FederatedClientId)

# create Storage account with Keyvault encryption (access Keyvault with FederatedClientId), then show properties
$account = Set-AzStorageAccount -ResourceGroupName $resourceGroupName -Name $storageAccountName  `
                -KeyVaultUri $keyVault.VaultUri -KeyName $keyname -KeyVaultUserAssignedIdentityId $useridentityId -KeyVaultFederatedClientId $federatedClientId

$account.Encryption.EncryptionIdentity

EncryptionUserAssignedIdentity                                                                                                      EncryptionFederatedIdentityClientId
------------------------------                                                                                                      -----------------------------------
/subscriptions/{subscription-id}/resourceGroups/myresourcegroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myuserid ********-****-****-****-************

$account.Encryption.KeyVaultProperties

KeyName                       : wrappingKey
KeyVersion                    :
KeyVaultUri                   : https://mykeyvault.vault.azure.net:443
CurrentVersionedKeyIdentifier : https://mykeyvault.vault.azure.net/keys/wrappingKey/8e74036e0d534e58b3bd84b319e31d8f
LastKeyRotationTimestamp      : 3/3/2022 2:07:34 AM

Este comando atualiza uma conta de armazenamento com Keyvault de outro locatário (acesse Keyvault com FederatedClientId).

Exemplo 22: Atualizar uma conta de armazenamento habilitando o SMB Oauth

$account = Set-AzStorageAccount -ResourceGroupName "myresourcegroup" -Name "mystorageaccount" -EnableSmbOAuth $true

$account.AzureFilesIdentityBasedAuth.SmbOAuthSettings.IsSmbOAuthEnabled

True

Este comando atualiza uma conta de armazenamento definindo EnableSmbOAuth como true e, em seguida, mostra as propriedades relacionadas à conta atualizadas.

Exemplo 23: Atualizar uma conta de armazenamento com a política de posicionamento de zona

$account = Set-AzStorageAccount -ResourceGroupName "myresourcegroup" -Name "myaccount" -Zone 1 -ZonePlacementPolicy "Any"

Este comando atualiza uma conta de armazenamento definindo Zone como 1 e ZonePlacementPolicy como Any, em seguida, mostra as propriedades relacionadas à conta atualizadas.

Exemplo 24: Habilitar a replicação de prioridade geográfica de blob em uma conta de armazenamento

$account = Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -EnableBlobGeoPriorityReplication $true

$account.GeoPriorityReplicationStatus.IsBlobEnabled

True

Este comando habilita a Replicação de Prioridade Geográfica de Blob em uma conta de armazenamento.

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 mais informações, consulte Azure Blob Storage: Escalões de armazenamento quente e frio. 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 .

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Valores aceites:	Hot, Cool, Cold
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-ActiveDirectoryAccountType

Especifica o tipo de conta Active Directory para Azure Storage. Os valores possíveis incluem: 'Utilizador', 'Computador'.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

ActiveDirectoryDomainServicesForFile

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-ActiveDirectoryAzureStorageSid

Especifica o identificador de segurança (SID) para Azure Storage. Este parâmetro deve ser definido quando -EnableActiveDirectoryDomainServicesForFile estiver definido como true.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

ActiveDirectoryDomainServicesForFile

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-ActiveDirectoryDomainGuid

Especifica o GUID do domínio. Este parâmetro deve ser definido quando -EnableActiveDirectoryDomainServicesForFile estiver definido como true.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

AzureActiveDirectoryKerberosForFile

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

ActiveDirectoryDomainServicesForFile

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-ActiveDirectoryDomainName

Especifica o domínio primário para o qual o servidor DNS do AD é autoritativo. Este parâmetro deve ser definido quando -EnableActiveDirectoryDomainServicesForFile estiver definido como true.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

AzureActiveDirectoryKerberosForFile

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

ActiveDirectoryDomainServicesForFile

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-ActiveDirectoryDomainSid

Especifica o identificador de segurança (SID). Este parâmetro deve ser definido quando -EnableActiveDirectoryDomainServicesForFile estiver definido como true.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

ActiveDirectoryDomainServicesForFile

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-ActiveDirectoryForestName

Especifica a floresta do Active Directory a obter. Este parâmetro deve ser definido quando -EnableActiveDirectoryDomainServicesForFile estiver definido como true.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

ActiveDirectoryDomainServicesForFile

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-ActiveDirectoryNetBiosDomainName

Especifica o nome de domínio NetBIOS. Este parâmetro deve ser definido quando -EnableActiveDirectoryDomainServicesForFile estiver definido como true.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

ActiveDirectoryDomainServicesForFile

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-ActiveDirectorySamAccountName

Especifica o Active Directory SAMAccountName para Azure Storage.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

ActiveDirectoryDomainServicesForFile

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-AllowBlobPublicAccess

Permitir ou não acesso anônimo a todos os blobs ou contêineres na conta de armazenamento.

Propriedades dos parâmetros

Tipo:	Boolean
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-AllowCrossTenantReplication

Obtém ou define que permitem ou não a replicação de objetos entre locatários Microsoft Entra. A interpretação padrão é verdadeira para esta propriedade.

Propriedades dos parâmetros

Tipo:	Boolean
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-AllowedCopyScope

Defina a restrição de cópia para e de Contas de Armazenamento dentro de um tenant Microsoft Entra ou com Links Privados para o mesmo VNet. Os valores possíveis incluem: 'PrivateLink', 'AAD'

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-AllowSharedKeyAccess

Indica se a conta de armazenamento permite que as solicitações sejam autorizadas com a chave de acesso da conta por meio da Chave Compartilhada. Se for falso, então todos os pedidos, incluindo assinaturas de acesso partilhado, devem ser autorizados com o Microsoft Entra ID. O valor padrão é null, que é equivalente a true.

Propriedades dos parâmetros

Tipo:	Boolean
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-AsJob

Executar cmdlet em segundo plano

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-AssignIdentity

Gerar e atribuir uma nova Identidade de Conta de Armazenamento para esta conta de Armazenamento para utilização em serviços de gestão de chaves como o Azure KeyVault.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	False
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	Cf.

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-CustomDomainName

Especifica o nome do domínio personalizado.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-DefaultProfile

As credenciais, conta, inquilino e subscrição usados para comunicação com o Azure.

Propriedades dos parâmetros

Tipo:	IAzureContextContainer
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-DefaultSharePermission

Permissão de compartilhamento padrão para usuários que usam a autenticação Kerberos se a função RBAC não estiver atribuída.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Valores aceites:	None, StorageFileDataSmbShareContributor, StorageFileDataSmbShareReader, StorageFileDataSmbShareElevatedContributor
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-EnableActiveDirectoryDomainServicesForFile

Ative Azure Files Active Directory Domain Autenticação de Serviço para a conta de armazenamento.

Propriedades dos parâmetros

Tipo:	Boolean
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

ActiveDirectoryDomainServicesForFile

Position:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-EnableAzureActiveDirectoryDomainServicesForFile

Ative o Azure Files Azure Active Directory Domain Service Authentication para a conta de armazenamento.

Propriedades dos parâmetros

Tipo:	Boolean
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

StorageEncryption

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

KeyvaultEncryption

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-EnableAzureActiveDirectoryKerberosForFile

Ative Azure Files Active Directory Domain Autenticação Kerberos do Serviço para a conta de armazenamento.

Propriedades dos parâmetros

Tipo:	Boolean
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

AzureActiveDirectoryKerberosForFile

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-EnableBlobGeoPriorityReplication

Indica se a Replicação de Prioridade Geográfica de Blob está habilitada para a conta de armazenamento. Esse recurso fornece replicação geográfica aprimorada com contrato de nível de serviço para replicação prioritária para melhorar os RTO (Recovery Time Objetives, objetivos de tempo de recuperação). Disponível apenas para tipos de conta de armazenamento com redundância geográfica (GRS, GZRS, RAGRS, RAGZRS).

Propriedades dos parâmetros

Tipo:	Boolean
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-EnableHttpsTrafficOnly

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

Propriedades dos parâmetros

Tipo:	Boolean
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-EnableLargeFileShare

Indica se a conta de armazenamento pode ou não suportar grandes compartilhamentos de arquivos com mais de 5 TiB de capacidade. Depois que a conta estiver ativada, o recurso não poderá ser desativado. Atualmente, só há suporte para os tipos de replicação LRS e ZRS, portanto, as conversões de conta para contas com redundância geográfica não seriam possíveis. Saiba mais em

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-EnableLocalUser

Habilite o recurso de usuários locais para a conta de armazenamento.

Propriedades dos parâmetros

Tipo:	Boolean
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-EnableSftp

Habilite o protocolo de transferência segura de arquivos para a conta de armazenamento.

Propriedades dos parâmetros

Tipo:	Boolean
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-EnableSmbOAuth

Especifica se as identidades gerenciadas podem acessar compartilhamentos SMB usando OAuth.

Propriedades dos parâmetros

Tipo:	Boolean
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-Force

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

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-IdentityType

Defina o novo tipo de Identidade de Conta de Armazenamento, a identidade é para uso em serviços de gestão de chaves como o Azure KeyVault.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Valores aceites:	SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-ImmutabilityPeriod

O período de imutabilidade para os blobs no contêiner desde a criação da política em dias. Esta propriedade só pode ser alterada quando a conta é criada com '-EnableAccountLevelImmutability'.

Propriedades dos parâmetros

Tipo:	Int32
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-ImmutabilityPolicyState

O modo da política. Os valores possíveis incluem: 'Desbloqueado', 'Bloqueado', 'Desativado. O estado desativado desativa a política. O estado desbloqueado permite aumentar e diminuir o tempo de retenção de imutabilidade e também permite alternar a propriedade allowProtectedAppendWrites. O estado bloqueado só permite o aumento do tempo de retenção de imutabilidade. Uma política só pode ser criada no estado Desativado ou Desbloqueado e pode ser alternada entre os dois estados. Somente uma política em um estado Desbloqueado pode fazer a transição para um estado Bloqueado que não pode ser revertido. Esta propriedade só pode ser alterada quando a conta é criada com '-EnableAccountLevelImmutability'.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-KeyExpirationPeriodInDay

O período de expiração da chave desta conta, é preciso para dias.

Propriedades dos parâmetros

Tipo:	Int32
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-KeyName

Se usar -KeyvaultEncryption para ativar a encriptação com Key Vault, especifique a propriedade Nome Chave com esta opção.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

KeyvaultEncryption

Position:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	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.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

KeyvaultEncryption

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-KeyVaultFederatedClientId

Defina ClientId do aplicativo multilocatário a ser usado em conjunto com a identidade atribuída pelo usuário para criptografia do lado do servidor de chaves gerenciadas pelo cliente entre locatários na conta de armazenamento.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-KeyVaultUri

Ao usar Key Vault Encriptação, especificando o parâmetro -KeyvaultEncryption, use esta opção para especificar o URI do Key Vault.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

KeyvaultEncryption

Position:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-KeyVaultUserAssignedIdentityId

Definir o ID de recurso para a Identidade atribuída pelo utilizador usada para aceder ao Azure KeyVault da Encriptação da Conta de Armazenamento, o id deve estar no UserAssignIdentityID da conta de armazenamento.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-KeyVersion

Ao usar Key Vault Encriptação, especificando o parâmetro -KeyvaultEncryption, use esta opção para especificar o URI da Versão da Chave.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

KeyvaultEncryption

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-MinimumTlsVersion

A versão mínima do TLS a ser permitida em solicitações de armazenamento.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Valores aceites:	TLS1_0, TLS1_1, TLS1_2, TLS1_3
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-Name

Especifica o nome da conta de armazenamento a ser modificada.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	NomeDaContaDeArmazenamento, Nome da Conta

Conjuntos de parâmetros

(All)

Position:	1
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	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.

Propriedades dos parâmetros

Tipo:	PSNetworkRuleSet
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-PublicNetworkAccess

Permitir ou não permitir o acesso à rede pública à Conta de Armazenamento.Os valores possíveis incluem: 'Ativado', 'Desativado'.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-PublishInternetEndpoint

Indica se os pontos de extremidade de armazenamento de roteamento da Internet devem ser publicados

Propriedades dos parâmetros

Tipo:	Boolean
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-PublishMicrosoftEndpoint

Indica se os pontos de extremidade de armazenamento de roteamento da Microsoft devem ser publicados

Propriedades dos parâmetros

Tipo:	Boolean
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-ResourceGroupName

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

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	0
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-RoutingChoice

A opção de roteamento define o tipo de roteamento de rede escolhido pelo usuário. Os valores possíveis incluem: 'MicrosoftRouting', 'InternetRouting'

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Valores aceites:	MicrosoftRouting, InternetRouting
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-SasExpirationAction

A ação a ser executada quando SasExpirationPeriod é violado. A ação 'Log' pode ser usada para fins de auditoria e a ação 'Bloquear' pode ser usada para bloquear e negar o uso de tokens SAS que não aderem ao período de expiração da política sas.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-SasExpirationPeriod

O período de expiração SAS desta conta, é um período de tempo e preciso para segundos.

Propriedades dos parâmetros

Tipo:	TimeSpan
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	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.
Standard_GZRS - Armazenamento com redundância de zona com redundância geográfica.
Standard_RAGZRS - Armazenamento com redundância de zona com redundância geográfica de acesso de leitura.
StandardV2_LRS - Armazenamento com redundância local para o File Provision v2.
StandardV2_GRS - Armazenamento com redundância geográfica para o File Provision v2.
StandardV2_ZRS - Armazenamento com redundância de zona para o File Provision v2.
StandardV2_GZRS - Armazenamento com redundância de zona com redundância geográfica para Fornecimento de Arquivos v2.
PremiumV2_LRS - Armazenamento premium com redundância local para o File Provision v2.
PremiumV2_ZRS - Armazenamento com redundância de zona Premium para Provisionamento de Arquivos v2. 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.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Valores aceites:	Standard_LRS, Standard_ZRS, Standard_GRS, Standard_RAGRS, Premium_LRS, Standard_GZRS, Standard_RAGZRS, StandardV2_LRS, StandardV2_ZRS, StandardV2_GZRS, StandardV2_GRS, PremiumV2_LRS, PremiumV2_ZRS
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	StorageAccountType, Tipo de Conta, Tipo

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-StorageEncryption

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

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

StorageEncryption

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	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"}

Propriedades dos parâmetros

Tipo:	Hashtable
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	Etiquetas

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-UpgradeToStorageV2

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

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-UserAssignedIdentityId

Defina IDs de recurso para a nova Identidade atribuída pelo utilizador da Conta de Armazenamento, a identidade será usada com serviços de gestão de chaves como o Azure KeyVault.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-UseSubDomain

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

Propriedades dos parâmetros

Tipo:	Nullable<T>[Boolean]
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	False
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	Wi

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-Zone

Descreve as zonas disponíveis para o produto onde o recurso de conta de armazenamento pode ser criado

Propriedades dos parâmetros

Tipo:	String[]
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-ZonePlacementPolicy

A política de fixação da zona de disponibilidade para a conta de armazenamento.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Partilhar via

Set-AzStorageAccount

Sintaxe

StorageEncryption (Predefinição)

KeyvaultEncryption

AzureActiveDirectoryKerberosForFile

ActiveDirectoryDomainServicesForFile

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"

Exemplo 10: Atualize uma conta de Armazenamento ativando Azure Files Microsoft Entra Autenticação dos Serviços de Domínio e defina o DefaultSharePermission.

Exemplo 11: Atualize uma conta de Armazenamento ativando a autenticação do serviço Files Active Directory Domain Service e depois mostre a definição de autenticação baseada em identidade de ficheiro

Exemplo 12: Definir MinimumTlsVersion, AllowBlobPublicAccess e AllowSharedKeyAccess

Exemplo 13: Atualizar uma conta de armazenamento com a configuração RoutingPreference

Exemplo 14: Atualizar uma conta de armazenamento com KeyExpirationPeriod e SasExpirationPeriod com SasExpirationAction

Exemplo 15: Atualizar uma conta de armazenamento para criptografia Keyvault e acessar Keyvault com identidade atribuída pelo usuário

Exemplo 16: Atualizar uma conta de armazenamento criptografada Keyvault, de acessar Keyvault com identidade atribuída pelo usuário, para acessar Keyvault com identidade atribuída ao sistema

Exemplo 17: Atualize o Keyvault e a identidade atribuída ao usuário para acessar o keyvault

Exemplo 18: Atualizar uma conta de armazenamento com AllowCrossTenantReplication

Exemplo 18: Atualizar uma conta de armazenamento habilitando PublicNetworkAccess

Exemplo 19: Atualizar a política de imutabilidade no nível da conta

Exemplo 20: Atualizar uma conta de armazenamento habilitando Sftp e localuser

Exemplo 21: Atualizar uma conta de armazenamento com Keyvault de outro locatário (acessar Keyvault com FederatedClientId)

Exemplo 22: Atualizar uma conta de armazenamento habilitando o SMB Oauth

Exemplo 23: Atualizar uma conta de armazenamento com a política de posicionamento de zona

Exemplo 24: Habilitar a replicação de prioridade geográfica de blob em uma conta de armazenamento

Parâmetros

-AccessTier

Propriedades dos parâmetros

Conjuntos de parâmetros

-ActiveDirectoryAccountType

Propriedades dos parâmetros

Conjuntos de parâmetros

-ActiveDirectoryAzureStorageSid

Propriedades dos parâmetros

Conjuntos de parâmetros

-ActiveDirectoryDomainGuid

Propriedades dos parâmetros

Conjuntos de parâmetros

-ActiveDirectoryDomainName

Propriedades dos parâmetros

Conjuntos de parâmetros

-ActiveDirectoryDomainSid

Propriedades dos parâmetros

Conjuntos de parâmetros

-ActiveDirectoryForestName

Propriedades dos parâmetros

Conjuntos de parâmetros

-ActiveDirectoryNetBiosDomainName

Propriedades dos parâmetros

Conjuntos de parâmetros

-ActiveDirectorySamAccountName

Propriedades dos parâmetros

Conjuntos de parâmetros

-AllowBlobPublicAccess

Propriedades dos parâmetros

Conjuntos de parâmetros

-AllowCrossTenantReplication

Propriedades dos parâmetros

Conjuntos de parâmetros

-AllowedCopyScope

Propriedades dos parâmetros

Conjuntos de parâmetros

-AllowSharedKeyAccess

Propriedades dos parâmetros

Conjuntos de parâmetros

-AsJob

Propriedades dos parâmetros

Conjuntos de parâmetros

-AssignIdentity

Propriedades dos parâmetros

Conjuntos de parâmetros