Verwenden von Azure PowerShell mit Azure StorageUsing Azure PowerShell with Azure Storage

Azure PowerShell dient zum Erstellen und Verwalten von Azure-Ressourcen über die PowerShell-Befehlszeile oder mit Skripts.Azure PowerShell is used to create and manage Azure resources from the PowerShell command line or in scripts. Für Azure Storage werden diese Cmdlets in zwei Kategorien unterteilt: die Steuerungsebene und die Datenebene.For Azure Storage, these cmdlets fall into two categories -- the control plane and the data plane. Mithilfe der Cmdlets der Steuerungsebene wird das Speicherkonto verwaltet, um z. B. Konten zu erstellen, Eigenschaften festzulegen, Speicherkonten zu löschen, Zugriffsschlüssel zu drehen usw.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. Mithilfe der Cmdlets der Datenebene werden die Daten verwaltet, die im Speicherkonto gespeichert werden.The data plane cmdlets are used to manage the data stored in the storage account. Dazu zählen z. B. das Hochladen von Blobs, das Erstellen von Dateifreigaben und das Hinzufügen von Nachrichten zu einer Warteschlange.For example, uploading blobs, creating file shares, and adding messages to a queue.

Diese Anleitung behandelt allgemeine Vorgänge, über die Speicherkonten mithilfe der Cmdlets der Verwaltungsebene verwaltet werden.This how-to article covers common operations using the management plane cmdlets to manage storage accounts. Folgendes wird vermittelt:You learn how to:

  • Auflisten von SpeicherkontenList storage accounts
  • Abrufen eines Verweises auf ein vorhandenes SpeicherkontoGet a reference to an existing storage account
  • Speicherkonto erstellenCreate a storage account
  • Festlegen der Eigenschaften von SpeicherkontenSet storage account properties
  • Abrufen und erneutes Generieren der KontenschlüsselRetrieve and regenerate the access keys
  • Schützen des Zugriffs auf Ihr SpeicherkontoProtect access to your storage account
  • Aktivieren von Storage AnalyticsEnable Storage Analytics

Dieser Artikel enthält Links zu weiteren PowerShell-Artikeln für Storage. In diesen wird beispielsweise das Aktivieren und Zugreifen auf Storage Analytics, das Verwenden von Cmdlets der Datenebene und das Zugreifen auf unabhängige Azure-Clouds in China und Deutschland sowie auf die Government Cloud beschrieben.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.

Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.If you don't have an Azure subscription, create a free account before you begin.

Hinweis

Dieser Artikel wurde aktualisiert und beinhaltet jetzt das neue Az-Modul von Azure PowerShell.This article has been updated to use the new Azure PowerShell Az module. Sie können das AzureRM-Modul weiterhin verwenden, das bis mindestens Dezember 2020 weiterhin Fehlerbehebungen erhält.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Weitere Informationen zum neuen Az-Modul und zur Kompatibilität mit AzureRM finden Sie unter Introducing the new Azure PowerShell Az module (Einführung in das neue Az-Modul von Azure PowerShell).To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Anweisungen zur Installation des Az-Moduls finden Sie unter Install Azure PowerShell (Installieren von Azure PowerShell).For Az module installation instructions, see Install Azure PowerShell.

Für diese Übung ist das Azure PowerShell-Modul Az (Version 0.7 oder höher) erforderlich.This exercise requires the Azure PowerShell module Az version 0.7 or later. Führen Sie Get-Module -ListAvailable Az aus, um die Version zu finden.Run Get-Module -ListAvailable Az to find the version. Wenn Sie eine Installation oder ein Upgrade ausführen müssen, finden Sie unter Install and configure Azure PowerShell (Installieren des Azure PowerShell-Moduls) Informationen dazu.If you need to install or upgrade, see Install Azure PowerShell module.

Für diese Übung können Sie die Befehle in ein normales PowerShell-Fenster eingeben oder die Windows PowerShell ISE (Integrated Scripting Environment) verwenden und die Befehle in einen Editor eingeben. Dann können Sie einen oder mehrere Befehle gleichzeitig testen, während Sie die Beispiele durchlaufen.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. Sie können die auszuführenden Zeilen hervorheben und auf „Auswahl ausführen“ klicken, um diese Befehle einfach auszuführen.You can highlight the rows you want to execute and click Run Selected to just run those commands.

Weitere Informationen zu Speicherkonten finden Sie unter Einführung in Storage und Informationen zu Azure-Speicherkonten.For more information about storage accounts, see Introduction to Storage and About Azure storage accounts.

Anmelden bei AzureSign in to Azure

Melden Sie sich mit dem Befehl Connect-AzAccount bei Ihrem Azure-Abonnement an, und befolgen Sie die Anweisungen auf dem Bildschirm.Sign in to your Azure subscription with the Connect-AzAccount command and follow the on-screen directions.

Connect-AzAccount

Auflisten der Speicherkonten im AbonnementList the storage accounts in the subscription

Führen Sie das Cmdlet Get-AzStorageAccount aus, um die Liste der Speicherkonten im aktuellen Abonnement abzurufen.Run the Get-AzStorageAccount cmdlet to retrieve the list of storage accounts in the current subscription.

Get-AzStorageAccount | Select StorageAccountName, Location

Abrufen eines Verweises auf ein SpeicherkontoGet a reference to a storage account

Als Nächstes benötigen Sie einen Verweis auf ein Speicherkonto.Next, you need a reference to a storage account. Sie können ein neues Speicherkonto erstellen oder einen Verweis auf ein vorhandenes Speicherkonto abrufen.You can either create a new storage account or get a reference to an existing storage account. Im folgenden Abschnitt werden beide Methoden veranschaulicht.The following section shows both methods.

Verwenden eines vorhandenen SpeicherkontosUse an existing storage account

Damit Sie ein vorhandenes Speicherkonto abrufen können, benötigen Sie den Namen der Ressourcengruppe und den Namen des Speicherkontos.To retrieve an existing storage account, you need the name of the resource group and the name of the storage account. Legen Sie die Variablen für diese beiden Felder fest, und verwenden Sie dann das 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

Jetzt verfügen Sie über „$storageAccount“, das auf ein vorhandenes Speicherkonto verweist.Now you have $storageAccount, which points to an existing storage account.

Speicherkonto erstellenCreate a storage account

Das folgende Skript veranschaulicht die Erstellung eines allgemeinen Speicherkontos mithilfe von New-AzStorageAccount.The following script shows how to create a general-purpose storage account using New-AzStorageAccount. Nachdem Sie das Konto erstellt haben, rufen Sie dessen Kontext ab, der in nachfolgenden Befehlen verwendet werden kann, anstatt die Authentifizierung bei jedem Aufruf anzugeben.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

Das Skript verwendet die folgenden PowerShell-Cmdlets:The script uses the following PowerShell cmdlets:

  • Get-AzLocation: Ruft eine Liste der gültigen Speicherorte ab.Get-AzLocation -- retrieves a list of the valid locations. Im Beispiel wird eastus für den Speicherort verwendet.The example uses eastus for location.

  • New-AzResourceGroup: Erstellt eine neue Ressourcengruppe.New-AzResourceGroup -- creates a new resource group. Eine Ressourcengruppe ist ein logischer Container, in dem Ihre Azure-Ressourcen bereitgestellt und verwaltet werden.A resource group is a logical container into which your Azure resources are deployed and managed. In diesem Beispiel erhält sie die Bezeichnung teststoragerg.Ours is called teststoragerg.

  • New-AzStorageAccount: Erstellt das Speicherkonto.New-AzStorageAccount -- creates the storage account. Im Beispiel wird testpshstorage verwendet.The example uses testpshstorage.

Der SKU-Name gibt den Typ der Replikation für das Speicherkonto an, z. B. LRS (lokal redundanter Speicher).The SKU name indicates the type of replication for the storage account, such as LRS (Locally Redundant Storage). Weitere Informationen zur Replikation finden Sie unter Azure Storage-Replikation.For more information about replication, see Azure Storage Replication.

Wichtig

