Uso di Azure PowerShell con Archiviazione di AzureUsing Azure PowerShell with Azure Storage

Azure PowerShell consente di creare e gestire risorse di Azure dalla riga di comando di PowerShell o negli script.Azure PowerShell is used to create and manage Azure resources from the PowerShell command line or in scripts. Per Archiviazione di Azure, i cmdlet possono essere suddivisi in due categorie: piano di controllo e piano dati.For Azure Storage, these cmdlets fall into two categories -- the control plane and the data plane. I cmdlet del piano di controllo consentono di gestire l'account di archiviazione, ovvero creare account di archiviazione, impostare le proprietà, eliminare account di archiviazione, ruotare le chiavi di accesso e così via.The control plane cmdlets are used to manage the storage account -- to create storage accounts, set properties, delete storage accounts, rotate the access keys, and so on. I cmdlet del piano dati consentono invece di gestire i dati archiviati nell' account di archiviazione,The data plane cmdlets are used to manage the data stored in the storage account. ovvero caricare file BLOB, creare condivisioni file e aggiungere messaggi a una coda.For example, uploading blobs, creating file shares, and adding messages to a queue.

Questo articolo illustra le operazioni comunemente eseguite quando si usano i cmdlet del piano di gestione per gestire gli account di archiviazione.This how-to article covers common operations using the management plane cmdlets to manage storage accounts. Si apprenderà come:You learn how to:

  • Elencare gli account di archiviazioneList storage accounts
  • Ottenere un riferimento a un account di archiviazione esistenteGet a reference to an existing storage account
  • Creare un account di archiviazioneCreate a storage account
  • Impostare le proprietà dell'account di archiviazioneSet storage account properties
  • Recuperare e rigenerare le chiavi dell'accountRetrieve and regenerate the access keys
  • Proteggere l'accesso all'account di archiviazioneProtect access to your storage account
  • Abilitare Analisi archiviazioneEnable Storage Analytics

Questo articolo fornisce collegamenti a vari altri articoli su PowerShell per l'archiviazione, ad esempio su come abilitare e accedere ad Analisi archiviazione, come usare i cmdlet del piano dati e come accedere a cloud indipendenti di Azure, ad esempio il cloud per la Cina, il cloud per la Germania e il cloud per enti pubblici.This article provides links to several other PowerShell articles for Storage, such as how to enable and access the Storage Analytics, how to use the data plane cmdlets, and how to access the Azure independent clouds such as China Cloud, German Cloud, and Government Cloud.

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.If you don't have an Azure subscription, create a free account before you begin.

Nota

Questo articolo è stato aggiornato per usare il nuovo modulo Az di Azure PowerShell.This article has been updated to use the new Azure PowerShell Az module. È comunque possibile usare il modulo AzureRM, che continuerà a ricevere correzioni di bug almeno fino a dicembre 2020.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Per altre informazioni sul nuovo modulo Az e sulla compatibilità di AzureRM, vedere Introduzione del nuovo modulo Az di Azure PowerShell.To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Per istruzioni sull'installazione del modulo Az, vedere Installare Azure PowerShell.For Az module installation instructions, see Install Azure PowerShell.

Per questa esercitazione, è necessario il modulo Azure PowerShell Az 0.7 o versioni successive.This exercise requires the Azure PowerShell module Az version 0.7 or later. Eseguire Get-Module -ListAvailable Az per trovare la versione.Run Get-Module -ListAvailable Az to find the version. Se è necessario eseguire l'installazione o l'aggiornamento, vedere come installare il modulo Azure PowerShell.If you need to install or upgrade, see Install Azure PowerShell module.

Per questa esercitazione è possibile digitare i comandi in una normale finestra di PowerShell oppure usare Windows PowerShell Integrated Scripting Environment (ISE), digitare i comandi in un editor e quindi testare uno o più comandi contemporaneamente mentre si procede con l'esercitazione.For this exercise, you can type the commands into a regular PowerShell window, or you can use the Windows PowerShell Integrated Scripting Environment (ISE) and type the commands into an editor, then test one or more commands at a time as you go through the examples. È possibile evidenziare le righe che si vuole eseguire e fare clic su Esegui selezionati per eseguire solo i comandi corrispondenti.You can highlight the rows you want to execute and click Run Selected to just run those commands.

