Get-AzStorageFileContent
Загружает содержимое файла.
Синтаксис
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
[-Share] <CloudFileShare>
[-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
[-Directory] <CloudFileDirectory>
[-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
[-File] <CloudFile>
[-ShareFileClient <ShareFileClient>]
[[-Destination] <String>]
[-CheckMd5]
[-PassThru]
[-Force]
[-AsJob]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[-PreserveSMBAttribute]
[<CommonParameters>]
Описание
Командлет Get-Az служба хранилища FileContent загружает содержимое файла, а затем сохраняет его в указанное место назначения. Этот командлет не возвращает содержимое файла.
Примеры
Пример 1. Скачивание файла из папки
Get-AzStorageFileContent -ShareName "ContosoShare06" -Path "ContosoWorkingFolder/CurrentDataFile"
Эта команда скачивает файл с именем CurrentDataFile в папке ContosoWorkingFolder из общей папки ContosoShare06 в текущую папку.
Пример 2. Скачивание файлов в примере общей папки
Get-AzStorageFile -ShareName sample | Where-Object {$_.GetType().Name -eq "CloudFile"} | Get-AzStorageFileContent
В этом примере файлы скачиваются в образце общей папки
Пример 3. Скачивание файла Azure в локальный файл и резервирование свойств Azure File S МБ (файл attributtes, время создания файла, время последней записи файла) в локальном файле.
Get-AzStorageFileContent -ShareName sample -Path "dir1/file1" -Destination $localFilePath -PreserveSMBAttribute
В этом примере файл Azure загружается в локальный файл и сохраняет свойства Azure File S МБ (файл attributtes, время создания файла, время последней записи файла) в локальном файле.
Параметры
-AsJob
Запустите командлет в фоновом режиме.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CheckMd5
Указывает, следует ли проверка сумму Md5 для скачаемого файла.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClientTimeoutPerRequest
Указывает интервал времени ожидания на стороне клиента (в секундах) для одного запроса на обслуживание. Если предыдущий вызов завершается сбоем в указанном интервале, этот командлет повторяет запрос. Если этот командлет не получает успешный ответ до истечения интервала, этот командлет возвращает ошибку.
Type: | Nullable<T>[Int32] |
Aliases: | ClientTimeoutPerRequestInSeconds |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConcurrentTaskCount
Указывает максимальное число одновременных сетевых вызовов. Этот параметр можно использовать для ограничения параллелизма для регулирования использования локального ЦП и пропускной способности, указав максимальное количество одновременных сетевых вызовов. Указанное значение является абсолютным числом и не умножается на число ядер. Этот параметр может помочь уменьшить проблемы с сетевым подключением в средах с низкой пропускной способностью, например 100 килобит в секунду. Значение по умолчанию — 10.
Type: | Nullable<T>[Int32] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Запрос подтверждения перед выполнением командлета.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Context
Указывает контекст служба хранилища Azure. Чтобы получить контекст, используйте командлет New-Az служба хранилища Context.
Type: | IStorageContext |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure.
Type: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Destination
Указывает путь назначения. Этот командлет скачивает содержимое файла в расположение, указанное этим параметром. Если указать путь к файлу, который не существует, этот командлет создает этот файл и сохраняет содержимое в новом файле. Если указать путь к файлу, который уже существует, и указать параметр Force , командлет перезаписывает файл. Если указать путь к существующему файлу и не указать Force, командлет предложит вам, прежде чем продолжить. Если указать путь к папке, этот командлет пытается создать файл с именем файла хранилища Azure.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Directory
Указывает папку как объект CloudFileDirectory . Этот командлет получает содержимое для файла в папке, указанной этим параметром. Чтобы получить каталог, используйте командлет New-Az служба хранилища Directory. Для получения каталога можно также использовать командлет Get-Az служба хранилища File.
Type: | CloudFileDirectory |
Aliases: | CloudFileDirectory |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DisAllowTrailingDot
Запретить конечные точки (.) для суффикса каталогов и имен файлов.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-File
Указывает файл как объект CloudFile . Этот командлет получает файл, указанный этим параметром. Чтобы получить объект CloudFile, используйте командлет Get-Az служба хранилища File.
Type: | CloudFile |
Aliases: | CloudFile |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Force
Если указать путь к файлу, который не существует, этот командлет создает этот файл и сохраняет содержимое в новом файле. Если указать путь к файлу, который уже существует, и указать параметр Force , командлет перезаписывает файл. Если указать путь к существующему файлу и не указать Force, командлет предложит вам, прежде чем продолжить. Если указать путь к папке, этот командлет пытается создать файл с именем файла хранилища Azure.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Указывает, что этот командлет возвращает объект Azure служба хранилища File, который он загружает.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Указывает путь к файлу. Этот командлет получает содержимое файла, указанного этим параметром. Если файл не существует, этот командлет возвращает ошибку.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PreserveSMBAttribute
Сохраните свойства исходного файла S МБ (файлы attributtes, время создания файла, время последней записи файла) в целевом файле. Этот параметр доступен только в Windows.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServerTimeoutPerRequest
Указывает интервал времени ожидания на стороне службы (в секундах) для запроса. Если указанный интервал истекает перед обработкой запроса службой, служба хранилища возвращает ошибку.
Type: | Nullable<T>[Int32] |
Aliases: | ServerTimeoutPerRequestInSeconds |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Share
Указывает объект CloudFileShare . Этот командлет скачивает содержимое файла в общей папке, указанный параметром. Чтобы получить объект CloudFileShare, используйте командлет Get-Az служба хранилища Share. Этот объект содержит контекст хранилища. Если этот параметр указан, не указывайте параметр Context .
Type: | CloudFileShare |
Aliases: | CloudFileShare |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ShareClient
Объект CloudFileShare указывает общую папку, в которой будет скачан файл.
Type: | ShareClient |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ShareDirectoryClient
Объект ShareDirectoryClient указал облачный каталог, в котором будет скачан файл.
Type: | ShareDirectoryClient |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ShareFileClient
Объект ShareFileClient указывает, что скачанный облачный файл.
Type: | ShareFileClient |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ShareName
Указывает имя общей папки. Этот командлет скачивает содержимое файла в общей папке, указанный параметром.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |