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 |
Входные данные
Выходные данные
Связанные ссылки
Azure PowerShell