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

使用 PowerShell 备份 Azure 文件共享

本文介绍如何通过 Azure 备份恢复服务保管库，使用 Azure PowerShell 来备份 Azure 文件存储的文件共享。

本文介绍如何执行以下操作：

• 设置 PowerShell 并注册恢复服务提供程序。
• 创建恢复服务保管库。
• 配置 Azure 文件共享的备份。
• 运行备份作业。

开始之前

• 详细了解恢复服务保管库。

• 查看 Azure 库中的 Az.RecoveryServices cmdlet 参考。

• 查看恢复服务的 PowerShell 对象层次结构：

  

设置 PowerShell

注意

建议使用 Azure Az PowerShell 模块与 Azure 交互。 若要开始，请参阅安装 Azure PowerShell。 若要了解如何迁移到 Az PowerShell 模块，请参阅 将 Azure PowerShell 从 AzureRM 迁移到 Az。

注意

Azure PowerShell 目前不支持按小时计划备份策略。 请通过 Azure 门户来利用此功能。 了解详细信息

按如下所述设置 PowerShell：

1. 下载最新版的 Azure PowerShell。

   注意

   备份 Azure 文件共享所需的最低 PowerShell 版本为 Az.RecoveryServices 2.6.0。 使用最新版本或允许的最低版本有助于避免现有脚本出现问题。 使用以下 PowerShell 命令安装最低版本：

   Install-module -Name Az.RecoveryServices -RequiredVersion 2.6.0
   

2. 使用以下命令查找适用于 Azure 备份的 PowerShell cmdlet：

   Get-Command *azrecoveryservices*
   

3. 查看 Azure 备份、Azure Site Recovery 和恢复服务保管库的别名和 cmdlet。 下面是可能显示的内容示例。 此 cmdlet 列表并不完整。

   

4. 使用“Connect-AzAccount”登录到 Azure 帐户。

5. 在出现的网页上，系统会提示输入帐户凭据。

   或者，可以使用 -Credential 参数，将帐户凭据作为参数包含在 Connect-AzAccount cmdlet 中 。

   如果你是代表租户的 CSP 合作伙伴，则需将客户指定为一名租户。 使用其租户 ID 或租户主域名。 例如，Connect-AzAccount -Tenant "fabrikam.com"。

6. 由于一个帐户可以有多个订阅，因此请将要使用的订阅与帐户关联在一起：

   Select-AzSubscription -SubscriptionName $SubscriptionName
   

7. 首次使用 Azure 备份时，请使用 Register-AzResourceProvider cmdlet 将 Azure 恢复服务提供程序注册到订阅中：

   Register-AzResourceProvider -ProviderNamespace "Microsoft.RecoveryServices"
   

8. 验证提供程序是否已成功注册：

   Get-AzResourceProvider -ProviderNamespace "Microsoft.RecoveryServices"
   

9. 在命令输出中，确认 RegistrationState 是否更改为 Registered。 如果不是，请再次运行 Register-AzResourceProvider cmdlet。

创建恢复服务保管库

恢复服务保管库是一种资源管理器资源，因此必须将其放在资源组中。 可以使用现有资源组，也可以使用 New-AzResourceGroup cmdlet 创建资源组。 创建资源组时，请指定资源组的名称和位置。

请按照以下步骤创建恢复服务保管库：

1. 如果没有现有的资源组，请使用 New-AzResourceGroup cmdlet 新建一个。 此示例是在美国西部区域创建一个新的资源组：

   New-AzResourceGroup -Name "test-rg" -Location "West US"
   

2. 使用 New-AzRecoveryServicesVault cmdlet 创建保管库。 请为保管库指定与资源组相同的位置。

   New-AzRecoveryServicesVault -Name "testvault" -ResourceGroupName "test-rg" -Location "West US"
   

在订阅中查看保管库

若要查看订阅中的所有保管库，请使用 Get-AzRecoveryServicesVault：

Get-AzRecoveryServicesVault

输出如下所示。 请注意，输出提供了关联的资源组和位置。

Name              : Contoso-vault
ID                : /subscriptions/1234
Type              : Microsoft.RecoveryServices/vaults
Location          : WestUS
ResourceGroupName : Contoso-docs-rg
SubscriptionId    : 1234-567f-8910-abc
Properties        : Microsoft.Azure.Commands.RecoveryServices.ARSVaultProperties

设置保管库上下文

将保管库对象存储在变量中，并设置保管库上下文。

许多 Azure 备份 cmdlet 要求将恢复服务保管库对象用作输入，因此可以方便地在变量中存储保管库对象。

保管库上下文是在保管库中受保护的数据的类型。 使用 Set-AzRecoveryServicesVaultContext 来设置。 设置上下文后，它将应用于所有后续 cmdlet。

以下示例为 testvault 设置保管库上下文：

Get-AzRecoveryServicesVault -Name "testvault" | Set-AzRecoveryServicesVaultContext

提取保管库 ID

我们计划根据 Azure PowerShell 指南弃用保管库上下文的设置。 可以改为存储或提取保管库 ID，并将其传递给相关命令。 因此，如果你尚未设置保管库上下文或想要指定为某个保管库运行的命令，请将保管库 ID 作为 -vaultID 传递给所有相关命令，如下所示：

$vaultID = Get-AzRecoveryServicesVault -ResourceGroupName "Contoso-docs-rg" -Name "testvault" | select -ExpandProperty ID
New-AzRecoveryServicesBackupProtectionPolicy -Name "NewAFSPolicy" -WorkloadType "AzureFiles" -RetentionPolicy $retPol -SchedulePolicy $schPol -VaultID $vaultID

配置备份策略

备份策略指定了备份计划，以及备份恢复点的保留期限。

一个备份策略至少与一个保留策略相关联。 保留策略定义了在将恢复点删除之前将其保留的时限。 可以为备份配置为每日、每周、每月或每年保留。 利用多个备份策略，还可以配置每小时备份的保留期。

重要

以下 cmdlet 用于备份策略：

• 使用 Get-AzRecoveryServicesBackupRetentionPolicyObject 查看默认备份策略保留期。
• 使用 Get-AzRecoveryServicesBackupSchedulePolicyObject 查看默认备份策略计划。
• 使用 New-AzRecoveryServicesBackupProtectionPolicy 创建新备份策略。 提供计划和保留策略对象作为输入。

要创建一个每天配置多次备份的备份策略，请按照以下步骤操作：

1. 使用以下 cmdlet 提取计划策略对象：

   $schPol=Get-AzRecoveryServicesBackupSchedulePolicyObject -WorkloadType AzureFiles -BackupManagementType AzureStorage -ScheduleRunFrequency Hourly
   $schPol
   
   

   输出类似于：

   ScheduleRunFrequency    : Hourly
   ScheduleRunDays         :
   ScheduleRunTimes        :
   ScheduleInterval        : 8
   ScheduleWindowStartTime : 12/22/2021 8:00:00 AM
   ScheduleWindowDuration  : 16
   ScheduleRunTimeZone     : India Standard Time
   
   

2. 根据需要设置计划的不同参数。

   $schpol.ScheduleInterval=4
   $schpol.ScheduleWindowDuration=12
   
   

   前面的配置可以帮助你在上午 8 点 - 晚上 8 点（上午 8 点 + 12 小时）的时间窗口中每天计划 4 次备份。 你也可以使用以下 cmdlet 设置时区：

   $timeZone= $timeZone=Get-TimeZone -ListAvailable |Where-Object{$_.Id-match "Russia Time Zone 11"}
   $schPol.ScheduleRunTimeZone=$timeZone.Id
   

   要创建具有每日计划的策略，请运行以下 cmdlet：

   $UtcTime = Get-Date -Date "2019-03-20 01:30:00Z"
   $UtcTime = $UtcTime.ToUniversalTime()
   $schpol.ScheduleRunTimes[0] = $UtcTime
   

3. 使用以下 cmdlet 提取保留策略对象：

   $retPol=Get-AzRecoveryServicesBackupRetentionPolicyObject -WorkloadType AzureFiles -BackupManagementType AzureStorage -ScheduleRunFrequency Hourly
   

4. 根据要求设置保留值。

   $retPol.DailySchedule.DurationCountInDays=15
   

5. 使用 New-AzRecoveryServicesBackupProtectionPolicy 创建新的备份策略。

   可以将以前设置的计划和保留策略对象作为输入来传递。

   New-AzRecoveryServicesBackupProtectionPolicy -Name "FilesPolicytesting" -WorkloadType AzureFiles -RetentionPolicy $retpol -SchedulePolicy $schpol
   

   输出显示策略配置：

   Name           WorkloadType   BackupManagementType ScheduleFrequency  BackupTime    WindowStartTime     Interval   WindowDuration TimeZone
                                                                        (UTC)                                         (Hours)      
   ----          ------------    -------------------- -----------------  ------------  ---------------       -------- -------------- --------
   FilesPolicy
   testing        AzureFiles      AzureStorage         Hourly                          12/22/2021 8:00:00 AM     4        12         Russia Time Zone 11
   
   

启用备份

定义备份策略后，可以使用该策略为 Azure 文件共享启用保护。

检索备份策略

使用 Get-AzRecoveryServicesBackupProtectionPolicy 提取相关的策略对象。 请使用此 cmdlet 查看与某个工作负载类型关联的策略，或者获取特定策略。

检索针对某个工作负荷类型的策略

以下示例检索工作负载类型为 AzureFiles 的策略：

Get-AzRecoveryServicesBackupProtectionPolicy -WorkloadType "AzureFiles"

