Set-AzStorageBlobContent
Отправляет локальный файл в большой двоичный объект служба хранилища Azure.
Синтаксис
Set-AzStorageBlobContent
[-File] <String>
[-Container] <String>
[-Blob <String>]
[-BlobType <String>]
[-Properties <Hashtable>]
[-Metadata <Hashtable>]
[-Tag <Hashtable>]
[-PremiumPageBlobTier <PremiumPageBlobTier>]
[-StandardBlobTier <String>]
[-EncryptionScope <String>]
[-Force]
[-AsJob]
[-TagCondition <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzStorageBlobContent
[-File] <String>
[-Blob <String>]
-CloudBlobContainer <CloudBlobContainer>
[-BlobType <String>]
[-Properties <Hashtable>]
[-Metadata <Hashtable>]
[-Tag <Hashtable>]
[-PremiumPageBlobTier <PremiumPageBlobTier>]
[-StandardBlobTier <String>]
[-EncryptionScope <String>]
[-Force]
[-AsJob]
[-TagCondition <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzStorageBlobContent
[-File] <String>
-CloudBlob <CloudBlob>
[-BlobType <String>]
[-Properties <Hashtable>]
[-Metadata <Hashtable>]
[-Tag <Hashtable>]
[-PremiumPageBlobTier <PremiumPageBlobTier>]
[-StandardBlobTier <String>]
[-EncryptionScope <String>]
[-Force]
[-AsJob]
[-TagCondition <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Set-AzStorageBlobContent отправляет локальный файл в большой двоичный объект служба хранилища Azure.
Примеры
Пример 1. Отправка именованного файла
Set-AzStorageBlobContent -Container "ContosoUpload" -File ".\PlanningData" -Blob "Planning2015"
Эта команда отправляет файл с именем PlanningData в большой двоичный объект с именем Planning2015.
Пример 2. Отправка всех файлов в текущую папку
Get-ChildItem -File -Recurse | Set-AzStorageBlobContent -Container "ContosoUploads"
Эта команда использует основной командлет Windows PowerShell Get-ChildItem для получения всех файлов в текущей папке и в вложенных папках, а затем передает их в текущий командлет с помощью оператора конвейера. Командлет Set-AzStorageBlobContent отправляет файлы в контейнер с именем ContosoUploads.
Пример 3. Перезапись существующего большого двоичного объекта
Get-AzStorageBlob -Container "ContosoUploads" -Blob "Planning2015" | Set-AzStorageBlobContent -File "ContosoPlanning"
Эта команда получает большой двоичный объект с именем Planning2015 в контейнере ContosoUploads с помощью командлета Get-AzStorageBlob, а затем передает этот большой двоичный объект текущему командлету. Команда отправляет файл, который называется ContosoPlanning как Planning2015. Эта команда не указывает параметр Force . Командная строка запрашивает подтверждение. При подтверждении команды командлет перезаписывает существующий большой двоичный объект.
Пример 4. Отправка файла в контейнер с помощью конвейера
Get-AzStorageContainer -Container "ContosoUpload*" | Set-AzStorageBlobContent -File "ContosoPlanning" -Blob "Planning2015"
Эта команда получает контейнер, который начинается со строки ContosoUpload с помощью командлета Get-AzStorageContainer , а затем передает этот большой двоичный объект текущему командлету. Команда отправляет файл, который называется ContosoPlanning как Planning2015.
Пример 5. Отправка файла в страничный BLOB-объект с метаданными и PremiumPageBlobTier как P10
$Metadata = @{"key" = "value"; "name" = "test"}
Set-AzStorageBlobContent -File "ContosoPlanning" -Container "ContosoUploads" -Metadata $Metadata -BlobType Page -PremiumPageBlobTier P10
Первая команда создает хэш-таблицу, содержащую метаданные для большого двоичного объекта, и сохраняет хэш-таблицу в переменной $Metadata. Вторая команда отправляет файл с именем ContosoPlanning в контейнер с именем ContosoUploads. Большой двоичный объект содержит метаданные, хранящиеся в $Metadata, и имеет PremiumPageBlobTier как P10.
Пример 6. Отправка файла в большой двоичный объект с указанными свойствами большого двоичного объекта и задание StandardBlobTier в качестве Cool
$filepath = "c:\temp\index.html"
Set-AzStorageBlobContent -File $filepath -Container "contosouploads" -Properties @{"ContentType" = [System.Web.MimeMapping]::GetMimeMapping($filepath); "ContentMD5" = "i727sP7HigloQDsqadNLHw=="} -StandardBlobTier Cool
AccountName: storageaccountname, ContainerName: contosouploads
Name BlobType Length ContentType LastModified AccessTier SnapshotTime IsDeleted VersionId
---- -------- ------ ----------- ------------ ---------- ------------ --------- ---------
index.html BlockBlob 403116 text/html 2020-09-22 08:06:53Z Cool False
Эта команда отправляет файл c:\temp\index.html в контейнер с именем contosouploads с указанными свойствами BLOB-объектов и задает значение StandardBlobTier как Cool. Эта команда получает значение ContentType для свойств BLOB-объектов по API [System.Web.MimeMapping]::GetMimeMapping().
Пример 7. Отправка файла в большой двоичный объект с областью шифрования
$blob = Set-AzStorageBlobContent -File "mylocalfile" -Container "mycontainer" -Blob "myblob" -EncryptionScope "myencryptscope"
$blob.BlobProperties.EncryptionScope
myencryptscope
Эта команда отправляет файл в большой двоичный объект с областью шифрования.
Параметры
-AsJob
Запустите командлет в фоновом режиме.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Blob
Указывает имя большого двоичного объекта. Этот командлет отправляет файл в служба хранилища Azure большой двоичный объект, указанный этим параметром.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-BlobType
Указывает тип большого двоичного объекта, который отправляет этот командлет. Допустимые значения для этого параметра:
- Блокировка
- Стр.
- Добавление
Значение по умолчанию — Block.
Тип: | String |
Допустимые значения: | Block, Page, Append |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ClientTimeoutPerRequest
Указывает интервал времени ожидания на стороне клиента (в секундах) для одного запроса на обслуживание. Если предыдущий вызов завершается сбоем в указанном интервале, этот командлет повторяет запрос. Если этот командлет не получает успешный ответ до истечения интервала, этот командлет возвращает ошибку.
Тип: | Nullable<T>[Int32] |
Aliases: | ClientTimeoutPerRequestInSeconds |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-CloudBlob
Указывает объект CloudBlob . Чтобы получить объект CloudBlob , используйте командлет Get-AzStorageBlob.
Тип: | CloudBlob |
Aliases: | ICloudBlob |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-CloudBlobContainer
Указывает объект CloudBlobContainer из клиентской библиотеки служба хранилища Azure. Этот командлет отправляет содержимое в большой двоичный объект в контейнере, который указывает этот параметр. Чтобы получить объект CloudBlobContainer , используйте командлет Get-AzStorageContainer.
Тип: | CloudBlobContainer |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | 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 |
-Container
Указывает имя контейнера. Этот командлет отправляет файл в большой двоичный объект в контейнере, который указывает этот параметр.
Тип: | String |
Position: | 1 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Context
Указывает контекст хранилища Azure. Чтобы получить контекст хранилища, используйте командлет New-AzStorageContext. Чтобы использовать контекст хранилища, созданный из маркера SAS без разрешения на чтение, необходимо добавить параметр -Force, чтобы пропустить проверку существования BLOB-объектов.
Тип: | IStorageContext |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure.
Тип: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-EncryptionScope
Область шифрования, используемая при выполнении запросов к большому двоичному объекту.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-File
Указывает локальный путь к файлу для отправки в виде содержимого BLOB-объектов.
Тип: | String |
Aliases: | FullName |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-Force
Указывает, что этот командлет перезаписывает существующий большой двоичный объект без запроса на подтверждение.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Metadata
Задает метаданные для отправленного большого двоичного объекта.
Тип: | Hashtable |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-PremiumPageBlobTier
Уровень BLOB-объектов страницы
Тип: | PremiumPageBlobTier |
Допустимые значения: | Unknown, P4, P6, P10, P20, P30, P40, P50, P60, P70, P80 |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Properties
Указывает свойства отправленного большого двоичного объекта. Поддерживаемые свойства: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage, ContentMD5, ContentType.
Тип: | Hashtable |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ServerTimeoutPerRequest
Указывает интервал времени ожидания на стороне службы (в секундах) для запроса. Если указанный интервал истекает перед обработкой запроса службой, служба хранилища возвращает ошибку.
Тип: | Nullable<T>[Int32] |
Aliases: | ServerTimeoutPerRequestInSeconds |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-StandardBlobTier
Блочный уровень BLOB-объектов, допустимые значения: "Горячий", "Холодный", "Архив", "Холодный". Подробные сведения см. в разделе https://learn.microsoft.com/azure/storage/blobs/storage-blob-storage-tiers
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Tag
Теги BLOB-объектов
Тип: | Hashtable |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-TagCondition
Необязательный оператор выражения тега для проверки условия соответствия. Запрос большого двоичного объекта завершится ошибкой, если теги BLOB-объектов не соответствуют заданному выражению. Дополнительные сведения приведены в https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
Тип: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Входные данные
Выходные данные
Связанные ссылки
Azure PowerShell