你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

如何将经典存储帐户迁移到 Azure 资源管理器

Microsoft 将于 2024 年 8 月 31 日停用经典存储帐户。 若要保留任何经典存储帐户中的数据，必须在该日期前将这些帐户迁移到 Azure 资源管理器部署模型。 迁移帐户后，Azure 资源管理器部署模型的所有优势都将适用于该帐户。 有关部署模型的详细信息，请参阅资源管理器和经典部署。

本文介绍如何将经典存储帐户迁移到 Azure 资源管理器部署模型。 有关详细信息，请参阅在 2024 年 8 月 31 日前将经典存储帐户迁移到 Azure 资源管理器。

迁移过程概述

在开始迁移之前，请阅读了解存储帐户从经典部署模型向 Azure 资源管理器的迁移，了解迁移过程的概述。

若要迁移经典存储帐户，你应该：

1. 识别订阅中的经典存储帐户。
2. 在经典帐户中查找和删除任何磁盘项目。
3. 迁移经典存储帐户。
4. 更新应用程序以使用 Azure 资源管理器 API。

识别订阅中的经典存储帐户

Portal

使用 Azure 门户列出订阅中的经典存储帐户：

1. 导航到 Azure 门户中的存储帐户列表。

2. 选择“添加筛选器”。 在“筛选器”对话框中，将“筛选器”字段设置为“类型”，将“运算符”字段设置为“等于”。 然后将“值”字段设置为 microsoft.classicstorage/storageaccounts。

   

PowerShell

若要使用 PowerShell 列出订阅中的经典存储帐户，请运行以下命令：

Get-AzResource -ResourceType Microsoft.ClassicStorage/storageAccounts

在经典帐户中查找和删除磁盘项目

经典存储帐户可能包含经典（非托管）磁盘、虚拟机映像和操作系统 (OS) 映像。 若要迁移帐户，需要先删除这些项目。

重要

如果不先删除经典磁盘项目，迁移可能会失败。

若要了解如何将非托管磁盘迁移到托管磁盘，请参阅将非托管磁盘迁移到托管磁盘。

Portal

若要从 Azure 门户中删除磁盘项目，请执行以下步骤：

1. 导航到 Azure 门户。

2. 在顶部的“搜索”栏中，搜索“磁盘(经典)”、“OS 映像(经典)”或“VM 映像(经典)”以显示经典磁盘项目。

3. 找到要删除的经典磁盘项目，然后选择它以查看其属性。

4. 选择“删除”按钮以删除磁盘项目。

   

有关删除磁盘工件时可能发生的错误以及如何解决这些错误的详细信息，请参阅排查在删除 Azure 经典存储帐户、容器或 VHD 时出现的错误。

PowerShell

若要了解如何通过 PowerShell 在经典存储帐户中查找和删除磁盘项目，请参阅通过 PowerShell 迁移到资源管理器。

迁移经典存储帐户

迁移经典存储帐户的过程包括四个步骤：

1. 验证。 在“验证”阶段，Azure 会检查存储帐户，以确保可以进行迁移。

2. 准备。 在“准备”阶段，Azure 会创建新的常规用途 v1 存储帐户，并在出现任何问题时发出警报。 新帐户是在与经典帐户位于同一区域的新资源组中创建的。

   此时，你的经典存储帐户仍然存在。 如果报告了任何问题，则可以更正这些问题或中止该过程。

3. 手动检查。 最好手动检查新的存储帐户，以确保输出符合你的预期。

4. 提交或中止。 如果对已成功的迁移感到满意，则可以提交迁移。 提交迁移会永久删除经典存储帐户。

   如果迁移存在任何问题，则此时可以中止迁移。 如果选择中止，则会删除新的资源组和新存储帐户。 你的经典帐户仍然可用。 可以解决任何问题并再次尝试迁移。

有关迁移过程的详细信息，请参阅了解存储帐户从经典部署模型向 Azure 资源管理器的迁移

可以使用 Azure 门户或 PowerShell 将经典存储帐户迁移到 Azure 资源管理器部署模型。

Portal

若要使用 Azure 门户将经典存储帐户迁移到 Azure 资源管理器部署模型，请执行以下操作：

1. 导航到 Azure 门户中的经典存储帐户。

2. 在“设置”部分中选择“迁移到 ARM”。

3. 选择“验证”以确定迁移的可行性。

   

4. 成功验证后，选择“准备”按钮来模拟迁移。

5. 如果“准备”步骤成功完成，则会看到指向新资源组的链接。 选择该链接以导航到新资源组。 迁移的存储帐户显示在新资源组“概述”页的“资源”选项卡下。

   此时，可以将经典存储帐户中的配置和数据与新迁移的存储帐户进行比较。 你将在门户中的存储帐户列表中看到这两者。 经典帐户和迁移的帐户具有相同的名称。

   

6. 如果对迁移结果不满意，请选择“中止”以删除新的存储帐户和资源组。 然后，可以解决问题并重试。

7. 准备好提交后，键入“是”进行确认，然后选择“提交”以完成迁移。

重要

验证完成后，可能经过几分钟的延迟才会启用“准备”按钮。

PowerShell

要使用 PowerShell 将经典存储帐户迁移到 Azure 资源管理器部署模型，必须使用 Azure PowerShell 服务管理模块。 若要了解如何安装此模块，请参阅安装和配置 Azure PowerShell 服务管理模块。 为了方便起见，此处提供了关键步骤。

注意

Azure 服务管理模块中的 cmdlet 用于管理使用服务管理 API 的旧 Azure 资源，包括经典存储帐户。 此模块包括将经典存储帐户迁移到 Azure 资源管理器所需的命令。

若要管理 Azure 资源管理器资源，建议使用 Az PowerShell 模块。 Az 模块替换了已弃用的 AzureRM 模块。 有关从 AzureRM 模块转移到 Az 模块的详细信息，请参阅将 Azure PowerShell 脚本从 AzureRM 迁移到 Az。

首先，如果尚未安装 PowerShellGet，请进行安装。 有关如何安装 PowerShellGet 的详细信息，请参阅安装 PowerShellGet。 安装 PowerShellGet 后，关闭并重新打开 PowerShell 控制台。

接下来，安装 Azure 服务管理模块。 如果你还安装了 AzureRM 模块，则需要加入 -AllowClobber 参数，如步骤 2：安装 Azure PowerShell 中所述。 安装完成后，导入 Azure 服务管理模块。

Install-Module -Name Azure -AllowClobber
Import-Module -Name Azure

运行 Add-AzureAccount 登录到帐户。 然后调用 Select-AzureSubscription 设置当前订阅。 请记得将括号中的占位符值替换为你的订阅名：

Add-AzureAccount
Select-AzureSubscription -SubscriptionName <subscription-name>

若要验证帐户是否已准备好进行迁移，请调用 Move-AzureStorageAccount 命令。 请记得将括号中的占位符值替换为你的经典存储帐户的名称：

$accountName = "<storage-account>"
Move-AzureStorageAccount -Validate -StorageAccountName $accountName

接下来，准备要迁移的帐户：

Move-AzureStorageAccount -Prepare -StorageAccountName $accountName

使用 Azure PowerShell 或 Azure 门户检查准备就绪的存储帐户的配置。 如果尚未准备好进行迁移，请使用以下命令将帐户还原到以前的状态：

Move-AzureStorageAccount -Abort -StorageAccountName $accountName

最后，当你对准备好的配置感到满意时，请继续进行迁移并使用以下命令提交资源：

Move-AzureStorageAccount -Commit -StorageAccountName $accountName

更新应用程序以使用 Azure 资源管理器 API

将经典存储帐户迁移到 Azure 资源管理器后，必须更新应用程序和脚本才能使用 Azure 资源管理器 API。 Azure 存储资源提供程序是 Azure 资源管理器在 Azure 存储中的实现。

为方便调用 Azure 存储资源提供程序 API，Azure 存储提供了 SDK：

• 适用于 .NET 的管理客户端库
• 适用于 Java 的管理客户端库
• 适用于 JavaScript 的管理客户端库
• 适用于 Python 的管理客户端库

还可以使用最新版本的 Azure PowerShell 和 Azure CLI 来管理迁移的存储帐户：

• Azure PowerShell
• Azure CLI

若要详细了解 Azure 资源管理器中的资源提供程序，请参阅资源提供程序和资源类型。

另请参阅

• 在 2024 年 8 月 31 日前将经典存储帐户迁移到 Azure 资源管理器
• 了解如何将存储帐户从经典部署模型迁移到 Azure 资源管理器