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

Remove-AzStorageBlob

删除指定的存储 Blob。

语法

NamePipeline (默认值)

Remove-AzStorageBlob
    [-Blob] <String>
    [-Container] <String>
    [-DeleteSnapshot]
    [-SnapshotTime <DateTimeOffset>]
    [-VersionId <String>]
    [-Force]
    [-PassThru]
    [-TagCondition <String>]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

BlobPipeline

Remove-AzStorageBlob
    -CloudBlob <CloudBlob>
    [-BlobBaseClient <BlobBaseClient>]
    [-DeleteSnapshot]
    [-Force]
    [-PassThru]
    [-TagCondition <String>]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ContainerPipeline

Remove-AzStorageBlob
    [-Blob] <String>
    -CloudBlobContainer <CloudBlobContainer>
    [-DeleteSnapshot]
    [-SnapshotTime <DateTimeOffset>]
    [-VersionId <String>]
    [-Force]
    [-PassThru]
    [-TagCondition <String>]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

Remove-AzStorageBlob cmdlet 从 Azure 中的存储帐户中删除指定的 Blob。

示例

示例 1:按名称删除存储 Blob

Remove-AzStorageBlob -Container "ContainerName" -Blob "BlobName"

此命令删除其名称标识的 Blob。

示例 2:使用管道删除存储 Blob

Get-AzStorageBlob -Container "ContainerName" -Blob "BlobName" | Remove-AzStorageBlob

此命令使用管道。

示例 3:使用管道删除存储 Blob

Get-AzStorageContainer -Container container* | Remove-AzStorageBlob -Blob "BlobName"

此命令使用星号 \ 通配符和管道检索 blob 或 blob,然后删除它们。

示例 4:删除单个 Blob 版本

Remove-AzStorageBlob -Container "containername" -Blob blob2 -VersionId "2020-07-03T16:19:16.2883167Z"

此命令删除具有 VersionId 的单个 Blob 版本。

示例 5:删除单个 Blob 快照

Remove-AzStorageBlob -Container "containername" -Blob blob1 -SnapshotTime "2020-07-06T06:56:06.8588431Z"

此命令使用 SnapshotTime 删除单个 Blob 快照。

参数

-Blob

指定要删除的 Blob 的名称。

参数属性

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

参数集

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

-BlobBaseClient

BlobBaseClient 对象

参数属性

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

参数集

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

-ClientTimeoutPerRequest

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

参数属性

类型:

Nullable<T>[Int32]

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

参数集

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

-CloudBlob

指定云 Blob。 若要获取 CloudBlob 对象,请使用 Get-AzStorageBlob cmdlet。

参数属性

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

参数集

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

-CloudBlobContainer

从 Azure 存储客户端库指定 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

-Confirm

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

参数属性

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

参数集

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

-Container

指定容器的名称。

参数属性

类型: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

-DeleteSnapshot

指定删除所有快照,但不要删除基本 Blob。 如果未指定此参数,则基本 Blob 及其快照将一起删除。 系统会提示用户确认删除作。

参数属性

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

参数集

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

-Force

指示此 cmdlet 在不确认的情况下删除 Blob 及其快照。

参数属性

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

参数集

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

-PassThru

指示此 cmdlet 返回反映作成功的 布尔值 。 默认情况下,此 cmdlet 不返回值。

参数属性

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

参数集

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

-ServerTimeoutPerRequest

指定要读取的 cmdlet 的 Azure 配置文件。 如果未指定,则 cmdlet 将从默认配置文件中读取。

参数属性

类型:

Nullable<T>[Int32]

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

参数集

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

-SnapshotTime

Blob SnapshotTime

参数属性

类型:

Nullable<T>[DateTimeOffset]

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

参数集

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

-TagCondition

用于检查匹配条件的可选标记表达式语句。 Blob 标记与给定表达式不匹配时,blob 请求将失败。 请参阅详细信息。https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations

参数属性

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

参数集

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

-VersionId

Blob VersionId

参数属性

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

参数集

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

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

参数属性

类型:SwitchParameter
默认值:False
支持通配符: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

输出

Boolean