Прочитать на английском

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

Set-AzStorageBlobContent

  • Ссылка
Модуль:
Az.Storage

Отправляет локальный файл в большой двоичный объект службы хранилища 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

Запрашивает подтверждение перед запуском cmdlet.

Тип: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

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

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