Der Name für das Speicherkonto muss in Azure eindeutig sein und Kleinschreibung verwenden.The name of your storage account must be unique within Azure and must be lowercase. Informationen zu Namenskonventionen und Einschränkungen finden Sie unter Benennen von Containern, Blobs und Metadaten und Verweisen auf diese.For naming conventions and restrictions, see Naming and Referencing Containers, Blobs, and Metadata.

Sie verfügen jetzt über ein neues Speicherkonto und über einen Verweis auf dieses Konto.Now you have a new storage account and a reference to it.

Verwalten des SpeicherkontosManage the storage account

Nachdem Sie über einen Verweis auf ein neues oder ein vorhandenes Speicherkonto verfügen, werden im folgenden Abschnitt einige der Befehle veranschaulicht, mit denen Sie das Speicherkonto verwalten können.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.

Eigenschaften von SpeicherkontenStorage account properties

Verwenden Sie Set-AzStorageAccount, um die Einstellungen für ein Speicherkonto zu ändern.To change the settings for a storage account, use Set-AzStorageAccount. Während Sie den Speicherort eines Speicherkontos oder die Ressourcengruppe ändern, in der sich das Speicherkonto befindet, können Sie auch viele andere Eigenschaften ändern.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. Nachfolgend sind einige der Eigenschaften aufgeführt, die Sie mithilfe von PowerShell ändern können.The following lists some of the properties you can change using PowerShell.

  • Die benutzerdefinierte Domäne, die dem Speicherkonto zugeordnet ist.The custom domain assigned to the storage account.

  • Die Tags, die dem Speicherkonto zugeordnet sind.The tags assigned to the storage account. Tags werden häufig zu Abrechnungszwecken zum Kategorisieren von Ressourcen verwendet.Tags are often used to categorize resources for billing purposes.

  • Die SKU ist eine Replikationseinstellung für das Speicherkonto, z. B. LRS für „lokal redundanter Speicher“.The SKU is the replication setting for the storage account, such as LRS for Locally Redundant Storage. Sie können z. B. von „Standard_LRS“ zu „Standard_GRS“ oder „Standard_RAGRS“ wechseln.For example, you might change from Standard_LRS to Standard_GRS or Standard_RAGRS. Beachten Sie, dass Sie „Standard_ZRS“, „Standard_GZRS“, „Standard_RAGZRS“ oder „Premium_LRS“ nicht in eine andere SKU ändern können (oder andere SKUs in diese SKUs).Note that you can't change Standard_ZRS, Standard_GZRS, Standard_RAGZRS, or Premium_LRS to other SKUs, or change other SKUs to these.

  • Die Zugriffsebene für Blob-Speicherkonten.The access tier for Blob storage accounts. Der Wert für die Zugriffsebene wird auf heiß oder kalt festgelegt. Dadurch können Sie Ihre Kosten minimieren, indem Sie die Zugriffsebene auf die Art und Weise ausrichten, wie Sie das Speicherkonto verwenden.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. Weitere Informationen finden Sie unter Speicherebenen „Heiß“ (Hot), „Kalt“ (Cool) und „Archiv“.For more information, see Hot, cool, and archive storage tiers.

  • Gestatten Sie nur HTTPS-Datenverkehr.Only allow HTTPS traffic.

Verwalten der ZugriffsschlüsselManage the access keys

Ein Azure-Speicherkonto verfügt über zwei Speicherschlüssel.An Azure Storage account comes with two account keys. Verwenden Sie Get-AzStorageAccountKey, um die Schlüssel abzurufen.To retrieve the keys, use Get-AzStorageAccountKey. In diesem Beispiel wird der erste Schlüssel abgerufen.This example retrieves the first key. Verwenden Sie Value[1] anstelle von Value[0], um den anderen Schlüssel abzurufen.To retrieve the other one, use Value[1] instead of Value[0].

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

Verwenden Sie New-AzStorageAccountKey, um den Schlüssel erneut zu generieren.To regenerate the key, use New-AzStorageAccountKey.

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

Verwenden Sie key2 anstelle von key1 als Schlüsselnamen, um den anderen Schlüssel erneut zu generieren.To regenerate the other key, use key2 as the key name instead of key1.