Per altre informazioni sugli account di archiviazione, vedere Introduzione ad Archiviazione e Informazioni sugli account di archiviazione di Azure.For more information about storage accounts, see Introduction to Storage and About Azure storage accounts.

Accedere ad AzureSign in to Azure

Accedere alla sottoscrizione di Azure con il comando Connect-AzAccount e seguire le istruzioni visualizzate.Sign in to your Azure subscription with the Connect-AzAccount command and follow the on-screen directions.

Connect-AzAccount

Elencare gli account di archiviazione nella sottoscrizioneList the storage accounts in the subscription

Eseguire il cmdlet Get-AzStorageAccount per recuperare l'elenco degli account di archiviazione disponibili nella sottoscrizione corrente.Run the Get-AzStorageAccount cmdlet to retrieve the list of storage accounts in the current subscription.

Get-AzStorageAccount | Select StorageAccountName, Location

Ottenere un riferimento a un account di archiviazioneGet a reference to a storage account

A questo punto, è necessario un riferimento a un account di archiviazione.Next, you need a reference to a storage account. È possibile creare un nuovo account di archiviazione oppure ottenere un riferimento a un account di archiviazione esistente.You can either create a new storage account or get a reference to an existing storage account. La sezione seguente illustra entrambi i metodi.The following section shows both methods.

Usare un account di archiviazione esistenteUse an existing storage account

Per recuperare un account di archiviazione esistente, sono necessari il nome del gruppo di risorse e il nome dell'account di archiviazione.To retrieve an existing storage account, you need the name of the resource group and the name of the storage account. Impostare le variabili per questi due campi e quindi usare il cmdlet Get-AzStorageAccount.Set the variables for those two fields, then use the Get-AzStorageAccount cmdlet.

$resourceGroup = "myexistingresourcegroup"
$storageAccountName = "myexistingstorageaccount"

$storageAccount = Get-AzStorageAccount -ResourceGroupName $resourceGroup `
  -Name $storageAccountName

Si dispone adesso di $storageAccount, che fa riferimento a un account di archiviazione esistente.Now you have $storageAccount, which points to an existing storage account.

Creare un account di archiviazioneCreate a storage account

Lo script seguente illustra come creare un account di archiviazione per utilizzo generico usando New-AzStorageAccount.The following script shows how to create a general-purpose storage account using New-AzStorageAccount. Dopo aver creato l'account è necessario recuperarne il contesto, che può essere usato nei comandi successivi anziché specificare l'autenticazione con ogni chiamata.After you create the account, retrieve its context, which can be used in subsequent commands rather than specifying the authentication with each call.

# Get list of locations and select one.
Get-AzLocation | select Location
$location = "eastus"

# Create a new resource group.
$resourceGroup = "teststoragerg"
New-AzResourceGroup -Name $resourceGroup -Location $location

# Set the name of the storage account and the SKU name.
$storageAccountName = "testpshstorage"
$skuName = "Standard_LRS"

# Create the storage account.
$storageAccount = New-AzStorageAccount -ResourceGroupName $resourceGroup `
  -Name $storageAccountName `
  -Location $location `
  -SkuName $skuName

# Retrieve the context.
$ctx = $storageAccount.Context

Lo script usa i cmdlet di PowerShell seguenti:The script uses the following PowerShell cmdlets:

  • Get-AzLocation: recupera un elenco delle posizioni valide.Get-AzLocation -- retrieves a list of the valid locations. Nell'esempio viene usata la posizione eastus.The example uses eastus for location.

  • New-AzResourceGroup: crea un nuovo gruppo di risorse.New-AzResourceGroup -- creates a new resource group. Un gruppo di risorse è un contenitore logico in cui le risorse di Azure vengono distribuite e gestite.A resource group is a logical container into which your Azure resources are deployed and managed. Il gruppo di risorse dell'esempio è chiamato teststoragerg.Ours is called teststoragerg.

  • New-AzStorageAccount: crea l'account di archiviazione.New-AzStorageAccount -- creates the storage account. Nell'esempio viene usato testpshstorage.The example uses testpshstorage.

