Quickstart: Create and use an SMB Azure file share

Если у вас нет подписки Azure, создайте бесплатную учетную запись, прежде чем приступить к работе.

Если у вас нет подписки Azure, создайте бесплатную учетную запись, прежде чем приступить к работе.

Azure Cloud Shell

Azure размещает Azure Cloud Shell, интерактивную среду оболочки, которую можно использовать в браузере. Для работы со службами Azure можно использовать Bash или PowerShell с Cloud Shell. Для выполнения кода в этой статье можно использовать предустановленные команды Cloud Shell, не устанавливая ничего в локальной среде.

Чтобы запустить Azure Cloud Shell, выполните приведенные действия.

Вариант	Пример/ссылка
Нажмите кнопку Попробовать в правом верхнем углу блока кода или команд. При нажатии кнопки Попробовать код или команда не копируется в Cloud Shell автоматически.
Чтобы открыть Cloud Shell в браузере, перейдите по адресу https://shell.azure.com или нажмите кнопку Запуск Cloud Shell.
Нажмите кнопку Cloud Shell в строке меню в правом верхнем углу окна портала Azure.

Чтобы использовать Azure Cloud Shell, выполните следующие действия:

1. Запустите Cloud Shell.

2. Нажмите кнопку Копировать в блоке кода (или блоке команд), чтобы скопировать код или команду.

3. Вставьте код или команду в сеанс Cloud Shell, выбрав CTRL+SHIFT+V в Windows и Linux или выбрав Cmd+Shift+V в macOS.

4. Выберите , затем нажмите для выполнения кода или команды.

Если вы хотите установить и использовать PowerShell локально, вам потребуется модуль Azure PowerShell 7.0.0 или более поздней версии. Рекомендуется установить последнюю доступную версию. Чтобы узнать, какая версия запущенного модуля Azure PowerShell, выполните команду Get-InstalledModule Az. Если вам необходимо выполнить обновление, ознакомьтесь со статьей, посвященной установке модуля Azure PowerShell. Если вы используете PowerShell локально, вам также необходимо выполнить Login-AzAccount, чтобы войти в учетную запись Azure. Чтобы использовать многофакторную проверку подлинности, необходимо указать идентификатор клиента Azure, например Login-AzAccount -TenantId <TenantId>.

Предпосылки

• Используйте среду Bash в Azure Cloud Shell. Дополнительные сведения см. в статье "Начало работы с Azure Cloud Shell".

  

• Если вы предпочитаете запускать справочные команды CLI локально, установите Azure CLI. Если вы работаете в Windows или macOS, попробуйте запустить Azure CLI в контейнере Docker. Дополнительные сведения см. в статье Как запустить Azure CLI в контейнере Docker.

  • Если вы используете локальную установку, выполните вход в Azure CLI с помощью команды az login. Чтобы завершить процесс проверки подлинности, выполните действия, отображаемые в терминале. Сведения о других параметрах входа см. в статье "Проверка подлинности в Azure с помощью Azure CLI".

  • Установите расширение Azure CLI при первом использовании, когда появится соответствующий запрос. Дополнительные сведения о расширениях см. в статье Использование расширений и управление ими с помощью Azure CLI.

  • Выполните команду az version, чтобы узнать установленную версию и зависимые библиотеки. Чтобы обновиться до последней версии, выполните команду az upgrade.

• Для работы с этой статьей требуется Azure CLI версии 2.0.4 или более поздней. Если вы используете Azure Cloud Shell, последняя версия уже установлена.

• По умолчанию команды Azure CLI возвращают нотацию объектов JavaScript (JSON), которая является стандартным способом отправки и получения сообщений из REST API. Чтобы упростить работу с ответами JSON, некоторые из примеров в этой статье используют параметр запроса в командах Azure CLI. Этот параметр использует язык запросов JMESPath для анализа JSON. Дополнительные сведения о том, как использовать результаты команд Azure CLI, следуя языку запросов JMESPath, см. в руководстве по JMESPath.

A storage account is a shared pool of storage in which you can deploy an Azure file share or other storage resources, such as blobs or queues. Учетная запись хранения может содержать неограниченное количество долей. A share can store an unlimited number of files, up to the capacity limits of the storage account.

