Set-AzStorageAccount

Módulo:: Az.Storage Module

Modifica uma conta de armazenamento.

Sintaxe

StorageEncryption (Default)

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 de Armazenamento do Azure. Você pode usar esse cmdlet para modificar o tipo de conta, atualizar um domínio do 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"

Esse 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

Esse 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 esporádico.

Exemplo 4: Definir o domínio e as marcas personalizados

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 marcas de uma conta de Armazenamento.

Exemplo 5: Definir a Chave de Criptografia 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 o Encryption KeySource com um novo Keyvault criado. Se quiser habilitar a rotação automática de chaves, não defina a keyversion quando definir as propriedades do Keyvault pela primeira vez ou limpe-a definindo as propriedades de keyvault novamente com keyversion como vazias.

Exemplo 6: Definir a Chave de Criptografia como "Microsoft.Storage"

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

Este comando define o 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 "Armazenamento" ou "BlobStorage" para a conta de armazenamento do tipo "StorageV2"

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

O comando atualiza uma conta de armazenamento com o tipo "Armazenamento" ou "BlobStorage" para a conta de armazenamento do tipo "StorageV2".

Exemplo 10: atualize uma conta de armazenamento habilitando a Autenticação do Microsoft Entra Domain Services dos Arquivos do Azure e defina 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 habilitando a Autenticação do Microsoft Entra Domain Services dos Arquivos do Azure.

Exemplo 11: Atualizar uma conta de armazenamento habilitando a Autenticação do Serviço de Domínio do Active Directory de Arquivos e, em seguida, mostrar a configuração de autenticação baseada em identidade de arquivo

$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 habilitando a Autenticação do Serviço de Domínio do Active Directory dos Arquivos do Azure e mostra a configuração de autenticação baseada em identidade de arquivo

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 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/"}

Esse 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

Esse 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 o Keyvault com a 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

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

Exemplo 16: Atualizar uma conta de Armazenamento criptografada do Keyvault, do acesso ao Keyvault com a identidade atribuída pelo usuário, para acessar o Keyvault com a identidade atribuída pelo 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

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

Exemplo 17: Atualizar o Keyvault e a identidade atribuída pelo 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

Esse comando primeiro atualiza a identidade atribuída pelo usuário para acessar o keyvault e, em seguida, atualiza o keyvault para criptografia. Para atualizar o Keyvault e a identidade atribuída pelo usuário, precisamos atualizar com as duas 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

Esse 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

Esse 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 de 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

Esse 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

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

Exemplo 22: atualizar uma conta de armazenamento habilitando Oauth SMB

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

$account.AzureFilesIdentityBasedAuth.SmbOAuthSettings.IsSmbOAuthEnabled

True

Esse comando atualiza uma conta de Armazenamento definindo EnableSmbOAuth como true e, em seguida, mostra as propriedades relacionadas à conta atualizada.

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"

Esse comando atualiza uma conta de Armazenamento definindo Zone como 1 e ZonePlacementPolicy como Any e mostra as propriedades relacionadas à conta atualizada.

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

Esse 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 este cmdlet modifica. Os valores aceitáveis para esse parâmetro são: Hot e Cool. Se você alterar a camada de acesso, isso poderá resultar em encargos adicionais. Para obter mais informações, consulte o Armazenamento de Blobs do Azure: camadas de armazenamento frequentes e esporádicas. Se a conta de armazenamento tiver Kind as StorageV2 ou BlobStorage, você poderá especificar o parâmetro AccessTier . Se a conta de armazenamento tiver Tipo como Armazenamento, não especifique o parâmetro AccessTier .

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Valores aceitos:	Hot, Cool, Cold
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-ActiveDirectoryAccountType

Especifica o tipo de conta do Active Directory para o Armazenamento do Azure. Os valores possíveis incluem: 'User', 'Computer'.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

ActiveDirectoryDomainServicesForFile

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-ActiveDirectoryAzureStorageSid

Especifica o SID (identificador de segurança) para o Armazenamento do Azure. Esse parâmetro deve ser definido quando -EnableActiveDirectoryDomainServicesForFile é definido como true.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

