Set-AzStorageFileContent
Отправляет содержимое файла.
Синтаксис
Set-AzStorageFileContent
[-ShareName] <String>
[-Source] <String>
[[-Path] <String>]
[-PassThru]
[-Force]
[-AsJob]
[-DisAllowTrailingDot]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[-PreserveSMBAttribute]
[<CommonParameters>]
Set-AzStorageFileContent
[-Share] <CloudFileShare>
[-ShareClient <ShareClient>]
[-Source] <String>
[[-Path] <String>]
[-PassThru]
[-Force]
[-AsJob]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[-PreserveSMBAttribute]
[<CommonParameters>]
Set-AzStorageFileContent
[-Directory] <CloudFileDirectory>
[-ShareDirectoryClient <ShareDirectoryClient>]
[-Source] <String>
[[-Path] <String>]
[-PassThru]
[-Force]
[-AsJob]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[-PreserveSMBAttribute]
[<CommonParameters>]
Описание
Командлет Set-AzStorageFileContent передает содержимое файла в файл в указанном ресурсе.
Примеры
Пример 1. Отправка файла в текущей папке
Set-AzStorageFileContent -ShareName "ContosoShare06" -Source "DataFile37" -Path "ContosoWorkingFolder/CurrentDataFile"
Эта команда отправляет файл с именем DataFile37 в текущей папке в виде файла, который называется CurrentDataFile в папке ContosoWorkingFolder.
Пример 2. Отправка всех файлов в текущей папке
$CurrentFolder = (Get-Item .).FullName
$Container = Get-AzStorageShare -Name "ContosoShare06"
Get-ChildItem -Recurse | Where-Object { $_.GetType().Name -eq "FileInfo"} | ForEach-Object {
$path=$_.FullName.Substring($Currentfolder.Length+1).Replace("\","/")
Set-AzStorageFileContent -Share $Container -Source $_.FullName -Path $path -Force
}
В этом примере используется несколько распространенных командлетов Windows PowerShell и текущий командлет для отправки всех файлов из текущей папки в корневую папку контейнера ContosoShare06.
Первая команда получает имя текущей папки и сохраняет ее в переменной $CurrentFolder.
Вторая команда использует командлет Get-AzStorageShare, чтобы получить общую папку с именем ContosoShare06 , а затем сохранить ее в переменной $Container.
Последняя команда получает содержимое текущей папки и передает каждый из них командлету Where-Object с помощью оператора конвейера.
Этот командлет фильтрует объекты, которые не являются файлами, а затем передает файлы командлету ForEach-Object.
Этот командлет запускает блок скрипта для каждого файла, который создает соответствующий путь для него, а затем использует текущий командлет для отправки файла.
Результат имеет то же имя и ту же относительную позицию относительно других файлов, которые отправляет этот пример.
Дополнительные сведения о блоках скриптов введите Get-Help about_Script_Blocks
.
Пример 3. Отправка локального файла в файл Azure и резервирование свойств локального файла SMB (файлы attributtes, время создания файла, время последней записи файла) в файле Azure.
Set-AzStorageFileContent -Source $localFilePath -ShareName sample -Path "dir1/file1" -PreserveSMBAttribute
В этом примере отправляется локальный файл в файл Azure и сохраняется локальные свойства SMB файла (файлы attributtes, время создания файла, время последней записи файла) в файле Azure.
Параметры
-AsJob
Запустите командлет в фоновом режиме.
Тип: | 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 |
-Directory
Указывает папку как объект CloudFileDirectory . Этот командлет отправляет файл в папку, указанную этим параметром. Чтобы получить каталог, используйте командлет New-AzStorageDirectory. Для получения каталога можно также использовать командлет Get-AzStorageFile.
Тип: | CloudFileDirectory |
Aliases: | CloudFileDirectory |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-DisAllowTrailingDot
Запретить конечные точки (.) для суффикса каталогов и имен файлов.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Force
Указывает, что этот командлет перезаписывает существующий файл хранилища Azure.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-PassThru
Указывает, что этот командлет возвращает объект AzureStorageFile , который он создает или отправляет.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Path
Указывает путь к файлу или папке. Этот командлет отправляет содержимое в файл, указанный этим параметром, или в файл в папку, указанную этим параметром. Если указать папку, этот командлет создает файл с тем же именем, что и исходный файл. Если указать путь к файлу, который не существует, этот командлет создает этот файл и сохраняет содержимое в этом файле. Если указать файл, который уже существует, и указать параметр Force , этот командлет перезаписывает содержимое файла. Если указать файл, который уже существует, и вы не указываете Force, этот командлет не изменяет и возвращает ошибку. Если указать путь к папке, которая не существует, этот командлет не изменяет и возвращает ошибку.
Тип: | String |
Position: | 2 |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | 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 |
-Share
Указывает объект CloudFileShare . Этот командлет отправляет в файл в общей папке этот параметр. Чтобы получить объект CloudFileShare, используйте командлет Get-AzStorageShare . Этот объект содержит контекст хранилища. Если этот параметр указан, не указывайте параметр Context .
Тип: | CloudFileShare |
Aliases: | CloudFileShare |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-ShareClient
Объект ShareClient указал общую папку, в которой будет отправлен файл.
Тип: | ShareClient |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-ShareDirectoryClient
Объект CloudFileDirectory указал облачный каталог, в котором будет отправлен файл.
Тип: | ShareDirectoryClient |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-ShareName
Указывает имя общей папки. Этот командлет отправляет в файл в общей папке этот параметр.
Тип: | String |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Source
Указывает исходный файл, который отправляет этот командлет. Если указать файл, который не существует, этот командлет возвращает ошибку.
Тип: | String |
Aliases: | FullName |
Position: | 1 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
Тип: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |