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

Set-AzStorageBlobLegalHold

启用或禁用对存储 Blob 的法律保留。

语法

Set-AzStorageBlobLegalHold
   [-Blob] <String>
   [-Container] <String>
   [-EnableLegalHold]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzStorageBlobLegalHold
   -BlobBaseClient <BlobBaseClient>
   [-EnableLegalHold]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzStorageBlobLegalHold
   -BlobBaseClient <BlobBaseClient>
   [-DisableLegalHold]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzStorageBlobLegalHold
   [-Blob] <String>
   [-Container] <String>
   [-DisableLegalHold]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Set-AzStorageBlobLegalHold cmdlet 启用或禁用对存储 Blob 的法律保留。 仅当 Blob 容器已启用具有版本控制的不可变存储时,该 cmdlet 才有效。

示例

示例 1:对存储 Blob 启用法定保留。

$blob = Set-AzStorageBlobLegalHold -Container $containerName -Blob $blobname  -EnableLegalHold

$blob

   AccountName: mystorageaccount, ContainerName: mycontainer

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId                     
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------                     
testblob             BlockBlob 10485760        application/octet-stream       2021-07-19 08:56:00Z Hot                                     False      2021-07-19T08:56:01.8120788Z *

$blob.BlobProperties.HasLegalHold
True

此命令允许对存储 Blob 进行法定保留,然后显示结果。 仅当 Blob 容器已启用具有版本控制的不可变存储时,该命令才有效。

示例 2:使用管道禁用存储 Blob 的法定保留。

$blob = Get-AzStorageBlob -Container $containerName -Blob $blobname | Set-AzStorageBlobLegalHold -DisableLegalHold

$blob

   AccountName: mystorageaccount, ContainerName: mycontainer

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId                     
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------                     
testblob             BlockBlob 10485760        application/octet-stream       2021-07-19 08:56:00Z Hot                                     False      2021-07-19T08:56:01.8120788Z *

$blob.BlobProperties.HasLegalHold
False

此命令使用管道禁用存储 Blob 上的法定保留,然后显示结果。 仅当 Blob 容器已启用具有版本控制的不可变存储时,该命令才有效。

参数

-Blob

Blob 名称

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

-BlobBaseClient

BlobBaseClient 对象

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

-ClientTimeoutPerRequest

客户端每个请求的最大执行时间(以秒为单位)。

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

-ConcurrentTaskCount

并发异步任务的总数。 默认值为 10。

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

-Confirm

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

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

-Container

容器名称

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

-Context

Azure 存储上下文对象

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

-DefaultProfile

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

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

-DisableLegalHold

禁用 Blob 上的 LegalHold。

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

-EnableLegalHold

在 Blob 上启用 LegalHold。

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

-ServerTimeoutPerRequest

服务器为每个请求超时(以秒为单位)。

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

-WhatIf

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

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

输入

BlobBaseClient

IStorageContext

输出

AzureStorageBlob