你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Get-AzStorageFileCopyState
获取复制操作的状态。
语法
Get-AzStorageFileCopyState
[-ShareName] <String>
[-FilePath] <String>
[-WaitForComplete]
[-DisAllowTrailingDot]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>] Get-AzStorageFileCopyState
[-File] <CloudFile>
[-ShareFileClient <ShareFileClient>]
[-WaitForComplete]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>] 说明
Get-AzStorageFileCopyState cmdlet 获取Azure 存储文件复制操作的状态。 它应在复制目标文件上运行。
示例
示例 1：按文件名获取复制状态
Get-AzStorageFileCopyState -ShareName "ContosoShare" -FilePath "ContosoFile"此命令获取具有指定名称的文件的复制操作的状态。
示例 2：启动复制和管道以获取复制状态
$destfile = Start-AzStorageFileCopy -SrcShareName "contososhare" -SrcFilePath "contosofile" -DestShareName "contososhare2" -destfilepath "contosofile_copy"
$destfile | Get-AzStorageFileCopyState第一个命令开始将文件“contosofile”复制到“contosofile_copy”，并输出 destiantion 文件对象。 第二个命令管道将 destiantion 文件对象传递给 Get-AzStorageFileCopyState，以获取文件复制状态。
参数
-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 |
-Context
指定Azure 存储上下文。 若要获取上下文，请使用 New-AzStorageContext cmdlet。
| 类型: | IStorageContext |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
| 类型: | IAzureContextContainer |
| 别名: | AzureRmContext, AzureCredential |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DisAllowTrailingDot
禁止尾随点 （.） 后缀目录和文件名。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-File
指定 CloudFile 对象。 可以使用 Get-AzStorageFile cmdlet 创建云文件或获取一个。
| 类型: | CloudFile |
| 别名: | CloudFile |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-FilePath
指定文件相对于Azure 存储共享的路径。
| 类型: | String |
| Position: | 1 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-ServerTimeoutPerRequest
指定请求的服务器部分超时期限的长度。
| 类型: | Nullable<T>[Int32] |
| 别名: | ServerTimeoutPerRequestInSeconds |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ShareFileClient
ShareFileClient 对象指示要获取复制状态的文件。
| 类型: | ShareFileClient |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-ShareName
指定共享的名称。
| 类型: | String |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-WaitForComplete
指示此 cmdlet 等待复制完成。 如果未指定此参数，此 cmdlet 将立即返回结果。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