输出与下面类似：

Name                 WorkloadType       BackupManagementType BackupTime                DaysOfWeek
----                 ------------       -------------------- ----------                ----------
dailyafs             AzureFiles         AzureStorage         1/10/2018 12:30:00 AM

注意

PowerShell 中“BackupTime”字段的时区是 UTC。 在 Azure 门户中显示备份时间时，该时间会根据本地时区进行调整。

检索特定的策略

以下策略检索名为“dailyafs”的备份策略：

$afsPol =  Get-AzRecoveryServicesBackupProtectionPolicy -Name "dailyafs"

启用保护并应用策略

使用 Enable-AzRecoveryServicesBackupProtection 启用保护。 将策略与保管库关联后，系统会根据策略计划触发备份。

以下示例使用策略“dailyafs”，为存储帐户“testStorageAcct”中的 Azure 文件共享“testAzureFS”启用保护：

Enable-AzRecoveryServicesBackupProtection -StorageAccountName "testStorageAcct" -Name "testAzureFS" -Policy $afsPol

此命令将等待，直到完成配置保护作业，并提供类似于以下示例的输出：

WorkloadName       Operation            Status                 StartTime                                                                                                         EndTime                   JobID
------------             ---------            ------               ---------                                  -------                   -----
testAzureFS       ConfigureBackup      Completed            11/12/2018 2:15:26 PM     11/12/2018 2:16:11 PM     ec7d4f1d-40bd-46a4-9edb-3193c41f6bf6

有关如何获取存储帐户的文件共享列表的详细信息，请参阅此文。

重要说明：备份项标识

本部分概述了对 Azure 文件共享的备份的重要更改，以便为正式发布做准备。

为 Azure 文件共享启用备份时，用户为客户提供了一个文件共享名称作为实体名称，并且创建了一个备份项。 备份项的名称是 Azure 备份服务创建的唯一标识符。 标识符通常是易记名称。 但是，若要处理软删除的情况，可以删除文件共享，并使用同一名称创建另一个文件共享，Azure 文件共享的唯一标识现在为 ID。

若要了解每个项的唯一 ID，请运行带有适用于“backupManagementType”和“WorkloadType”的相关筛选器的“Get-AzRecoveryServicesBackupItem”命令，以获取所有相关项。 然后查看返回的 PowerShell 对象/响应中的名称字段。

建议将项列出，然后从响应的“名称”字段中检索其唯一名称。 通过此值可以筛选参数为“名称”的项。 否则，请使用参数“FriendlyName”检索具有其 ID 的项。

重要

请确保 PowerShell 升级到 Azure 文件共享备份的最低版本 (Az.RecoveryServices 2.6.0)。 在此版本中，FriendlyName 筛选器可用于 Get-AzRecoveryServicesBackupItem 命令。

将 Azure 文件共享的名称传递给“FriendlyName”参数。 如果将文件共享的名称传递给“Name”参数，此版本将引发警告以将名称传递到“FriendlyName”参数。

如果未安装最低版本，则可能导致现有脚本失败。 使用以下 PowerShell 命令安装最低版本：

Install-module -Name Az.RecoveryServices -RequiredVersion 2.6.0

触发按需备份

使用 Backup-AzRecoveryServicesBackupItem 为受保护的 Azure 文件共享运行按需备份：

1. 使用 Get-AzRecoveryServicesBackupContainer，从用于保存备份数据的保管库的容器中检索存储帐户。
2. 如需开始备份作业，请使用 Get-AzRecoveryServicesBackupItem 获取有关 Azure 文件共享的信息。
3. 使用 Backup-AzRecoveryServicesBackupItem 运行按需备份。

按如下所示运行按需备份：

$afsContainer = Get-AzRecoveryServicesBackupContainer -FriendlyName "testStorageAcct" -ContainerType AzureStorage
$afsBkpItem = Get-AzRecoveryServicesBackupItem -Container $afsContainer -WorkloadType "AzureFiles" -FriendlyName "testAzureFS"
$job =  Backup-AzRecoveryServicesBackupItem -Item $afsBkpItem

该命令返回一个带有 ID 的作业需要跟踪，如以下示例所示：

WorkloadName     Operation            Status               StartTime                 EndTime                   JobID
------------     ---------            ------               ---------                 -------                   -----
testAzureFS       Backup               Completed            11/12/2018 2:42:07 PM     11/12/2018 2:42:11 PM     8bdfe3ab-9bf7-4be6-83d6-37ff1ca13ab6

在备份时使用 Azure 文件共享快照。 通常，该作业在命令返回此输出时完成。

后续步骤

• 了解如何在 Azure 门户中备份 Azure 文件存储。
• 请参阅 GitHub 上的示例脚本，使用 Azure 自动化 Runbook 来计划备份。