Поделиться через

Get-AzStorageFileContent

  • Ссылка
Модуль:
Az.Storage

Загружает содержимое файла.

Синтаксис

Get-AzStorageFileContent
   [-ShareName] <String>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-DisAllowTrailingDot]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]
Get-AzStorageFileContent
   [-ShareClient] <ShareClient>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]
Get-AzStorageFileContent
   [-ShareDirectoryClient] <ShareDirectoryClient>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]
Get-AzStorageFileContent
   [-ShareFileClient] <ShareFileClient>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]

Описание

Командлет Get-AzStorageFileContent загружает содержимое файла и сохраняет его в указанное место назначения. Этот командлет не возвращает содержимое файла.

Примеры

Пример 1. Скачивание файла из папки

Get-AzStorageFileContent -ShareName "ContosoShare06" -Path "ContosoWorkingFolder/CurrentDataFile"

Эта команда скачивает файл с именем CurrentDataFile в папке ContosoWorkingFolder из общей папки ContosoShare06 в текущую папку.

Пример 2. Скачивание файлов в примере общей папки

Get-AzStorageFile -ShareName sample | Where-Object {$_.GetType().Name -eq "AzureStorageFile"} | Get-AzStorageFileContent

В этом примере файлы скачиваются в образце общей папки

Пример 3. Скачайте файл Azure в локальный файл и замените свойства SMB файлов Azure (файлы attributtes, время создания файла, время последней записи файла) в локальном файле.

Get-AzStorageFileContent -ShareName sample -Path "dir1/file1" -Destination $localFilePath -PreserveSMBAttribute

В этом примере файл Azure загружается в локальный файл и сохраняет свойства SMB файлов Azure (атрибуты файлов, время создания файла, время последней записи файла) в локальном файле.

Параметры

-AsJob

Запустите командлет в фоновом режиме.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-CheckMd5

Указывает, следует ли проверить сумму Md5 для скачаемого файла.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ClientTimeoutPerRequest

Указывает интервал времени ожидания на стороне клиента (в секундах) для одного запроса на обслуживание. Если предыдущий вызов завершается сбоем в указанном интервале, этот командлет повторяет запрос. Если этот командлет не получает успешный ответ до истечения интервала, этот командлет возвращает ошибку.

Тип:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ConcurrentTaskCount

Указывает максимальное число одновременных сетевых вызовов. Этот параметр можно использовать для ограничения параллелизма для регулирования использования локального ЦП и пропускной способности, указав максимальное количество одновременных сетевых вызовов. Указанное значение является абсолютным числом и не умножается на число ядер. Этот параметр может помочь уменьшить проблемы с сетевым подключением в средах с низкой пропускной способностью, например 100 килобит в секунду. Значение по умолчанию — 10.

Тип:Nullable<T>[Int32]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Confirm

Запрашивает подтверждение перед запуском командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Context

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

Тип:IStorageContext
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure.

Тип:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Destination

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

Тип:String
Position:2
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisAllowTrailingDot

Запретить конечные точки (.) для суффикса каталогов и имен файлов.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Force

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PassThru

Указывает, что этот командлет возвращает объект AzureStorageFile, который он загружает.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Path

Указывает путь к файлу. Этот командлет получает содержимое файла, указанного этим параметром. Если файл не существует, этот командлет возвращает ошибку.

Тип:String
Position:1
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PreserveSMBAttribute

Сохраните свойства SMB исходного файла (атрибуты файлов, время создания файла, время последней записи файла) в целевом файле. Этот параметр доступен только в Windows.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ServerTimeoutPerRequest

Указывает интервал времени ожидания на стороне службы (в секундах) для запроса. Если указанный интервал истекает перед обработкой запроса службой, служба хранилища возвращает ошибку.

Тип:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ShareClient

Объект ShareClient указывает общую папку, в которой будет скачан файл.

Тип:ShareClient
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ShareDirectoryClient

Объект ShareDirectoryClient указал облачный каталог, в котором будет скачан файл.

Тип:ShareDirectoryClient
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ShareFileClient

Объект ShareFileClient указывает, что скачанный облачный файл.

Тип:ShareFileClient
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ShareName

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

Тип:String
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

ShareClient

ShareDirectoryClient

ShareFileClient

IStorageContext

Выходные данные

AzureStorageFile