ActiveDirectoryDomainServicesForFile

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-ActiveDirectoryDomainGuid

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

AzureActiveDirectoryKerberosForFile

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

ActiveDirectoryDomainServicesForFile

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-ActiveDirectoryDomainName

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

AzureActiveDirectoryKerberosForFile

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

ActiveDirectoryDomainServicesForFile

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-ActiveDirectoryDomainSid

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

ActiveDirectoryDomainServicesForFile

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-ActiveDirectoryForestName

Especifica a floresta do Active Directory a ser obtida. Esse parâmetro deve ser definido quando -EnableActiveDirectoryDomainServicesForFile é definido como true.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

ActiveDirectoryDomainServicesForFile

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-ActiveDirectoryNetBiosDomainName

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

ActiveDirectoryDomainServicesForFile

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-ActiveDirectorySamAccountName

Especifica o SAMAccountName do Active Directory para o Armazenamento do Azure.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

ActiveDirectoryDomainServicesForFile

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-AllowBlobPublicAccess

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

Propriedades do parâmetro

Tipo:	Boolean
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-AllowCrossTenantReplication

Obtém ou define permitir ou não a replicação entre objetos de locatário do Microsoft Entra. A interpretação padrão é verdadeira para essa propriedade.

Propriedades do parâmetro

Tipo:	Boolean
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-AllowedCopyScope

Defina restringir a cópia de e para contas de armazenamento em um locatário do Microsoft Entra ou com Links Privados para a mesma VNet. Os valores possíveis incluem: 'PrivateLink', 'AAD'

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	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, todas as solicitações, incluindo assinaturas de acesso compartilhado, deverão ser autorizadas com a ID do Microsoft Entra. O valor padrão é nulo, que é equivalente a true.

Propriedades do parâmetro

Tipo:	Boolean
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-AsJob

Executar cmdlet em segundo plano

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-AssignIdentity

Gere e atribua uma nova identidade de conta de armazenamento para essa conta de Armazenamento para uso com serviços de gerenciamento de chaves como o Azure KeyVault.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Confirm

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

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	False
Dá suporte a curingas:	False
DontShow:	False
Aliases:	cf

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-CustomDomainName

Especifica o nome do domínio personalizado.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-DefaultProfile

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

Propriedades do parâmetro

Tipo:	IAzureContextContainer
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False
Aliases:	AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-DefaultSharePermission

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Valores aceitos:	None, StorageFileDataSmbShareContributor, StorageFileDataSmbShareReader, StorageFileDataSmbShareElevatedContributor
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-EnableActiveDirectoryDomainServicesForFile

Habilite a Autenticação do Serviço de Domínio do Active Directory dos Arquivos do Azure para a conta de armazenamento.

Propriedades do parâmetro

Tipo:	Boolean
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

ActiveDirectoryDomainServicesForFile

Cargo:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-EnableAzureActiveDirectoryDomainServicesForFile

Habilite a Autenticação do Serviço de Domínio do Azure Active Directory dos Arquivos do Azure para a conta de armazenamento.

Propriedades do parâmetro

Tipo:	Boolean
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

StorageEncryption

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

KeyvaultEncryption

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-EnableAzureActiveDirectoryKerberosForFile

Habilite a Autenticação Kerberos do Serviço de Domínio do Active Directory dos Arquivos do Azure para a conta de armazenamento.

Propriedades do parâmetro

Tipo:	Boolean
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

