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

Get-AzStorageBlobCopyState

获取 Azure 存储 Blob 的副本状态。

语法

NamePipeline (默认值)

Get-AzStorageBlobCopyState
    [-Blob] <String>
    [-Container] <String>
    [-WaitForComplete]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [<CommonParameters>]

BlobPipeline

Get-AzStorageBlobCopyState
    -CloudBlob <CloudBlob>
    [-WaitForComplete]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [<CommonParameters>]

ContainerPipeline

Get-AzStorageBlobCopyState
    [-Blob] <String>
    -CloudBlobContainer <CloudBlobContainer>
    [-WaitForComplete]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [<CommonParameters>]

说明

Get-AzStorageBlobCopyState cmdlet 获取 Azure 存储 blob 的副本状态。 它应在复制目标 Blob 上运行。

示例

示例 1:获取 Blob 的副本状态

Get-AzStorageBlobCopyState -Blob "ContosoPlanning2015" -Container "ContosoUploads"

此命令获取容器 ContosoUploads 中名为 ContosoPlanning2015 的 blob 的副本状态。

示例 2:使用管道获取 Blob 的副本状态

Get-AzStorageBlob -Blob "ContosoPlanning2015" -Container "ContosoUploads" | Get-AzStorageBlobCopyState

此命令使用 Get-AzStorageBlob cmdlet 获取名为 ContosoUploads 的容器中名为 ContosoPlanning2015 的 Blob,然后使用管道运算符将结果传递给当前 cmdlet。 Get-AzStorageBlobCopyState cmdlet 获取该 blob 的复制状态。

示例 3:使用管道获取容器中 Blob 的复制状态

Get-AzStorageContainer -Name "ContosoUploads" | Get-AzStorageBlobCopyState -Blob "ContosoPlanning2015"

此命令使用 Get-AzStorageBlob cmdlet 获取命名的容器,然后将结果传递给当前 cmdlet。 Get-AzStorageContainer cmdlet 获取该容器中名为 ContosoPlanning2015 的 blob 的副本状态。

示例 4:启动复制和管道以获取复制状态

$destBlob = Start-AzStorageBlobCopy -SrcContainer "contosouploads" -SrcBlob "ContosoPlanning2015" -DestContainer "contosouploads2" -DestBlob "ContosoPlanning2015_copy"

$destBlob | Get-AzStorageBlobCopyState

第一个命令将 blob“ContosoPlanning2015”复制到“ContosoPlanning2015_copy”,并输出目标 blob 对象。 第二个命令管道将目标 Blob 对象传递给 Get-AzStorageBlobCopyState,以获取 Blob 复制状态。

参数

-Blob

指定 Blob 的名称。 此 cmdlet 获取此参数指定的 Azure 存储 Blob 的 Blob 复制作的状态。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

NamePipeline
Position:0
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
ContainerPipeline
Position:0
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ClientTimeoutPerRequest

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

参数属性

类型:

Nullable<T>[Int32]

默认值:None
支持通配符:False
不显示:False
别名:ClientTimeoutPerRequestInSeconds

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-CloudBlob

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

参数属性

类型:Microsoft.Azure.Storage.Blob.CloudBlob
默认值:None
支持通配符:False
不显示:False
别名:ICloudBlob

参数集

BlobPipeline
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-CloudBlobContainer

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

参数属性

类型:Microsoft.Azure.Storage.Blob.CloudBlobContainer
默认值:None
支持通配符:False
不显示:False

参数集

ContainerPipeline
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ConcurrentTaskCount

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

参数属性

类型:

Nullable<T>[Int32]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Container

指定容器的名称。 此 cmdlet 获取此参数指定的容器中 Blob 的复制状态。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

NamePipeline
Position:1
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Context

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

参数属性

类型:IStorageContext
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-DefaultProfile

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

参数属性

类型:IAzureContextContainer
默认值:None
支持通配符:False
不显示:False
别名:AzureRmContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ServerTimeoutPerRequest

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

参数属性

类型:

Nullable<T>[Int32]

默认值:None
支持通配符:False
不显示:False
别名:ServerTimeoutPerRequestInSeconds

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WaitForComplete

指示此 cmdlet 等待复制完成。 如果未指定此参数,此 cmdlet 将立即返回结果。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

Microsoft.Azure.Storage.Blob.CloudBlob

Microsoft.Azure.Storage.Blob.CloudBlobContainer

IStorageContext

输出

Microsoft.Azure.Storage.Blob.CopyState