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


Start-AzStorageBlobCopy

Начинает копировать большой двоичный объект.

Синтаксис

Start-AzStorageBlobCopy
     [-SrcBlob] <String>
     -SrcContainer <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-PremiumPageBlobTier <PremiumPageBlobTier>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-TagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzStorageBlobCopy
     -CloudBlob <CloudBlob>
     [-BlobBaseClient <BlobBaseClient>]
     -DestContainer <String>
     [-DestBlob <String>]
     [-PremiumPageBlobTier <PremiumPageBlobTier>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-TagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzStorageBlobCopy
     -CloudBlob <CloudBlob>
     [-BlobBaseClient <BlobBaseClient>]
     -DestCloudBlob <CloudBlob>
     [-PremiumPageBlobTier <PremiumPageBlobTier>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-TagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzStorageBlobCopy
     -CloudBlobContainer <CloudBlobContainer>
     [-SrcBlob] <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-PremiumPageBlobTier <PremiumPageBlobTier>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-TagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzStorageBlobCopy
     -SrcShareName <String>
     -SrcFilePath <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzStorageBlobCopy
     -SrcShare <CloudFileShare>
     -SrcFilePath <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzStorageBlobCopy
     -SrcDir <CloudFileDirectory>
     -SrcFilePath <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzStorageBlobCopy
     -SrcFile <CloudFile>
     -DestContainer <String>
     [-DestBlob <String>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzStorageBlobCopy
     -SrcFile <CloudFile>
     -DestCloudBlob <CloudBlob>
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzStorageBlobCopy
     -AbsoluteUri <String>
     -DestContainer <String>
     -DestBlob <String>
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-TagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Описание

Командлет Start-AzStorageBlobCopy начинает копировать большой двоичный объект.

Примеры

Пример 1. Копирование именованного большого двоичного объекта

Start-AzStorageBlobCopy -SrcBlob "ContosoPlanning2015" -DestContainer "ContosoArchives" -SrcContainer "ContosoUploads"

Эта команда запускает операцию копирования большого двоичного объекта ContosoPlanning2015 из контейнера ContosoUploads в контейнер с именем ContosoArchives.

Пример 2. Получение контейнера для указания больших двоичных объектов для копирования

Get-AzStorageContainer -Name "ContosoUploads" | Start-AzStorageBlobCopy -SrcBlob "ContosoPlanning2015" -DestContainer "ContosoArchives"

Эта команда получает контейнер с именем ContosoUploads с помощью командлета Get-AzStorageContainer , а затем передает контейнер текущему командлету с помощью оператора конвейера. Этот командлет запускает операцию копирования большого двоичного объекта с именем ContosoPlanning2015. Предыдущий командлет предоставляет исходный контейнер. Параметр DestContainer указывает ContosoArchives в качестве целевого контейнера.

Пример 3. Получение всех больших двоичных объектов в контейнере и их копирование

Get-AzStorageBlob -Container "ContosoUploads" | Start-AzStorageBlobCopy -DestContainer "ContosoArchives"

Эта команда получает большие двоичные объекты в контейнере с именем ContosoUploads с помощью командлета Get-AzStorageBlob , а затем передает результаты текущему командлету с помощью оператора конвейера. Этот командлет запускает операцию копирования больших двоичных объектов в контейнер с именем ContosoArchives.

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

$SrcBlob = Get-AzStorageBlob -Container "ContosoUploads" -Blob "ContosoPlanning2015"
$DestBlob = Get-AzStorageBlob -Container "ContosoArchives" -Blob "ContosoPlanning2015Archived"
Start-AzStorageBlobCopy -ICloudBlob $SrcBlob.ICloudBlob -DestICloudBlob $DestBlob.ICloudBlob

Первая команда получает большой двоичный объект ContosoPlanning2015 в контейнере с именем ContosoUploads. Команда сохраняет этот объект в переменной $SrcBlob. Вторая команда получает большой двоичный объект ContosoPlanning2015Archived в контейнере с именем ContosoArchives. Команда сохраняет этот объект в переменной $DestBlob. Последняя команда запускает операцию копирования из исходного контейнера в целевой контейнер. Команда использует стандартную нотацию точек для указания объектов ICloudBlob для $SrcBlob и больших двоичных объектов $DestBlob.

Пример 5. Копирование большого двоичного объекта из URI

$Context = New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
Start-AzStorageBlobCopy -AbsoluteUri "http://www.contosointernal.com/planning" -DestContainer "ContosoArchive" -DestBlob "ContosoPlanning2015" -DestContext $Context

Эта команда создает контекст для учетной записи ContosoGeneral, которая использует указанный ключ, а затем сохраняет этот ключ в переменной $Context. Вторая команда копирует файл из указанного URI в большой двоичный объект ContosoPlanning в контейнере с именем ContosoArchive. Команда запускает операцию копирования в контекст назначения, хранящийся в $Context. Нет контекста исходного хранилища, поэтому исходный URI должен иметь доступ к исходному объекту. Например, если источник не является общедоступным BLOB-объектом Azure, URI должен содержать маркер SAS, имеющий доступ на чтение к большому двоичному объекту.

Пример 6. Копирование блочного большого двоичного объекта в целевой контейнер с новым именем большого двоичного объекта и задание целевого blob-объекта StandardBlobTier как Hot, RehydratePriority как High

Start-AzStorageBlobCopy -SrcContainer "ContosoUploads" -SrcBlob "BlockBlobName" -DestContainer "ContosoArchives" -DestBlob "NewBlockBlobName" -StandardBlobTier Hot -RehydratePriority High

Эта команда запускает операцию копирования блочного большого двоичного объекта в целевой контейнер с новым именем большого двоичного объекта и задает целевой BLOB-объект StandardBlobTier как Hot, rehydratePriority как High

Параметры

-AbsoluteUri

Указывает абсолютный URI файла для копирования в служба хранилища Azure BLOB-объект.

Тип:String
Aliases:SrcUri, SourceUri
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-BlobBaseClient

Объект BlobBaseClient

Тип:BlobBaseClient
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ClientTimeoutPerRequest

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

Тип:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-CloudBlob

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

Тип:CloudBlob
Aliases:SrcICloudBlob, SrcCloudBlob, ICloudBlob, SourceICloudBlob, SourceCloudBlob
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-CloudBlobContainer

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

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

-Context

Указывает контекст хранилища Azure. Чтобы получить контекст хранилища, используйте командлет New-AzStorageContext.

Тип:IStorageContext
Aliases:SrcContext, SourceContext
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-DefaultProfile

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

Тип:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DestBlob

Указывает имя целевого большого двоичного объекта.

Тип:String
Aliases:DestinationBlob
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DestCloudBlob

Указывает целевой объект CloudBlob

Тип:CloudBlob
Aliases:DestICloudBlob, DestinationCloudBlob, DestinationICloudBlob
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DestContainer

Указывает имя целевого контейнера.

Тип:String
Aliases:DestinationContainer
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DestContext

Указывает контекст хранилища Azure. Чтобы получить контекст хранилища, используйте командлет New-AzStorageContext.

Тип:IStorageContext
Aliases:DestinationContext
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-DestTagCondition

Необязательный оператор выражения тега для проверки состояния соответствия целевого BLOB-объекта. Запрос большого двоичного объекта завершится ошибкой, если теги целевого 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

-Force

Указывает, что этот командлет перезаписывает целевой БОЛЬШОЙ двоичный объект без запроса на подтверждение.

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

-RehydratePriority

Блочный репозиторий BLOB-объектов. Указывает приоритет, с помощью которого необходимо восстановить архивный большой двоичный объект. Допустимые значения: High/Standard.

Тип:RehydratePriority
Допустимые значения:Standard, High
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ServerTimeoutPerRequest

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

Тип:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SrcBlob

Указывает имя исходного большого двоичного объекта.

Тип:String
Aliases:SourceBlob
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SrcContainer

Указывает имя исходного контейнера.

Тип:String
Aliases:SourceContainer
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SrcDir

Указывает объект CloudFileDirectory из клиентской библиотеки служба хранилища Azure.

Тип:CloudFileDirectory
Aliases:SourceDir
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SrcFile

Указывает объект CloudFile из клиентской библиотеки служба хранилища Azure. Его можно создать или использовать командлет Get-AzStorageFile.

Тип:CloudFile
Aliases:SourceFile
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-SrcFilePath

Указывает относительный путь исходного файла к исходному каталогу или исходному ресурсу.

Тип:String
Aliases:SourceFilePath
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SrcShare

Указывает объект CloudFileShare из клиентской библиотеки служба хранилища Azure. Его можно создать или использовать командлет Get-AzStorageShare.

Тип:CloudFileShare
Aliases:SourceShare
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SrcShareName

Указывает имя общей папки источника.

Тип:String
Aliases:SourceShareName
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера: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

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

CloudBlob

CloudBlobContainer

CloudFile

String

IStorageContext

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

AzureStorageBlob