< Back

Start-AzureStorageBlobIncrementalCopy

Tue Jan 29, 2019 9:28 pm

NAME Start-AzureStorageBlobIncrementalCopy



SYNOPSIS

Start an Incremental copy operation from a Page blob snapshot to the specified destination Page blob.





SYNTAX

Start-AzureStorageBlobIncrementalCopy -AbsoluteUri <String> [-ClientTimeoutPerRequest <Int32>] [-ConcurrentTaskCount <Int32>] [-Context

<IStorageContext>] -DestBlob <String> -DestContainer <String> [-DestContext <IStorageContext>] [-ServerTimeoutPerRequest <Int32>] [-Confirm]

[-WhatIf] [<CommonParameters>]



Start-AzureStorageBlobIncrementalCopy [-ClientTimeoutPerRequest <Int32>] -CloudBlob <CloudPageBlob> [-ConcurrentTaskCount <Int32>] [-Context

<IStorageContext>] [-DestBlob <String>] -DestContainer <String> [-DestContext <IStorageContext>] [-ServerTimeoutPerRequest <Int32>] [-Confirm]

[-WhatIf] [<CommonParameters>]



Start-AzureStorageBlobIncrementalCopy [-ClientTimeoutPerRequest <Int32>] -CloudBlob <CloudPageBlob> [-ConcurrentTaskCount <Int32>] [-Context

<IStorageContext>] -DestCloudBlob <CloudPageBlob> [-DestContext <IStorageContext>] [-ServerTimeoutPerRequest <Int32>] [-Confirm] [-WhatIf]

[<CommonParameters>]



Start-AzureStorageBlobIncrementalCopy [-ClientTimeoutPerRequest <Int32>] -CloudBlobContainer <CloudBlobContainer> [-ConcurrentTaskCount <Int32>]

[-Context <IStorageContext>] [-DestBlob <String>] -DestContainer <String> [-DestContext <IStorageContext>] [-ServerTimeoutPerRequest <Int32>]

-SrcBlob <String> -SrcBlobSnapshotTime <DateTimeOffset> [-Confirm] [-WhatIf] [<CommonParameters>]



Start-AzureStorageBlobIncrementalCopy [-ClientTimeoutPerRequest <Int32>] [-ConcurrentTaskCount <Int32>] [-Context <IStorageContext>] [-DestBlob

<String>] -DestContainer <String> [-DestContext <IStorageContext>] [-ServerTimeoutPerRequest <Int32>] -SrcBlob <String> -SrcBlobSnapshotTime

<DateTimeOffset> -SrcContainer <String> [-Confirm] [-WhatIf] [<CommonParameters>]





DESCRIPTION

Start an Incremental copy operation from a Page blob snapshot to the specified destination Page blob. See more details of the feature in

https://docs.microsoft.com/en-us/rest/a ... -copy-blob.





PARAMETERS

-AbsoluteUri <String>

Absolute Uri to the source. Be noted that the credential should be provided in the Uri, if the source requires any.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-ClientTimeoutPerRequest <Int32>

The client side maximum execution time for each request in seconds.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-CloudBlob <CloudPageBlob>

CloudBlob object from Azure Storage Client library. You can create it or use Get-AzureStorageBlob cmdlet.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName, ByValue)

Accept wildcard characters? false



-CloudBlobContainer <CloudBlobContainer>

CloudBlobContainer object from Azure Storage Client library. You can create it or use Get-AzureStorageContainer cmdlet.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-ConcurrentTaskCount <Int32>

The total amount of concurrent async tasks. The default value is 10.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Context <IStorageContext>

Source Azure Storage Context. You can create it by New-AzureStorageContext cmdlet.



Required? false

Position? named

Default value None

Accept pipeline input? True (ByPropertyName, ByValue)

Accept wildcard characters? false



-DestBlob <String>

Destination blob name



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-DestCloudBlob <CloudPageBlob>

Destination CloudBlob object



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-DestContainer <String>

Destination container name



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-DestContext <IStorageContext>

Destination Azure Storage Context. You can create it by New-AzureStorageContext cmdlet.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-ServerTimeoutPerRequest <Int32>

The server time out for each request in seconds.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-SrcBlob <String>

Source page blob name.



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-SrcBlobSnapshotTime <DateTimeOffset>

Source page blob snapshot time.



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-SrcContainer <String>

Source Container name



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Confirm [<SwitchParameter>]

Prompts you for confirmation before running the cmdlet.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]

Shows what would happen if the cmdlet runs. The cmdlet is not run.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

Microsoft.WindowsAzure.Storage.Blob.CloudPageBlob

Microsoft.WindowsAzure.Storage.Blob.CloudBlobContainer System.String Microsoft.WindowsAzure.Commands.Common.Storage.AzureStorageContext





OUTPUTS

Microsoft.WindowsAzure.Commands.Common.Storage.ResourceModel.AzureStorageBlob







NOTES









Example 1: Start Incremental Copy Operation by blob name and snapshot time



PS C:\\>Start-AzureStorageBlobIncrementalCopy -SrcContainer container1 -SrcBlob blob1 -SrcBlobSnapshotTime "04/07/2017 09:55:36.1190229 AM +00:00"

-DestContainer container2 -DestBlob blob2



This command start Incremental Copy Operation by blob name and snapshot time





Example 2: Start Incremental copy operation using source uri



PS C:\\>Start-AzureStorageBlobIncrementalCopy -AbsoluteUri "http://www.somesite.com/somefile?snapsh ... 0.2126635Z" -DestContainer

container -DestBlob blob -DestContext $context



This command start Incremental Copy Operation using source uri





Example 3: Start Incremental copy operation using container pipeline from GetAzureStorageContainer



PS C:\\>Get-AzureStorageContainer -Container container1 | Start-AzureStorageBlobIncrementalCopy -SrcBlob blob -SrcBlobSnapshotTime "04/07/2017

09:55:36.1190229 AM +00:00" -DestContainer container2



This command start Incremental Copy Operation using container pipeline from GetAzureStorageContainer





Example 4: start Incremental copy operation from CloudPageBlob object to destination blob with blob name



PS C:\\>$srcBlobSnapshot = Get-AzureStorageBlob -Container container1 -prefix blob1| ?{$_.ICloudBlob.IsSnapshot})[0]

PS C:\\>Start-AzureStorageBlobIncrementalCopy -CloudBlob $srcBlobSnapshot.ICloudBlob -DestContainer container2 -DestBlob blob2



This command start Incremental Copy Operation from CloudPageBlob object to destination blob with blob name







RELATED LINKS

Online Version: https://docs.microsoft.com/en-us/powers ... mentalcopy