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

Start-AzStorageFileCopy

模块:

Az.Storage

开始复制源文件。

语法

Start-AzStorageFileCopy
     -SrcBlobName <String>
     -SrcContainerName <String>
     -DestShareName <String>
     -DestFilePath <String>
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DisAllowDestTrailingDot]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageFileCopy
     -SrcBlobName <String>
     -SrcContainer <CloudBlobContainer>
     -DestShareName <String>
     -DestFilePath <String>
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageFileCopy
     -SrcBlob <CloudBlob>
     -DestShareName <String>
     -DestFilePath <String>
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageFileCopy
     -SrcBlob <CloudBlob>
     [-DestFile <CloudFile>]
     [-DestShareFileClient <ShareFileClient>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageFileCopy
     -SrcFilePath <String>
     -SrcShareName <String>
     -DestShareName <String>
     -DestFilePath <String>
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DisAllowSourceTrailingDot]
     [-DisAllowDestTrailingDot]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageFileCopy
     -SrcFilePath <String>
     -SrcShare <CloudFileShare>
     -DestShareName <String>
     -DestFilePath <String>
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageFileCopy
     -SrcFile <CloudFile>
     -DestShareName <String>
     -DestFilePath <String>
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageFileCopy
     -SrcFile <CloudFile>
     [-DestFile <CloudFile>]
     [-DestShareFileClient <ShareFileClient>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageFileCopy
     -AbsoluteUri <String>
     -DestShareName <String>
     -DestFilePath <String>
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageFileCopy
     -AbsoluteUri <String>
     [-DestFile <CloudFile>]
     [-DestShareFileClient <ShareFileClient>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

说明

Start-AzStorageFileCopy cmdlet 开始将源文件复制到目标文件。 此 cmdlet 将触发异步 Blob 复制，复制过程由服务器处理。 如果这是跨帐户 Blob 副本，则 Blob 副本没有 SLA。

示例

示例 1：使用共享名称和文件名从文件复制到文件开始复制操作

Start-AzStorageFileCopy -SrcShareName "ContosoShare01" -SrcFilePath "FilePath01" -DestShareName "ContosoShare02" -DestFilePath "FilePath02"

此命令启动从文件到文件的复制操作。 该命令指定共享名称和文件名

示例 2：使用容器名称和 Blob 名称开始从 Blob 复制到文件的操作

Start-AzStorageFileCopy -SrcContainerName "ContosoContainer01" -SrcBlobName "ContosoBlob01" -DestShareName "ContosoShare" -DestFilePath "FilePath02"

此命令启动从 Blob 到文件的复制操作。 该命令指定容器名称和 Blob 名称

参数

-AbsoluteUri

指定源文件的 URI。 如果源位置需要凭据，则必须提供凭据。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ClientTimeoutPerRequest

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

类型:	Nullable<T>[Int32]
别名:	ClientTimeoutPerRequestInSeconds
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ConcurrentTaskCount

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

类型:	Nullable<T>[Int32]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

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

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-Context

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

类型:	IStorageContext
别名:	SrcContext
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:	IAzureContextContainer
别名:	AzureRmContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DestContext

指定目标的Azure 存储上下文。 若要获取上下文，请使用 New-AzStorageContext。

类型:	IStorageContext
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DestFile

指定 CloudFile 对象。 可以使用 Get-AzStorageFile cmdlet 创建云文件或获取一个。

类型:	CloudFile
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DestFilePath

指定目标文件相对于目标共享的路径。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-DestShareFileClient

ShareFileClient 对象指示 Dest 文件。

类型:	ShareFileClient
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DestShareName

指定目标共享的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-DisAllowDestTrailingDot

禁止尾随点 （.） 后缀目标目录和目标文件名。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisAllowSourceTrailingDot

禁止尾随点 （.） 以后缀源目录和源文件名称。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Force

强制运行命令而不要求用户确认。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ServerTimeoutPerRequest

指定请求的服务器部分超时期限的长度。

类型:	Nullable<T>[Int32]
别名:	ServerTimeoutPerRequestInSeconds
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SrcBlob

指定 CloudBlob 对象。 可以使用 Get-AzStorageBlob cmdlet 创建云 Blob 或获取一个云 Blob。

类型:	CloudBlob
别名:	ICloudBlob
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-SrcBlobName

指定源 Blob 的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-SrcContainer

指定云 Blob 容器对象。 可以创建云 Blob 容器对象或使用 Get-AzStorageContainer cmdlet。

类型:	CloudBlobContainer
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-SrcContainerName

指定源容器的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-SrcFile

指定 CloudFile 对象。 可以使用 Get-AzStorageFile 创建云文件或获取一个。

类型:	CloudFile
别名:	CloudFile
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-SrcFilePath

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

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-SrcShare

指定云文件共享对象。 可以使用 Get-AzStorageShare cmdlet 创建云文件共享或获取一个。

类型:	CloudFileShare
别名:	CloudFileShare
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-SrcShareName

指定源共享的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

输入

CloudBlob

CloudFile

IStorageContext

输出

AzureStorageFile

相关链接

• Get-AzStorageBlob
• Get-AzStorageContainer
• Get-AzStorageFile
• Get-AzStorageShare
• Get-AzStorageFileCopyState
• Stop-AzStorageFileCopy