Чтобы создать учетную запись хранения с помощью портала Azure, выполните следующие действия:

1. В разделе Службы Azure выберите Учетные записи хранения.

2. Нажмите кнопку +Создать , чтобы создать учетную запись хранения.

3. В разделе Сведения о проекте выберите подписку Azure, в которой будет создана учетная запись хранения. Если у вас только одна подписка, она должна быть подпиской по умолчанию.

4. Если вы хотите создать новую группу ресурсов, выберите "Создать" и введите имя, например myexamplegroup.

5. В разделе " Сведения об экземпляре" укажите имя учетной записи хранения. Возможно, потребуется добавить несколько случайных чисел, чтобы сделать его глобально уникальным именем. Имя учетной записи хранения может включать только символы в нижнем регистре и цифры. Его длина должна составлять от 3 до 24 символов. Запишите имя учетной записи хранения. Он понадобится вам позже.

6. В регионе выберите регион, в который нужно создать учетную запись хранения.

7. В основной службе выберите Файлы Azure.

8. В поле Производительность оставьте значение по умолчанию Стандартный.

9. In File share billing, keep the default value of Pay-as-you-go file shares.

10. В поле Избыточность выберите Локально избыточное хранилище (LRS).

    

11. Нажмите кнопку "Просмотр и создание ", чтобы просмотреть параметры. Azure выполнит окончательную проверку.

12. После завершения проверки щелкните Создать. Должно появиться уведомление о том, что развертывание выполняется.

13. Когда появится уведомление о завершении развертывания, выберите "Перейти к ресурсу".

PowerShell — создание группы ресурсов

Группа ресурсов — это логический контейнер, в котором происходит развертывание ресурсов Azure и управление ими. Если у вас еще нет группы ресурсов Azure, создайте ее с помощью командлета New-AzResourceGroup . Для создания учетной записи хранения требуется группа ресурсов.

В следующем примере создается группа ресурсов с именем myResourceGroup в регионе "Западная часть США 2".

$resourceGroupName = "myResourceGroup"
$region = "westus2"

New-AzResourceGroup `
    -Name $resourceGroupName `
    -Location $region | Out-Null

PowerShell— создание учетной записи хранения

Учетная запись хранения — это общий пул хранилища, который можно использовать для развертывания общих папок Azure.

В этом примере создается учетная запись хранения с помощью командлета New-AzStorageAccount . Учетная запись хранения называется mystorageaccount< случайным числом>, а ссылка на эту учетную запись хранения хранится в переменной $storageAcct. Имена учетных записей хранения должны быть уникальными, поэтому используйте Get-Random для добавления случайного числа к имени, чтобы сделать его уникальным.

$storageAccountName = "mystorageacct$(Get-Random)"

$storageAcct = New-AzStorageAccount `
    -ResourceGroupName $resourceGroupName `
    -Name $storageAccountName `
    -Location $region `
    -Kind StorageV2 `
    -SkuName Standard_LRS `
    -EnableLargeFileShare

CLI — создание группы ресурсов

Группа ресурсов — это логический контейнер, в котором развертываются ресурсы Azure и управляются ими. Если у вас еще нет группы ресурсов Azure, можно использовать команду az group create для создания группы. Для создания учетной записи хранения требуется группа ресурсов.

В следующем примере создается группа ресурсов с именем myResourceGroup в расположении "Западная часть США 2 ".

export resourceGroupName="myResourceGroup"
region="westus2"

az group create \
    --name $resourceGroupName \
    --location $region \
    --output none

CLI — создание учетной записи хранения

A storage account is a shared pool of storage in which you can deploy Azure file shares.

В следующем примере создается учетная запись хранения с помощью команды az storage account create . Имена учетных записей хранения должны быть уникальными, поэтому используйте $RANDOM для добавления случайного числа к имени, чтобы сделать его уникальным.

export storageAccountName="mystorageacct$RANDOM"

az storage account create \
    --resource-group $resourceGroupName \
    --name $storageAccountName \
    --location $region \
    --kind StorageV2 \
    --sku Standard_LRS \
    --enable-large-file-share \
    --output none

Чтобы создать файловое хранилище Azure, выполните приведенные действия.

1. Выберите учетную запись хранения на панели мониторинга.

2. В меню службы в разделе хранилища данных выберите общие папки.

   

3. В меню в верхней части страницы файловых хранилищ выберите + Файловое хранилище. The New file share page drops down.

4. В поле "Имя" введите myshare. Имена общих папок должны быть всеми буквами нижнего регистра, цифрами и отдельными дефисами, и должны начинаться и заканчиваться буквой нижнего регистра или цифрой. Имя не может содержать два последовательных дефиса. Дополнительные сведения об именовании общих папок и файлов см. в разделе Именование и ссылки на общие папки, каталоги, файлы и метаданные.

5. Оставьте режим Оптимизация транзакций выбранным для уровня доступа.

6. Перейдите на вкладку "Резервное копирование". По умолчанию резервное копирование включено при создании общей папки Azure с помощью портала Azure. Если вы хотите отключить резервное копирование для общей папки, снимите флажок "Включить резервное копирование ". Если вы хотите включить резервное копирование, можно оставить значения по умолчанию или создать хранилище служб восстановления в том же регионе и подписке, что и учетная запись хранения. The Recovery Services Vault stores the recovery points created over time and provides an interface to perform backup and restore related operations. If there's no existing Recovery Services Vault, the portal will default to Create new. Чтобы создать новую политику резервного копирования, нажмите кнопку "Создать новую политику".

   

7. Select Review + create and then Create to create the Azure file share.

Now that you've created a storage account, you can create an Azure file share by using the New-AzRmStorageShare cmdlet. В этом примере создается общая папка с именем myshare с квотой 1024 ГиБ. Квота может быть не более 100 ТиБ.

$shareName = "myshare"

New-AzRmStorageShare `
    -StorageAccount $storageAcct `
    -Name $shareName `
    -EnabledProtocol SMB `
    -QuotaGiB 1024 | Out-Null

Now that you've created a storage account, you can create an Azure file share by using the az storage share-rm create command. В этом примере создается общая папка с именем myshare с квотой 1024 ГиБ. Квота может быть не более 100 ТиБ.

shareName="myshare"

az storage share-rm create \
    --resource-group $resourceGroupName \
    --storage-account $storageAccountName \
    --name $shareName \
    --quota 1024 \
    --enabled-protocols SMB \
    --output none

Чтобы создать новый каталог с именем myDirectory в корне общей папки Azure:

1. На странице параметров общего доступа к файлам выберите общий ресурс myshare. Откроется страница для общей папки, указывающая , что файлы не найдены.
2. В меню в верхней части страницы нажмите кнопку +Добавить каталог. The New directory page drops down.
3. Введите myDirectory и нажмите кнопку "ОК".

Чтобы создать новый каталог с именем myDirectory в корне общей папки Azure, используйте командлет New-AzStorageDirectory .

New-AzStorageDirectory `
   -Context $storageAcct.Context `
   -ShareName $shareName `
   -Path "myDirectory"

Чтобы создать новый каталог с именем myDirectory в корне общей папки Azure, используйте az storage directory create команду:

az storage directory create \
   --account-name $storageAccountName \
   --share-name $shareName \
   --name "myDirectory" \
   --output none

Сначала необходимо создать или выбрать файл для отправки. Сделайте это любым способом, который вы считаете подходящим. Когда вы решили отправить файл, выполните следующие действия:

1. Выберите каталог myDirectory . Откроется панель myDirectory .

2. В меню в верхней части окна выберите "Отправить". Откроется панель "Отправить файлы ".

   

3. Щелкните значок папки, чтобы открыть окно для просмотра локальных файлов.

4. Выберите файл и нажмите кнопку "Открыть".

5. На странице "Отправка файлов" проверьте имя файла и нажмите кнопку "Отправить".

6. По завершении файл должен отображаться в списке на странице myDirectory .

To demonstrate how to upload a file using the Set-AzStorageFileContent cmdlet, we first need to create a file inside your PowerShell Cloud Shell's scratch drive to upload.

Этот пример помещает текущую дату и время в новый файл на временном диске, а затем отправляет файл в общий доступ к файлам.

# this expression will put the current date and time into a new file on your scratch drive
cd "~/CloudDrive/"
Get-Date | Out-File -FilePath "SampleUpload.txt" -Force

# this expression will upload that newly created file to your Azure file share
Set-AzStorageFileContent `
   -Context $storageAcct.Context `
   -ShareName $shareName `
   -Source "SampleUpload.txt" `
   -Path "myDirectory\SampleUpload.txt"

Если вы используете PowerShell локально, замените ~/CloudDrive/ на путь, который имеется на вашем компьютере.

После отправки файла можно использовать командлет Get-AzStorageFile , чтобы убедиться, что файл был отправлен в общую папку Azure.

Get-AzStorageFile `
    -Context $storageAcct.Context `
    -ShareName $shareName `
    -Path "myDirectory\" | Get-AzStorageFile