AzureActiveDirectoryKerberosForFile

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	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 de prioridade para melhorar os RTO (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 do parâmetro

Tipo:	Boolean
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-EnableHttpsTrafficOnly

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

Propriedades do parâmetro

Tipo:	Boolean
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-EnableLargeFileShare

Indica se a conta de armazenamento pode ou não dar suporte a compartilhamentos de arquivos grandes com mais de 5 TiB de capacidade. Depois que a conta estiver habilitada, o recurso não poderá ser desabilitado. Atualmente, há suporte apenas para tipos de replicação LRS e ZRS, portanto, conversões de conta em contas com redundância geográfica não seriam possíveis. Saiba mais em https://go.microsoft.com/fwlink/?linkid=2086047

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-EnableLocalUser

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

Propriedades do parâmetro

Tipo:	Boolean
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-EnableSftp

Habilite o Protocolo de Transferência de Arquivo Seguro para a conta de Armazenamento.

Propriedades do parâmetro

Tipo:	Boolean
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-EnableSmbOAuth

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

Propriedades do parâmetro

Tipo:	Boolean
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Force

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

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-IdentityType

Defina o novo tipo de Identidade da Conta de Armazenamento, a identidade é usada com serviços de gerenciamento de chaves, como o Azure KeyVault.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Valores aceitos:	SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-ImmutabilityPeriod

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

Propriedades do parâmetro

Tipo:	Int32
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-ImmutabilityPolicyState

O modo da política. Os valores possíveis incluem: 'Desbloqueado', 'Bloqueado', 'Desabilitado. O estado desabilitado desabilita a política. O estado desbloqueado permite aumentar e diminuir o tempo de retenção de imutabilidade e também permite a agregação da propriedade allowProtectedAppendWrites. O estado bloqueado permite apenas o aumento do tempo de retenção de imutabilidade. Uma política só pode ser criada em um estado desabilitado 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. Essa propriedade só pode ser alterada quando a conta é criada com '-EnableAccountLevelImmutability'.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-KeyExpirationPeriodInDay

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

Propriedades do parâmetro

Tipo:	Int32
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-KeyName

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

KeyvaultEncryption

Cargo:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-KeyvaultEncryption

Indica se o Microsoft KeyVault deve ou não usar 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 se esse parâmetro estiver definido ou não.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

KeyvaultEncryption

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	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 do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-KeyVaultUri

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

KeyvaultEncryption

Cargo:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-KeyVaultUserAssignedIdentityId

Defina a ID do recurso para a Identidade atribuída pelo usuário usada para acessar o Azure KeyVault da Criptografia da Conta de Armazenamento, a id deve estar no UserAssignIdentityId da conta de armazenamento.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-KeyVersion

Ao usar a Criptografia do Key Vault especificando o parâmetro -KeyvaultEncryption, use essa opção para especificar o URI para a Versão da Chave.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

KeyvaultEncryption

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-MinimumTlsVersion

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Valores aceitos:	TLS1_0, TLS1_1, TLS1_2, TLS1_3
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Name

Especifica o nome da conta de Armazenamento a ser modificada.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False
Aliases:	NomeDaContaDeArmazenamento, Nome da Conta

Conjuntos de parâmetros

(All)

Cargo:	1
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	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 do parâmetro

Tipo:	PSNetworkRuleSet
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-PublicNetworkAccess

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-PublishInternetEndpoint

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

Propriedades do parâmetro

Tipo:	Boolean
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-PublishMicrosoftEndpoint

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

Propriedades do parâmetro

Tipo:	Boolean
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-ResourceGroupName

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	0
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-RoutingChoice

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Valores aceitos:	MicrosoftRouting, InternetRouting
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-SasExpirationAction

A ação a ser executada quando SasExpirationPeriod é violada. 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 do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-SasExpirationPeriod

O período de expiração de SAS dessa conta, é um período de tempo e precisa de segundos.

Propriedades do parâmetro

Tipo:	TimeSpan
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	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 – Ler o armazenamento com redundância geográfica de acesso.
Premium_LRS – Armazenamento com redundância local Premium.
Standard_GZRS – armazenamento com redundância de zona com redundância geográfica.
Standard_RAGZRS – Ler o armazenamento com redundância de zona com redundância geográfica de acesso.
StandardV2_LRS – armazenamento com redundância local para Provisionamento de Arquivos v2.
StandardV2_GRS – armazenamento com redundância geográfica para Provisionamento de Arquivos v2.
StandardV2_ZRS – Armazenamento com redundância de zona para Provisionamento de Arquivos v2.
StandardV2_GZRS – armazenamento com redundância de zona com redundância geográfica para Provisionamento de Arquivos v2.
PremiumV2_LRS – Armazenamento com redundância local Premium para Provisionamento de Arquivos v2.
PremiumV2_ZRS – Armazenamento com redundância de zona Premium para Provisionamento de Arquivos v2. Você não pode 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 do parâmetro

Tipo:	String
Valor padrão:	None
Valores aceitos:	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
Dá suporte a curingas:	False
DontShow:	False
Aliases:	StorageAccountType, Tipo de Conta, Tipo

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-StorageEncryption

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

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

StorageEncryption

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Tag

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

Propriedades do parâmetro

Tipo:	Hashtable
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False
Aliases:	Etiquetas

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-UpgradeToStorageV2

Atualizar tipo de conta de armazenamento do Armazenamento ou blobStorage para StorageV2.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-UserAssignedIdentityId

Defina ids de recurso para a nova Identidade atribuída pelo usuário da Conta de Armazenamento, a identidade será usada com serviços de gerenciamento de chaves, como o Azure KeyVault.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-UseSubDomain

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

Propriedades do parâmetro

Tipo:	Nullable<T>[Boolean]
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-WhatIf

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

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	False
Dá suporte a curingas:	False
DontShow:	False
Aliases:	wi

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Zone

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

Propriedades do parâmetro

Tipo:	String[]
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-ZonePlacementPolicy

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	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.

Compartilhar via

Set-AzStorageAccount

Sintaxe

StorageEncryption (Default)

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 e as marcas personalizados

Exemplo 5: Definir a Chave de Criptografia como Keyvault

Exemplo 6: Definir a Chave de Criptografia 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 "Armazenamento" ou "BlobStorage" para a conta de armazenamento do tipo "StorageV2"

Exemplo 10: atualize uma conta de armazenamento habilitando a Autenticação do Microsoft Entra Domain Services dos Arquivos do Azure e defina DefaultSharePermission.

Exemplo 11: Atualizar uma conta de armazenamento habilitando a Autenticação do Serviço de Domínio do Active Directory de Arquivos e, em seguida, mostrar a configuração de autenticação baseada em identidade de arquivo

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 o Keyvault com a identidade atribuída pelo usuário

Exemplo 16: Atualizar uma conta de Armazenamento criptografada do Keyvault, do acesso ao Keyvault com a identidade atribuída pelo usuário, para acessar o Keyvault com a identidade atribuída pelo sistema

Exemplo 17: Atualizar o Keyvault e a identidade atribuída pelo 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 Oauth SMB

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 do parâmetro

Conjuntos de parâmetros

-ActiveDirectoryAccountType

Propriedades do parâmetro

Conjuntos de parâmetros

-ActiveDirectoryAzureStorageSid

Propriedades do parâmetro

Conjuntos de parâmetros

-ActiveDirectoryDomainGuid

Propriedades do parâmetro

Conjuntos de parâmetros

-ActiveDirectoryDomainName

Propriedades do parâmetro

Conjuntos de parâmetros

-ActiveDirectoryDomainSid

Propriedades do parâmetro

Conjuntos de parâmetros

-ActiveDirectoryForestName

Propriedades do parâmetro

Conjuntos de parâmetros

-ActiveDirectoryNetBiosDomainName

Propriedades do parâmetro

Conjuntos de parâmetros

-ActiveDirectorySamAccountName

Propriedades do parâmetro

Conjuntos de parâmetros

-AllowBlobPublicAccess

Propriedades do parâmetro

Conjuntos de parâmetros

-AllowCrossTenantReplication

Propriedades do parâmetro

Conjuntos de parâmetros

-AllowedCopyScope

Propriedades do parâmetro

Conjuntos de parâmetros

-AllowSharedKeyAccess

Propriedades do parâmetro

Conjuntos de parâmetros

-AsJob

Propriedades do parâmetro

Conjuntos de parâmetros

-AssignIdentity

Propriedades do parâmetro

Conjuntos de parâmetros