Set-AzStorageBlobImmutabilityPolicy

リファレンス

モジュール:: Az.Storage

ストレージ BLOB の ImmutabilityPolicy を作成または更新します。

構文

Set-AzStorageBlobImmutabilityPolicy
   [-Blob] <String>
   [-Container] <String>
   -ExpiresOn <DateTimeOffset>
   [-PolicyMode <String>]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzStorageBlobImmutabilityPolicy
   -BlobBaseClient <BlobBaseClient>
   -ExpiresOn <DateTimeOffset>
   [-PolicyMode <String>]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Set-AzStorageBlobImmutabilityPolicy コマンドレットは、ストレージ BLOB の ImmutabilityPolicy を作成または更新します。このコマンドレットは、BLOB コンテナーがバージョン管理で不変ストレージを既に有効にしている場合にのみ機能します。

例

例 1: ストレージ BLOB の不変ポリシーを作成または更新する。

$blob = Set-AzStorageBlobImmutabilityPolicy -Container $containerName -Blob $blobname  -ExpiresOn (Get-Date).AddDays(100) -PolicyMode Unlocked

$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.ImmutabilityPolicy

ExpiresOn                    PolicyMode
---------                    ----------
10/27/2021 8:56:32 AM +00:00   Unlocked

このコマンドは、ストレージ BLOB の ImmutabilityPolicy を作成または更新し、BLOB とその ImmutabilityPolicy を表示します。このコマンドは、BLOB コンテナーがバージョン管理で不変ストレージを既に有効にしている場合にのみ機能します。

パラメーター

-Blob

BLOB 名

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-BlobBaseClient

BlobBaseClient オブジェクト

Type:	BlobBaseClient
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ClientTimeoutPerRequest

各要求のクライアント側の最大実行時間 (秒単位)。

Type:	Nullable<T>[Int32]
Aliases:	ClientTimeoutPerRequestInSeconds
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConcurrentTaskCount

同時実行非同期タスクの合計量。既定値は 10 です。

Type:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Container

コンテナー名

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Context

Azure Storage Context オブジェクト

Type:	IStorageContext
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ExpiresOn

Blob ImmutabilityPolicy ExpiresOn

Type:	Nullable<T>[DateTimeOffset]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PolicyMode

Blob ImmutabilityPolicy PolicyMode

Type:	String
Accepted values:	Unlocked, Locked, Mutable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServerTimeoutPerRequest

各要求のサーバータイムアウト (秒単位)。

Type:	Nullable<T>[Int32]
Aliases:	ServerTimeoutPerRequestInSeconds
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TagCondition

一致条件をチェックするオプションの Tag 式ステートメント。 BLOB タグが指定された式と一致しない場合、BLOB 要求は失敗します。の詳細を https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations参照してください。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

コマンドレットの実行時に発生する内容を示します。このコマンドレットは実行されません。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

BlobBaseClient

IStorageContext

出力

AzureStorageBlob