Generieren Sie einen Ihrer Schlüssel neu, und rufen Sie ihn dann erneut ab, um den neuen Wert anzuzeigen.Regenerate one of your keys and then retrieve it again to see the new value.

Hinweis

Sie sollten vor der erneuten Generierung des Schlüssels für ein Produktionsspeicherkonto sorgfältig planen.You should perform careful planning before regenerating the key for a production storage account. Wenn Sie einen oder beide Schlüssel erneut generieren, wird der Zugriff für jede Anwendung außer Kraft gesetzt, die den neu generierten Schlüssel verwendet.Regenerating one or both keys will invalidate the access for any application using the key that was regenerated. Weitere Informationen finden Sie unter Zugriffsschlüssel.For more information, see Access keys.

Löschen von SpeicherkontenDelete a storage account

Verwenden Sie zum Löschen eines Speicherkontos das Cmdlet Remove-AzStorageAccount.To delete a storage account, use Remove-AzStorageAccount.

Remove-AzStorageAccount -ResourceGroup $resourceGroup -AccountName $storageAccountName

Wichtig

Wenn Sie ein Speicherkonto löschen, werden alle im Konto gespeicherten Assets ebenfalls gelöscht.When you delete a storage account, all of the assets stored in the account are deleted as well. Wenn Sie ein Konto versehentlich löschen, rufen Sie sofort den Support an und öffnen ein Ticket, um das Speicherkonto wiederherzustellen.If you delete an account accidentally, call Support immediately and open a ticket to restore the storage account. Die Wiederherstellung Ihrer Daten wird nicht garantiert, kann aber in einigen Fällen funktionieren.Recovery of your data is not guaranteed, but it does sometimes work. Erstellen Sie kein neues Speicherkonto mit demselben Namen wie für das alte Konto, bis das Supportticket aufgelöst wurde.Do not create a new storage account with the same name as the old one until the support ticket has been resolved.

Schützen Ihres Speicherkontos mithilfe von VNETs und FirewallsProtect your storage account using VNets and firewalls

Standardmäßig können alle Netzwerke mit Zugriff auf das Internet auf sämtliche Speicherkonten zugreifen.By default, all storage accounts are accessible by any network that has access to the internet. Sie können jedoch Netzwerkregeln konfigurieren, um nur Anwendungen aus bestimmten virtuellen Netzwerken den Zugriff auf ein Speicherkonto zu ermöglichen.However, you can configure network rules to only allow applications from specific virtual networks to access a storage account. Weitere Informationen finden Sie unter Konfigurieren von Firewalls und virtuellen Netzwerken in Azure Storage.For more information, see Configure Azure Storage Firewalls and Virtual Networks.

In diesem Artikel wird das Verwalten dieser Einstellungen mithilfe der folgenden PowerShell-Cmdlets veranschaulicht:The article shows how to manage these settings using the following PowerShell cmdlets:

Verwenden von Storage AnalyticsUse storage analytics

Azure Storage Analytics besteht aus Storage Analytics-Metriken und Storage Analytics-Protokollierung.Azure Storage Analytics consists of Storage Analytics Metrics and Storage Analytics Logging.

Storage Analytics-Metriken werden verwendet, um Metriken für Ihre Azure-Speicherkonten zu erfassen, mit denen Sie die Integrität eines Speicherkontos überwachen können.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. Metriken können für Blobs, Dateien, Tabellen und Warteschlangen aktiviert werden.Metrics can be enabled for blobs, files, tables, and queues.

Die Storage Analytics-Protokollierung erfolgt serverseitig, und sie ermöglicht es Ihnen, Details für erfolgreiche und fehlerhafte Anforderungen in Ihrem Speicherkonto aufzuzeichnen.Storage Analytics Logging happens server-side and enables you to record details for both successful and failed requests to your storage account. Anhand dieser Protokolle können Sie Details zu Lese-, Schreib- und Löschvorgängen für Ihre Tabellen, Warteschlangen und Blobs sowie die Gründe für fehlerhafte Anforderungen anzeigen.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. Die Protokollierung ist für Azure Files nicht verfügbar.Logging is not available for Azure Files.

