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

Пример 3. Перезапись существующего большого двоичного объекта

Get-AzStorageBlob -Container "ContosoUploads" -Blob "Planning2015" | Set-AzStorageBlobContent -File "ContosoPlanning"

Эта команда получает большой двоичный объект с именем Planning2015 в контейнере ContosoUploads с помощью командлета Get-Az служба хранилища Blob, а затем передает этот большой двоичный объект текущему командлету. Команда отправляет файл, который называется ContosoPlanning как Planning2015. Эта команда не указывает параметр Force . Командная строка запрашивает подтверждение. При подтверждении команды командлет перезаписывает существующий большой двоичный объект.

Пример 4. Отправка файла в контейнер с помощью конвейера

Get-AzStorageContainer -Container "ContosoUpload*" | Set-AzStorageBlobContent -File "ContosoPlanning" -Blob "Planning2015"

Эта команда получает контейнер, который начинается со строки ContosoUpload с помощью командлета Get-Az служба хранилища Container, а затем передает этот большой двоичный объект текущему командлету. Команда отправляет файл, который называется 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

Запустите командлет в фоновом режиме.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Blob

Указывает имя большого двоичного объекта. Этот командлет отправляет файл в служба хранилища Azure большой двоичный объект, указанный этим параметром.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BlobType

Указывает тип большого двоичного объекта, который отправляет этот командлет. Допустимые значения для этого параметра:

Блокировка
Страница
Добавление

Значение по умолчанию — Block.

Type:	String
Accepted values:	Block, Page, Append
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClientTimeoutPerRequest

Указывает интервал времени ожидания на стороне клиента (в секундах) для одного запроса на обслуживание. Если предыдущий вызов завершается сбоем в указанном интервале, этот командлет повторяет запрос. Если этот командлет не получает успешный ответ до истечения интервала, этот командлет возвращает ошибку.

Type:	Nullable<T>[Int32]
Aliases:	ClientTimeoutPerRequestInSeconds
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CloudBlob

Указывает объект CloudBlob . Чтобы получить объект CloudBlob, используйте командлет Get-Az служба хранилища Blob.

Type:	CloudBlob
Aliases:	ICloudBlob
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-CloudBlobContainer

Указывает объект CloudBlobContainer из клиентской библиотеки служба хранилища Azure. Этот командлет отправляет содержимое в большой двоичный объект в контейнере, который указывает этот параметр. Чтобы получить объект CloudBlobContainer, используйте командлет Get-Az служба хранилища Container.

Type:	CloudBlobContainer
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ConcurrentTaskCount

Указывает максимальное число одновременных сетевых вызовов. Этот параметр можно использовать для ограничения параллелизма для регулирования использования локального ЦП и пропускной способности, указав максимальное количество одновременных сетевых вызовов. Указанное значение является абсолютным числом и не умножается на число ядер. Этот параметр может помочь уменьшить проблемы с сетевым подключением в средах с низкой пропускной способностью, например 100 килобит в секунду. Значение по умолчанию — 10.

Type:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Запрос подтверждения перед выполнением командлета.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Container

Указывает имя контейнера. Этот командлет отправляет файл в большой двоичный объект в контейнере, который указывает этот параметр.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Context

Указывает контекст хранилища Azure. Чтобы получить контекст хранилища, используйте командлет New-Az служба хранилища Context. Чтобы использовать контекст хранилища, созданный из маркера SAS без разрешения на чтение, необходимо добавить параметр -Force, чтобы пропустить проверка существование BLOB-объектов.

Type:	IStorageContext
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure.

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EncryptionScope

Шифрование область использовать при выполнении запросов к большому двоичному объекту.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-File

Указывает локальный путь к файлу для отправки в виде содержимого BLOB-объектов.

Type:	String
Aliases:	FullName
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Force

Указывает, что этот командлет перезаписывает существующий большой двоичный объект без запроса на подтверждение.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Metadata

Задает метаданные для отправленного большого двоичного объекта.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PremiumPageBlobTier

Уровень BLOB-объектов страницы

Type:	PremiumPageBlobTier
Accepted values:	Unknown, P4, P6, P10, P20, P30, P40, P50, P60, P70, P80
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Properties

Указывает свойства отправленного большого двоичного объекта. Поддерживаемые свойства: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage, ContentMD5, ContentType.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServerTimeoutPerRequest

Указывает интервал времени ожидания на стороне службы (в секундах) для запроса. Если указанный интервал истекает перед обработкой запроса службой, служба хранилища возвращает ошибку.

Type:	Nullable<T>[Int32]
Aliases:	ServerTimeoutPerRequestInSeconds
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StandardBlobTier

Блочный уровень BLOB-объектов, допустимые значения: "Горячий", "Холодный", "Архив", "Холодный". Подробные сведения см. в разделе https://learn.microsoft.com/azure/storage/blobs/storage-blob-storage-tiers

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

Теги BLOB-объектов

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TagCondition

Необязательный оператор выражения тега для проверка условии соответствия. Запрос большого двоичного объекта завершится ошибкой, если теги BLOB-объектов не соответствуют заданному выражению. Дополнительные сведения приведены в https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

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

String

CloudBlobContainer

CloudBlob

IStorageContext

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

AzureStorageBlob