Резервное копирование общей папки Azure с помощью PowerShell
В этой статье описывается, как использовать Azure PowerShell для резервного копирования общей папки Файлов Azure через хранилище Служб восстановления Azure Backup.
В статье описывается выполнение следующих задач:
- Настройте PowerShell и зарегистрируйте поставщика служб восстановления.
- Создайте хранилище служб восстановления.
- Настройте резервное копирование общей папки Azure.
- Запустите задание резервного копирования.
Перед началом работы
Ознакомьтесь со справочником по командлету AZ.RecoveryServices в библиотеке Azure.
Изучите следующую иерархию объектов PowerShell для служб восстановления.
Настройка PowerShell
Примечание.
Мы рекомендуем использовать модуль Azure Az PowerShell для взаимодействия с Azure. Сведения о начале работы см. в статье "Установка Azure PowerShell". Дополнительные сведения см. в статье Перенос Azure PowerShell с AzureRM на Az.
Примечание.
В настоящее время Azure PowerShell не поддерживает политики резервного копирования с почасовым расписанием. Этой функцией можно воспользоваться на портале Azure. Подробнее
Настройка PowerShell:
Загрузите последнюю версию Azure PowerShell.
Примечание.
Минимальная версия PowerShell, необходимая для резервного копирования общих папок Azure — Az.RecoveryServices 2.6.0. Использование последней версии или по крайней мере минимальной версии позволяет избежать проблем с существующими сценариями. Установите минимальную версию с помощью следующей команды PowerShell:
Install-module -Name Az.RecoveryServices -RequiredVersion 2.6.0
Найдите командлеты PowerShell для Azure Backup с помощью следующей команды:
Get-Command *azrecoveryservices*
Отображаются псевдонимы и командлеты для службы архивации Azure, Azure Site Recovery и хранилища Служб восстановления. Ниже приведен пример того, что нам необходимо. Это неполный список командлетов.
Чтобы войти в учетную запись Azure, используйте командлет Connect-AzAccount.
На появившейся веб-странице вам будет предложено ввести учетные данные.
Кроме того, учетные данные можно добавить в качестве параметра в командлет Connect-AzAccount, используя параметр -Credential.
Если вы партнер CSP, работающий от имени клиента, вам потребуется указать заказчика в качестве клиента. Для этого нужно ввести идентификатор или основное доменное имя клиента. Например: Connect-AzAccount-Tenant "fabrikam.com".
Свяжите подписку, которую собираетесь использовать, с учетной записью, так как последняя может иметь несколько подписок.
Select-AzSubscription -SubscriptionName $SubscriptionName
Если вы используете службу архивации Azure впервые, выполните командлет Register-AzResourceProvider, чтобы зарегистрировать поставщика Служб восстановления Azure в своей подписке.
Register-AzResourceProvider -ProviderNamespace "Microsoft.RecoveryServices"
Убедитесь в успешной регистрации поставщиков, выполнив следующие команды:
Get-AzResourceProvider -ProviderNamespace "Microsoft.RecoveryServices"
В выходных данных команды для RegistrationState должно быть установлено значение Registered. Если это не так, повторно выполните командлет Register-AzResourceProvider.
Создание хранилища Служб восстановления
Хранилище Служб восстановления представляет собой ресурс Resource Manager, поэтому вам потребуется разместить его в группе ресурсов. Вы можете использовать имеющуюся группу ресурсов или создать новую, выполнив командлет New-AzResourceGroup. При создании группы ресурсов укажите ее имя и расположение.
Чтобы создать хранилище Служб восстановления, выполните описанные ниже действия.
Вы можете использовать имеющуюся группу ресурсов или создать новую, выполнив командлет New-AzResourceGroup. В этом разделе вы создадите группу ресурсов в регионе Западная часть США.
New-AzResourceGroup -Name "test-rg" -Location "West US"
С помощью командлета New-AzRecoveryServicesVault создайте хранилище. Разместите хранилище там же, где находится группа ресурсов.
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 Backup нуждаются в объекте хранилища Служб восстановления в качестве входных данных, поэтому объект хранилища удобно хранить в переменной.
Контекст хранилища — это тип данных, защищаемых в хранилище. Задайте его с помощью Set-AzRecoveryServicesVaultContext. Заданный контекст применяется ко всем последующим командлетам.
В следующем примере задается контекст для хранилища testvault.
Get-AzRecoveryServicesVault -Name "testvault" | Set-AzRecoveryServicesVaultContext
Получение идентификатора хранилища
Мы планируем отказаться от параметра контекста хранилища в соответствии с рекомендациями Azure PowerShell. Вместо этого можно сохранить или извлечь идентификатор хранилища и передать его в соответствующие команды. Если вы не указали контекст хранилища или хотите указать команду для выполнения в определенном хранилище, передайте идентификатор хранилища как -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
Настройка политики резервного копирования
Политика архивации определяет расписание резервного копирования и время хранения резервных точек восстановления.
Политика резервного копирования связана по крайней мере с одной политикой хранения. Политика хранения определяет продолжительность хранения точки восстановления до ее удаления. Выполнение резервного копирования можно настроить ежедневно, еженедельно, ежемесячно или ежегодно. С помощью нескольких политик резервного копирования можно также настроить ежечасное сохранение резервных копий.
Выберите тип политики:
Ниже приведены некоторые командлеты для политик архивации.
- Просмотрите политику резервного копирования по умолчанию с помощью команды Get-AzRecoveryServicesBackupRetentionPolicyObject.
- Просмотрите политику резервного копирования по умолчанию с помощью команды Get-AzRecoveryServicesBackupSchedulePolicyObject.
- Создайте новую политику резервного копирования с помощью команды New-AzRecoveryServicesBackupProtectionPolicy. Вы вводите в качестве входных данных объекты политики расписания и хранения.
По умолчанию время начала определяется в объекте политики Schedule. Используйте следующий пример, чтобы изменить время запуска на нужное значение. Нужное время начала должно быть в формате UTC. В примере предполагается, что требуемое время начала для ежедневного резервного копирования — 01:00 UTC.
$schPol = Get-AzRecoveryServicesBackupSchedulePolicyObject -WorkloadType "AzureFiles"
$UtcTime = Get-Date -Date "2019-03-20 01:30:00Z"
$UtcTime = $UtcTime.ToUniversalTime()
$schpol.ScheduleRunTimes[0] = $UtcTime
Внимание
Необходимо указать время начала в 30-минутном формате. В предыдущем примере это может быть только "01:00:00" или "02:30:00". Время начала не может быть "01:15:00".
В следующем примере показано сохранение политик расписания и хранения в переменных. Затем эти переменные используются в качестве параметров для новой политики (NewAFSPolicy). NewAFSPolicy выполняет ежедневное резервное копирование и хранит его в течение 30 дней.
$schPol = Get-AzRecoveryServicesBackupSchedulePolicyObject -WorkloadType "AzureFiles"
$retPol = Get-AzRecoveryServicesBackupRetentionPolicyObject -WorkloadType "AzureFiles"
New-AzRecoveryServicesBackupProtectionPolicy -Name "NewAFSPolicy" -WorkloadType "AzureFiles" -RetentionPolicy $retPol -SchedulePolicy $schPol
Выход аналогичен приведенному ниже:
Name WorkloadType BackupManagementType BackupTime DaysOfWeek
---- ------------ -------------------- ---------- ----------
NewAFSPolicy AzureFiles AzureStorage 10/24/2019 1:30:00 AM
Включение резервного копирования
Определив политику резервного копирования, вы можете включить защиту для общей папки Azure с помощью этой политики.
Извлечение политики резервного копирования
Получить соответствующий объект политики можно с помощью командлета Get-AzRecoveryServicesBackupProtectionPolicy. Он позволяет получить конкретную политику или просмотреть политики, связанные с типом рабочей нагрузки.
Получение политики для типа рабочей нагрузки
В следующем примере возвращаются политики для типа рабочей нагрузки AzureFiles.
Get-AzRecoveryServicesBackupProtectionPolicy -WorkloadType "AzureFiles"
Выход аналогичен приведенному ниже:
Name WorkloadType BackupManagementType BackupTime DaysOfWeek
---- ------------ -------------------- ---------- ----------
dailyafs AzureFiles AzureStorage 1/10/2018 12:30:00 AM
Примечание.
Часовой пояс поля BackupTime в PowerShell — UTC. Однако при отображении времени архивации на портале Azure время меняется в соответствии с локальным часовым поясом.
Получение конкретной политики
Следующая политика извлекает политику резервного копирования с именем dailyafs.
$afsPol = Get-AzRecoveryServicesBackupProtectionPolicy -Name "dailyafs"
Включение защиты и применение политики
Включите защиту с помощью команды Enable-AzRecoveryServicesBackupProtection. После того как политика будет связана с хранилищем, резервные копии будут активированы в соответствии с расписанием политики.
В следующем примере включается защита для общей папки Azure testAzureFS в разделе учетной записи хранения testStorageAcct с помощью политики dailyafs:
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 Backup. Обычно идентификатор является понятным именем пользователя. Но для сценария обратимого удаления, в котором можно удалить общую папку и создать другую общую папку с тем же именем, уникальный идентификатор общей папки Azure теперь является идентификатором.
Чтобы узнать уникальный идентификатор каждого элемента, выполните команду Get-AzRecoveryServicesBackupItem с соответствующими фильтрами дляbackupManagementType and WorkloadType, чтобы получить все соответствующие элементы. Затем просмотрите поле с именем в возвращенном объекте или ответе PowerShell.
Рекомендуется перечислить элементы, а затем извлечь их уникальное имя из поля с именем в ответе. Используйте это значение для фильтрации элементов с помощью параметра Name. В противном случае используйте параметр FriendlyName для получения элемента с его идентификатором.
Внимание
Убедитесь, что PowerShell обновлен до минимальной версии (Az.RecoveryServices 2.6.0) для резервного копирования общей папки Azure. В этой версии для команды Get-AzRecoveryServicesBackupItem доступен фильтр FriendlyName.
Передайте имя общей папки Azure в параметр FriendlyName. Если имя общей папки передается в параметр Name, эта версия выдает предупреждение, чтобы передать имя в параметр FriendlyName.
Установка минимальной версии может привести к сбою существующих скриптов. Установите минимальную версию PowerShell с помощью следующей команды:
Install-module -Name Az.RecoveryServices -RequiredVersion 2.6.0
Активирование резервного копирования по запросу
Для запуска задания резервного копирования по требованию для защищенной общей папки Azure используйте команду Backup-AzRecoveryServicesBackupItem.
- Получите учетную запись хранения из контейнера в хранилище, в котором хранятся резервные копии данных, с помощью команды Get-AzRecoveryServicesBackupContainer.
- Чтобы запустить задание резервного копирования, получите сведения об общей папке Azure с помощью команды Get-AzRecoveryServicesBackupItem.
- Выполните резервное копирование по требованию с помощью командлета Backup-AzRecoveryServicesBackupItem.
Чтобы выполнить резервное копирование по запросу, сделайте следующее:
$afsContainer = Get-AzRecoveryServicesBackupContainer -FriendlyName "testStorageAcct" -ContainerType AzureStorage
$afsBkpItem = Get-AzRecoveryServicesBackupItem -Container $afsContainer -WorkloadType "AzureFiles" -FriendlyName "testAzureFS"
$job = Backup-AzRecoveryServicesBackupItem -Item $afsBkpItem
Эта команда возвращает задания для отслеживания с идентификатором, как показано в следующем примере.
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 для использования модуля Runbook службы автоматизации Azure.