Sie können die Überwachung mithilfe des Azure-Portals, über PowerShell oder programmgesteuert mithilfe der Speicherclientbibliothek aktivieren.You can configure monitoring using the Azure portal, PowerShell, or programmatically using the storage client library.

Hinweis

Sie können die Minutenanalyse mit PowerShell aktivieren.You can enable minute analytics using PowerShell. Diese Funktion ist im Portal nicht verfügbar.This capability is not available in the portal.

Verwalten der Daten im SpeicherkontoManage the data in the storage account

Nachdem Sie nun erfahren haben, wie Sie Ihr Speicherkonto mit PowerShell verwalten, können Sie in den folgenden Artikeln nachlesen, wie Sie auf Datenobjekte im Speicherkonto zugreifen.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.

Die Azure Cosmos DB-Tabellen-API bietet Premiumfeatures für den Tabellenspeicher wie sofort einsatzbereite globale Verteilung, Lese- und Schreibvorgänge mit geringer Wartezeit, automatische sekundäre Indizierung und dedizierten Durchsatz.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.

Unabhängige Cloudbereitstellungen von AzureIndependent cloud deployments of Azure

Die meisten Benutzer verwenden Azure Public Cloud für die globale Bereitstellung von Azure.Most people use Azure Public Cloud for their global Azure deployment. Es gibt allerdings auch einige unabhängige Bereitstellungen von Microsoft Azure, die beispielsweise durch bestimmte Anforderungen an Datenhoheit motiviert sind.There are also some independent deployments of Microsoft Azure for reasons of sovereignty and so on. Diese unabhängige Bereitstellungen werden als „Umgebungen“ bezeichnet.These independent deployments are referred to as "environments." Folgende Umgebungen stehen zur Verfügung:These are the available environments:

Informationen zum Zugriff auf diese Clouds und deren Speicher mit PowerShell finden Sie unter Managing Storage in the Azure independent clouds using PowerShell (Verwalten von Speicher in unabhängigen Azure-Clouds mit 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.

Bereinigen von RessourcenClean up resources

Wenn Sie eine neue Ressourcengruppe und ein Speicherkonto für diese Übung erstellt haben, können Sie alle erstellten Ressourcen entfernen, indem Sie die Ressourcengruppe löschen.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. Dabei werden auch alle in der Gruppe enthaltenen Ressourcen gelöscht.This also deletes all resources contained within the group. In diesem Fall werden das erstellte Speicherkonto und die Ressourcengruppe selbst entfernt.In this case, it removes the storage account created and the resource group itself.

Remove-AzResourceGroup -Name $resourceGroup

Nächste SchritteNext steps

Diese Anleitung behandelt allgemeine Vorgänge, über die Speicherkonten mithilfe der Cmdlets der Verwaltungsebene verwaltet werden.This how-to article covers common operations using the management plane cmdlets to manage storage accounts. Es wurde Folgendes vermittelt:You learned how to:

  • Auflisten von SpeicherkontenList storage accounts
  • Abrufen eines Verweises auf ein vorhandenes SpeicherkontoGet a reference to an existing storage account
  • Speicherkonto erstellenCreate a storage account
  • Festlegen der Eigenschaften von SpeicherkontenSet storage account properties
  • Abrufen und erneutes Generieren der KontenschlüsselRetrieve and regenerate the access keys
  • Schützen des Zugriffs auf Ihr SpeicherkontoProtect access to your storage account
  • Aktivieren von Storage AnalyticsEnable Storage Analytics

In diesem Artikel wurden außerdem Links zu weiteren Artikeln bereitgestellt. In diesen wird beispielsweise das Verwalten von Datenobjekten, das Aktivieren von Storage Analytics und das Zugreifen auf unabhängige Azure-Clouds wie die chinesische und deutsche Azure-Cloud sowie auf die Government Cloud beschrieben.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. Die folgenden Artikel und Ressourcen dienen als Referenz:Here are some more related articles and resources for reference: