Set-AzureStorageBlobContent
Отправляет локальный файл в большой двоичный объект служба хранилища Azure.
Предупреждение
Модуль AzureRM PowerShell официально объявлен устаревшим с 29 февраля 2024 г. Пользователям рекомендуется выполнить миграцию из AzureRM в модуль Az PowerShell, чтобы обеспечить постоянную поддержку и обновления.
Хотя модуль AzureRM по-прежнему может функционировать, он больше не поддерживается или не поддерживается, размещая любое постоянное использование на усмотрение и риск пользователя. Ознакомьтесь с нашими ресурсами миграции, чтобы получить рекомендации по переходу в модуль Az.
Синтаксис
Set-AzureStorageBlobContent
[-File] <String>
[-Container] <String>
[-Blob <String>]
[-BlobType <String>]
[-Properties <Hashtable>]
[-Metadata <Hashtable>]
[-PremiumPageBlobTier <PremiumPageBlobTier>]
[-Force]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzureStorageBlobContent
[-File] <String>
[-Blob <String>]
-CloudBlobContainer <CloudBlobContainer>
[-BlobType <String>]
[-Properties <Hashtable>]
[-Metadata <Hashtable>]
[-PremiumPageBlobTier <PremiumPageBlobTier>]
[-Force]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzureStorageBlobContent
[-File] <String>
-CloudBlob <CloudBlob>
[-BlobType <String>]
[-Properties <Hashtable>]
[-Metadata <Hashtable>]
[-PremiumPageBlobTier <PremiumPageBlobTier>]
[-Force]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Описание
Командлет Set-AzureStorageBlobContent отправляет локальный файл в большой двоичный объект служба хранилища Azure.
Примеры
Пример 1. Отправка именованного файла
PS C:\>Set-AzureStorageBlobContent -Container "ContosoUpload" -File ".\PlanningData" -Blob "Planning2015"Эта команда отправляет файл с именем PlanningData в большой двоичный объект с именем Planning2015.
Пример 2. Отправка всех файлов в текущую папку
PS C:\>Get-ChildItem -File -Recurse | Set-AzureStorageBlobContent -Container "ContosoUploads"Эта команда использует основной командлет Windows PowerShell Get-ChildItem для получения всех файлов в текущей папке и в вложенных папках, а затем передает их в текущий командлет с помощью оператора конвейера. Командлет Set-AzureStorageBlobContent отправляет файлы в контейнер с именем ContosoUploads.
Пример 3. Перезапись существующего большого двоичного объекта
PS C:\>Get-AzureStorageBlob -Container "ContosoUploads" -Blob "Planning2015" | Set-AzureStorageBlobContent -File "ContosoPlanning"Эта команда получает большой двоичный объект с именем Planning2015 в контейнере ContosoUploads с помощью командлета Get-AzureStorageBlob, а затем передает этот большой двоичный объект текущему командлету. Команда отправляет файл, который называется ContosoPlanning как Planning2015. Эта команда не указывает параметр Force . Командная строка запрашивает подтверждение. При подтверждении команды командлет перезаписывает существующий большой двоичный объект.
Пример 4. Отправка файла в контейнер с помощью конвейера
PS C:\>Get-AzureStorageContainer -Container "ContosoUpload*" | Set-AzureStorageBlobContent -File "ContosoPlanning" -Blob "Planning2015"Эта команда получает контейнер, который начинается со строки ContosoUpload с помощью командлета Get-AzureStorageContainer , а затем передает этот большой двоичный объект текущему командлету. Команда отправляет файл, который называется ContosoPlanning как Planning2015.
Пример 5. Отправка файла в страничный BLOB-объект с метаданными и PremiumPageBlobTier как P10
PS C:\>$Metadata = @{"key" = "value"; "name" = "test"}
PS C:\> Set-AzureStorageBlobContent -File "ContosoPlanning" -Container "ContosoUploads" -Metadata $Metadata -BlobType Page -PremiumPageBlobTier P10Первая команда создает хэш-таблицу, содержащую метаданные для большого двоичного объекта, и сохраняет хэш-таблицу в переменной $Metadata. Вторая команда отправляет файл с именем ContosoPlanning в контейнер с именем ContosoUploads. Большой двоичный объект содержит метаданные, хранящиеся в $Metadata, и имеет PremiumPageBlobTier как P10.
Пример 6. Отправка файла в большой двоичный объект с указанными свойствами BLOB-объектов
PS C:\> Set-AzureStorageBlobContent -File "ContosoPlanning" -Container "ContosoUploads" -Properties @{"ContentType" = "image/jpeg"; "ContentMD5" = "i727sP7HigloQDsqadNLHw=="}Эта команда отправляет файл с именем ContosoPlanning в контейнер с именем ContosoUploads с указанными свойствами BLOB-объектов.
Параметры
-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] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-CloudBlob
Указывает объект CloudBlob . Чтобы получить объект CloudBlob , используйте командлет Get-AzureStorageBlob.
| Тип: | CloudBlob |
| Aliases: | ICloudBlob |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-CloudBlobContainer
Указывает объект CloudBlobContainer из клиентской библиотеки служба хранилища Azure. Этот командлет отправляет содержимое в большой двоичный объект в контейнере, который указывает этот параметр. Чтобы получить объект CloudBlobContainer , используйте командлет Get-AzureStorageContainer.
| Тип: | 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-AzureStorageContext. Чтобы использовать контекст хранилища, созданный из маркера 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 |
-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 |
| 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] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
| Тип: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |