你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Start-AzureStorageBlobCopy

开始复制 Blob。

注意

本文档中引用的 cmdlet 用于管理使用服务管理 API 的旧式 Azure 资源。 若要了解用于管理 Azure 资源管理器资源的 cmdlet,请参阅 Az PowerShell 模块

语法

Start-AzureStorageBlobCopy
     [-SrcBlob] <String>
     -SrcContainer <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzureStorageBlobCopy
     -CloudBlob <CloudBlob>
     -DestContainer <String>
     [-DestBlob <String>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzureStorageBlobCopy
     -CloudBlob <CloudBlob>
     -DestCloudBlob <CloudBlob>
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzureStorageBlobCopy
     -CloudBlobContainer <CloudBlobContainer>
     [-SrcBlob] <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzureStorageBlobCopy
     -SrcShareName <String>
     -SrcFilePath <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzureStorageBlobCopy
     -SrcShare <CloudFileShare>
     -SrcFilePath <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzureStorageBlobCopy
     -SrcDir <CloudFileDirectory>
     -SrcFilePath <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzureStorageBlobCopy
     -SrcFile <CloudFile>
     -DestContainer <String>
     [-DestBlob <String>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzureStorageBlobCopy
     -SrcFile <CloudFile>
     -DestCloudBlob <CloudBlob>
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzureStorageBlobCopy
     -AbsoluteUri <String>
     -DestContainer <String>
     -DestBlob <String>
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

说明

Start-AzureStorageBlobCopy cmdlet 开始复制 Blob。

示例

示例 1:复制命名 Blob

C:\PS>Start-AzureStorageBlobCopy -SrcBlob "ContosoPlanning2015" -DestContainer "ContosoArchives" -SrcContainer "ContosoUploads"

此命令从名为 ContosoUploads 的容器启动名为 ContosoPlanning2015 的 Blob 的复制操作,并启动名为 ContosoArchives 的容器。

示例 2:获取容器以指定要复制的 blob

C:\PS>Get-AzureStorageContainer -Name "ContosoUploads" | Start-AzureStorageBlobCopy -SrcBlob "ContosoPlanning2015" -DestContainer "ContosoArchives"

此命令使用 Get-AzureStorageContainer cmdlet 获取名为 ContosoUploads 的容器,然后使用管道运算符将容器传递给当前 cmdlet。 该 cmdlet 启动名为 ContosoPlanning2015 的 Blob 的复制操作。 前面的 cmdlet 提供源容器。 DestContainer 参数将 ContosoArchives 指定为目标容器。

示例 3:获取要复制的 Blob

C:\PS>Get-AzureStorageBlob -Container "ContosoUploads" | Start-AzureStorageBlobCopy -DestContainer "ContosoArchives"

此命令使用 Get-AzureStorageBlob cmdlet 获取名为 ContosoUploads 的容器中的 Blob,然后使用管道运算符将结果传递给当前 cmdlet。 该 cmdlet 将 blob 的复制操作启动到名为 ContosoArchives 的容器。

示例 4:复制指定为对象的 Blob

C:\PS>$SrcBlob = Get-AzureStorageBlob -Container "ContosoUploads" -Blob "ContosoPlanning2015"
C:\PS> $DestBlob = Get-AzureStorageBlob -Container "ContosoArchives" -Blob "ContosoPlanning2015Archived"
C:\PS> Start-AzureStorageBlobCopy -ICloudBlob $SrcBlob.ICloudBlob -DestICloudBlob $DestBlob.ICloudBlob

第一个命令在名为 ContosoUploads 的容器中获取名为 ContosoPlanning2015 的 blob。 该命令将该对象存储在$SrcBlob变量中。

第二个命令在名为 ContosoArchives 的容器中获取名为 ContosoPlanning2015Archived 的 blob。 该命令将该对象存储在$DestBlob变量中。

最后一个命令启动从源容器到目标容器的复制操作。 该命令使用标准点表示法为$SrcBlob和$DestBlob blob 指定 ICloudBlob 对象。

示例 5:从 URI 复制 Blob

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

此命令为使用指定密钥的 ContosoGeneral 帐户创建上下文,然后将该密钥存储在$Context变量中。

第二个命令将文件从指定的 URI 复制到名为 ContosoArchive 的容器中名为 ContosoPlanning 的 Blob。 该命令在存储在$Context的上下文中启动复制操作。

参数

-AbsoluteUri

指定要复制到 Azure 存储 Blob 的文件的绝对 URI。

Type:String
Aliases:SrcUri, SourceUri
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-ClientTimeoutPerRequest

指定一个服务请求的客户端超时间隔(以秒为单位)。 如果上一次调用在指定的时间间隔内失败,此 cmdlet 将重试请求。 如果此 cmdlet 未在间隔过前收到成功的响应,则此 cmdlet 将返回错误。

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

-CloudBlob

从 Azure 存储客户端库指定 CloudBlob 对象。 若要获取 CloudBlob 对象,请使用 Get-AzureStorageBlob cmdlet。

Type:CloudBlob
Aliases:SrcICloudBlob, SrcCloudBlob, ICloudBlob, SourceICloudBlob, SourceCloudBlob
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-CloudBlobContainer

从 Azure 存储客户端库指定 CloudBlobContainer 对象。 此 cmdlet 从此参数指定的容器中复制 Blob。 若要获取 CloudBlobContainer 对象,请使用 Get-AzureStorageContainer cmdlet。

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

-ConcurrentTaskCount

指定最大并发网络调用。 可以使用此参数通过指定最大并发网络调用数来限制本地 CPU 和带宽使用量的并发性。 指定的值是绝对计数,不乘以核心计数。 此参数可帮助减少低带宽环境中的网络连接问题,例如每秒 100 千比特。 默认值为 10。

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

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-Context

指定 Azure 存储上下文。 若要获取存储上下文,请使用 New-AzureStorageContext cmdlet。

Type:IStorageContext
Aliases:SrcContext, SourceContext
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-DestBlob

指定目标 Blob 的名称。

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

-DestCloudBlob

指定目标 CloudBlob 对象

Type:CloudBlob
Aliases:DestICloudBlob, DestinationCloudBlob, DestinationICloudBlob
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DestContainer

指定目标容器的名称。

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

-DestContext

指定 Azure 存储上下文。 若要获取存储上下文,请使用 New-AzureStorageContext cmdlet。

Type:IStorageContext
Aliases:DestinationContext
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Force

指示此 cmdlet 覆盖目标 Blob,而不提示进行确认。

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

-ServerTimeoutPerRequest

指定请求的服务端超时间隔(以秒为单位)。 如果服务处理请求之前指定的间隔已过,则存储服务将返回错误。

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

-SrcBlob

指定源的 Blob 的名称。

Type:String
Aliases:SourceBlob
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SrcContainer

指定源容器的名称。

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

-SrcDir

从 Azure 存储客户端库指定 CloudFileDirectory 对象。

Type:CloudFileDirectory
Aliases:SourceDir
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SrcFile

从 Azure 存储客户端库指定 CloudFile 对象。 可以创建它或使用 Get-AzureStorageFile cmdlet。

Type:CloudFile
Aliases:SourceFile
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-SrcFilePath

指定源目录或源共享的源文件相对路径。

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

-SrcShare

从 Azure 存储客户端库指定 CloudFileShare 对象。 可以创建它或使用 Get-AzureStorageShare cmdlet。

Type:CloudFileShare
Aliases:SourceShare
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SrcShareName

指定源共享名称。

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

-WhatIf

显示在此 cmdlet 运行的情况下将会发生什么。 此 cmdlet 未运行。

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