Start-AzStorageBlobCopy

Module:

Az.Storage Module

Starts to copy a blob.

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>
 -DestContainer <String>
 [-BlobBaseClient <BlobBaseClient>]
 [-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>
 -DestCloudBlob <CloudBlob>
 [-BlobBaseClient <BlobBaseClient>]
 [-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
 [-SrcBlob] <String>
 -CloudBlobContainer <CloudBlobContainer>
 -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>]

The Start-AzStorageBlobCopy cmdlet starts to copy a blob.

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

This command starts the copy operation of the blob named ContosoPlanning2015 from the container named ContosoUploads to the container named ContosoArchives.

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

This command gets the container named ContosoUploads, by using the Get-AzStorageContainer cmdlet, and then passes the container to the current cmdlet by using the pipeline operator. That cmdlet starts the copy operation of the blob named ContosoPlanning2015. The previous cmdlet provides the source container. The DestContainer parameter specifies ContosoArchives as the destination container.

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

This command gets the blobs in the container named ContosoUploads, by using the Get-AzStorageBlob cmdlet, and then passes the results to the current cmdlet by using the pipeline operator. That cmdlet starts the copy operation of the blobs to the container named ContosoArchives.

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

The first command gets the blob named ContosoPlanning2015 in the container named ContosoUploads. The command stores that object in the $SrcBlob variable. The second command gets the blob named ContosoPlanning2015Archived in the container named ContosoArchives. The command stores that object in the $DestBlob variable. The last command starts the copy operation from the source container to the destination container. The command uses standard dot notation to specify the ICloudBlob objects for the $SrcBlob and $DestBlob blobs.

$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

This command creates a context for the account named ContosoGeneral that uses the specified key, and then stores that key in the $Context variable. The second command copies the file from the specified URI to the blob named ContosoPlanning in the container named ContosoArchive. The command starts the copy operation to the destination context stored in $Context. There are no source storage context, so the source Uri must have access to the source object. E.g: if the source is a none public Azure blob, the Uri should contain SAS token which has read access to the blob.

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

This command starts the copy operation of a block blob to destination container with a new blob name, and set destination blob StandardBlobTier as Hot, RehydratePriority as High

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.