Чтобы продемонстрировать, как отправить файл с помощью az storage file upload команды, сначала создайте файл для отправки на диске с нуля Cloud Shell. В следующем примере вы создадите и отправьте файл:

cd ~/clouddrive/
date > SampleUpload.txt

az storage file upload \
    --account-name $storageAccountName \
    --share-name $shareName \
    --source "SampleUpload.txt" \
    --path "myDirectory/SampleUpload.txt"

Если вы используете Azure CLI локально, замените ~/clouddrive на путь, который имеется на вашем компьютере.

После отправки файла можно использовать az storage file list команду, чтобы убедиться, что файл был отправлен в общую папку Azure:

az storage file list \
    --account-name $storageAccountName \
    --share-name $shareName \
    --path "myDirectory" \
    --output table

Вы можете скачать копию отправленного файла, щелкнув правой кнопкой мыши файл и выбрав "Скачать". Точный интерфейс зависит от используемой операционной системы и браузера.

You can use the Get-AzStorageFileContent cmdlet to download a copy of the file you uploaded to the scratch drive of your Cloud Shell.

# Delete an existing file by the same name as SampleDownload.txt, if it exists because you've run this example before.
Remove-Item `
    -Path "SampleDownload.txt" `
    -Force `
    -ErrorAction SilentlyContinue

Get-AzStorageFileContent `
    -Context $storageAcct.Context `
    -ShareName $shareName `
    -Path "myDirectory\SampleUpload.txt" `
    -Destination "SampleDownload.txt"

After downloading the file, you can use the Get-ChildItem cmdlet to see that the file has been downloaded to your PowerShell Cloud Shell's scratch drive.

Get-ChildItem | Where-Object { $_.Name -eq "SampleDownload.txt" }

С помощью команды az storage file download можно скачать копию файла, который вы загрузили на временный диск Cloud Shell.

# Delete an existing file by the same name as SampleDownload.txt, if it exists, because you've run this example before
rm -f SampleDownload.txt

az storage file download \
    --account-name $storageAccountName \
    --share-name $shareName \
    --path "myDirectory/SampleUpload.txt" \
    --dest "./SampleDownload.txt" \
    --output none

По завершении работы удалите группу ресурсов. Удаление группы ресурсов удаляет учетную запись хранения, общую папку Azure и все другие ресурсы, развернутые в группе ресурсов.

Если в учетной записи хранения есть блокировки, сначала их нужно удалить. Перейдите к учетной записи хранения и выберите Параметры>Блокировки. Если перечислены какие-либо блокировки, удалите их.

Прежде чем удалить группу ресурсов, может потребоваться удалить хранилище служб восстановления Azure Backup.

1. Выберите Главная, а затем Группы ресурсов.
2. Выберите группу ресурсов, которую нужно удалить.
3. Выберите команду Удалить группу ресурсов. Откроется окно с предупреждением о ресурсах, которые будут удалены вместе с группой ресурсов.
4. Введите имя группы ресурсов и выберите Удалить.

По завершении можно использовать командлет Remove-AzResourceGroup для удаления группы ресурсов и всех ресурсов, содержащихся в группе ресурсов.

Remove-AzResourceGroup -Name myResourceGroup

По завершении можно удалить группу ресурсов и все ресурсы, содержащиеся в группе ресурсов, с помощью az group delete команды:

az group delete --name $resourceGroupName