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


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

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

String

CloudBlobContainer

CloudBlob

IStorageContext

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

AzureStorageBlob