Il nome dello SKU indica il tipo di replica per l'account di archiviazione, ad esempio l'archiviazione con ridondanza locale.The SKU name indicates the type of replication for the storage account, such as LRS (Locally Redundant Storage). Per altre informazioni sulla replica, vedere Replica di Archiviazione di Azure.For more information about replication, see Azure Storage Replication.

Importante

Il nome per l'account di archiviazione è univoco in Azure e deve essere in minuscolo.The name of your storage account must be unique within Azure and must be lowercase. Per informazioni sulle limitazioni e le convenzioni relative ai nomi, vedere Assegnazione di nome e riferimento a contenitori, BLOB e metadati.For naming conventions and restrictions, see Naming and Referencing Containers, Blobs, and Metadata.

Si dispone ora di un nuovo account di archiviazione e di un riferimento ad esso.Now you have a new storage account and a reference to it.

Gestire l'account di archiviazioneManage the storage account

È stato così ottenuto un riferimento a un nuovo account di archiviazione o a un account di archiviazione esistente. La sezione seguente illustra alcuni dei comandi che è possibile usare per gestire l'account di archiviazione personale.Now that you have a reference to a new storage account or an existing storage account, the following section shows some of the commands you can use to manage your storage account.

Proprietà dell'account di archiviazioneStorage account properties

Per modificare le impostazioni di un account di archiviazione, usare Set-AzStorageAccount.To change the settings for a storage account, use Set-AzStorageAccount. Sebbene non sia possibile modificare la posizione di un account di archiviazione o del gruppo di risorse in cui si trova, è possibile modificare molte altre proprietà.While you can't change the location of a storage account, or the resource group in which it resides, you can change many of the other properties. Di seguito sono elencate alcune delle proprietà che è possibile modificare tramite PowerShell.The following lists some of the properties you can change using PowerShell.

  • Il dominio personalizzato assegnato all'account di archiviazione.The custom domain assigned to the storage account.

  • I tag assegnati all'account di archiviazione.The tags assigned to the storage account. I tag vengono usati spesso per categorizzare le risorse a scopi di fatturazione.Tags are often used to categorize resources for billing purposes.

  • Lo SKU, ovvero l'impostazione di replica per l'account di archiviazione, ad esempio LRS per l'archiviazione con ridondanza locale.The SKU is the replication setting for the storage account, such as LRS for Locally Redundant Storage. È possibile, ad esempio, modificare Standard_LRS in Standard_GRS o Standard_RAGRS.For example, you might change from Standard_LRS to Standard_GRS or Standard_RAGRS. Si noti che non è possibile modificare standard_ZRS, standard_GZRS, standard_RAGZRS o Premium_con ridondanza locale in altri SKU o modificare altri SKU in questi.Note that you can't change Standard_ZRS, Standard_GZRS, Standard_RAGZRS, or Premium_LRS to other SKUs, or change other SKUs to these.

  • Il livello di accesso per gli account di archiviazione BLOB.The access tier for Blob storage accounts. Il valore per il livello di accesso è impostato su Frequente o Sporadico e consente di ridurre al minimo i costi selezionando il livello di accesso più adatto al modo in cui viene usato l'account di archiviazione.The value for access tier is set to hot or cool, and allows you to minimize your cost by selecting the access tier that aligns with how you use the storage account. Per altre informazioni, vedere Livelli di archiviazione ad accesso frequente, ad accesso sporadico e archivio.For more information, see Hot, cool, and archive storage tiers.

  • Consentire solo traffico HTTPS.Only allow HTTPS traffic.

Gestire le chiavi di accessoManage the access keys

Un account di archiviazione di Azure viene fornito con due chiavi.An Azure Storage account comes with two account keys. Per recuperare le chiavi, usare Get-AzStorageAccountKey.To retrieve the keys, use Get-AzStorageAccountKey. In questo esempio viene recuperata la prima chiave.This example retrieves the first key. Per recuperare l'altra, usare Value[1] anziché Value[0].To retrieve the other one, use Value[1] instead of Value[0].

$storageAccountKey = `
    (Get-AzStorageAccountKey `
    -ResourceGroupName $resourceGroup `
    -Name $storageAccountName).Value[0]

Per rigenerare la chiave, usare New-AzStorageAccountKey.To regenerate the key, use New-AzStorageAccountKey.

New-AzStorageAccountKey -ResourceGroupName $resourceGroup `
  -Name $storageAccountName `
  -KeyName key1

Per rigenerare l'altra chiave, usare key2 come nome di chiave anziché key1.To regenerate the other key, use key2 as the key name instead of key1.

Rigenerare una delle chiavi e recuperarla nuovamente per visualizzare il nuovo valore.Regenerate one of your keys and then retrieve it again to see the new value.

Nota

È consigliabile eseguire un'attenta pianificazione prima di rigenerare la chiave per un account di archiviazione di produzione.You should perform careful planning before regenerating the key for a production storage account. La rigenerazione di una o di entrambe le chiavi rende non valido l'accesso per qualsiasi applicazione che usa la chiave rigenerata.Regenerating one or both keys will invalidate the access for any application using the key that was regenerated. Per altre informazioni, vedere Chiavi di accesso.For more information, see Access keys.

Eliminare un account di archiviazioneDelete a storage account

Per eliminare un account di archiviazione, usare Remove-AzStorageAccount.To delete a storage account, use Remove-AzStorageAccount.

Remove-AzStorageAccount -ResourceGroup $resourceGroup -AccountName $storageAccountName

Importante

Quando si elimina un account di archiviazione, vengono eliminati anche tutti gli asset archiviati nell'account.When you delete a storage account, all of the assets stored in the account are deleted as well. Se si elimina un account involontariamente, contattare immediatamente il supporto e aprire un ticket per il ripristino dell'account di archiviazione.If you delete an account accidentally, call Support immediately and open a ticket to restore the storage account. Il ripristino dei dati non è garantito, ma talvolta funziona.Recovery of your data is not guaranteed, but it does sometimes work. Non creare un nuovo account di archiviazione con lo stesso nome di quello precedente finché il ticket di supporto non è stato risolto.Do not create a new storage account with the same name as the old one until the support ticket has been resolved.

Proteggere l'account di archiviazione tramite reti virtuali e firewallProtect your storage account using VNets and firewalls

Per impostazione predefinita, tutti gli account di archiviazione sono accessibili da qualsiasi rete con accesso a Internet.By default, all storage accounts are accessible by any network that has access to the internet. È possibile tuttavia configurare le regole di rete in modo da consentire che solo le applicazioni di determinate reti virtuali possano accedere a un account di archiviazione.However, you can configure network rules to only allow applications from specific virtual networks to access a storage account. Per altre informazioni, vedere Configurare i firewall e le reti virtuali di Archiviazione di Azure.For more information, see Configure Azure Storage Firewalls and Virtual Networks.

Questo articolo illustra come gestire queste impostazioni usando i cmdlet di PowerShell seguenti:The article shows how to manage these settings using the following PowerShell cmdlets:

Usare Analisi archiviazioneUse storage analytics

Analisi archiviazione di Azure è composto da Storage Analytics Metrics (Metriche di Analisi archiviazione) e Storage Analytics Logging (Registrazione di Analisi archiviazione).Azure Storage Analytics consists of Storage Analytics Metrics and Storage Analytics Logging.

Storage Analytics Metrics (Metriche di Analisi archiviazione) consente di raccogliere le metriche relative agli account di archiviazione di Azure che è possibile usare per monitorare l'integrità di un account di archiviazione.Storage Analytics Metrics is used to collect metrics for your Azure storage accounts that you can use to monitor the health of a storage account. Le metriche possono essere abilitate per BLOB, file, tabelle e code.Metrics can be enabled for blobs, files, tables, and queues.

Storage Analytics Logging (Registrazione di Analisi archiviazione) viene eseguita sul lato server e consente di registrare i dettagli di tutte richieste inviate all'account di archiviazione, indipendentemente dall'esito positivo o negativo.Storage Analytics Logging happens server-side and enables you to record details for both successful and failed requests to your storage account. Questi log consentono di visualizzare i dettagli delle operazioni di lettura, scrittura ed eliminazione a fronte delle proprie tabelle, code e BLOB, nonché i motivi per cui le richieste non sono riuscite.These logs enable you to see details of read, write, and delete operations against your tables, queues, and blobs as well as the reasons for failed requests. La registrazione non è disponibile per File di Azure.Logging is not available for Azure Files.

È possibile configurare il monitoraggio tramite il portale di Azure o PowerShell oppure nel codice tramite la libreria del client di archiviazione.You can configure monitoring using the Azure portal, PowerShell, or programmatically using the storage client library.

Nota

Con PowerShell è possibile anche abilitare l'analisi al minuto,You can enable minute analytics using PowerShell. mentre questa funzionalità non è consentita dal portale di Azure.This capability is not available in the portal.

Gestire i dati nell'account di archiviazioneManage the data in the storage account

Fino a qui si è appreso come gestire l'account di archiviazione con PowerShell. Gli articoli seguenti illustrano come accedere agli oggetti dati nell'account di archiviazione.Now that you understand how to manage your storage account with PowerShell, you can use the following articles to learn how to access the data objects in the storage account.

L'API di tabella di Azure Cosmos DB offre funzionalità Premium per l'archiviazione di tabelle, ad esempio distribuzione globale chiavi in mano, operazioni di lettura e scrittura a bassa latenza, indicizzazione secondaria automatica e velocità effettiva dedicata.Azure Cosmos DB Table API provides premium features for table storage such as turnkey global distribution, low latency reads and writes, automatic secondary indexing, and dedicated throughput.

Distribuzioni cloud indipendenti di AzureIndependent cloud deployments of Azure

La maggior parte delle persone usa il cloud pubblico di Azure per la distribuzione globale di Azure.Most people use Azure Public Cloud for their global Azure deployment. Per motivi di sovranità e altro, sono disponibili anche alcune distribuzioni indipendenti di Microsoft Azure,There are also some independent deployments of Microsoft Azure for reasons of sovereignty and so on. denominate "ambienti".These independent deployments are referred to as "environments." Ecco gli ambienti disponibili:These are the available environments:

Per informazioni su come accedere a questi cloud e al relativo spazio di archiviazione con PowerShell, vedere Managing Storage in the Azure independent clouds using PowerShell (Gestione dell'archiviazione nei cloud indipendenti di Azure con PowerShell).For information about how to access these clouds and their storage with PowerShell, please see Managing Storage in the Azure independent clouds using PowerShell.

Pulire le risorseClean up resources

Se per questa esercitazione sono stati creati un nuovo gruppo di risorse e un account di archiviazione, è possibile rimuovere tutti gli asset creati rimuovendo il gruppo di risorse.If you created a new resource group and a storage account for this exercise, yous can remove all of the assets you created by removing the resource group. Così facendo vengono eliminate anche tutte le risorse in esso contenute.This also deletes all resources contained within the group. In questo caso, rimuove l'account di archiviazione creato e il gruppo di risorse stesso.In this case, it removes the storage account created and the resource group itself.

Remove-AzResourceGroup -Name $resourceGroup

Passaggi successiviNext steps

Questo articolo illustra le operazioni comunemente eseguite quando si usano i cmdlet del piano di gestione per gestire gli account di archiviazione.This how-to article covers common operations using the management plane cmdlets to manage storage accounts. Si è appreso come:You learned how to:

  • Elencare gli account di archiviazioneList storage accounts
  • Ottenere un riferimento a un account di archiviazione esistenteGet a reference to an existing storage account
  • Creare un account di archiviazioneCreate a storage account
  • Impostare le proprietà dell'account di archiviazioneSet storage account properties
  • Recuperare e rigenerare le chiavi dell'accountRetrieve and regenerate the access keys
  • Proteggere l'accesso all'account di archiviazioneProtect access to your storage account
  • Abilitare Analisi archiviazioneEnable Storage Analytics

Questo articolo offre anche riferimenti a vari altri articoli, ad esempio su come gestire gli oggetti dati, come abilitare Analisi archiviazione e come accedere a cloud indipendenti di Azure, ad esempio il cloud per la Cina, il cloud per la Germania e il cloud per enti pubblici.This article also provided references to several other articles, such as how to manage the data objects, how to enable the Storage Analytics, and how to access the Azure independent clouds such as China Cloud, German Cloud, and Government Cloud. Di seguito sono riportati alcuni altri articoli correlati e alcune risorse di riferimento:Here are some more related articles and resources for reference: