次の方法で共有

Invoke-AzStorageActionTaskPreviewAction

モジュール:
Az.StorageAction Module

入力オブジェクトのメタデータ プロパティに対して入力条件を実行し、応答で一致するオブジェクトを指定します。

構文

PreviewExpanded (既定) 

Invoke-AzStorageActionTaskPreviewAction
    -Location <String>
    -Blob <IStorageTaskPreviewBlobProperties[]>
    [-SubscriptionId <String>]
    [-ActionElseBlockExist]
    [-ContainerMetadata <IStorageTaskPreviewKeyValueProperties[]>]
    [-ContainerName <String>]
    [-IfCondition <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

PreviewViaJsonString 

Invoke-AzStorageActionTaskPreviewAction
    -Location <String>
    -JsonString <String>
    [-SubscriptionId <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

PreviewViaJsonFilePath 

Invoke-AzStorageActionTaskPreviewAction
    -Location <String>
    -JsonFilePath <String>
    [-SubscriptionId <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

PreviewViaIdentityExpanded 

Invoke-AzStorageActionTaskPreviewAction
    -InputObject <IStorageActionIdentity>
    -Blob <IStorageTaskPreviewBlobProperties[]>
    [-ActionElseBlockExist]
    [-ContainerMetadata <IStorageTaskPreviewKeyValueProperties[]>]
    [-ContainerName <String>]
    [-IfCondition <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

入力オブジェクトのメタデータ プロパティに対して入力条件を実行し、応答で一致するオブジェクトを指定します。

例

例 1: 入力オブジェクトのメタデータ プロパティに対して入力条件を実行し、一致するオブジェクトを指定する

#create first blob
$creationTime = New-AzStorageActionTaskPreviewKeyValuePropertiesObject -Key "Creation-Time" -Value "Wed, 07 Jun 2023 05:23:29 GMT"
$lastModified = New-AzStorageActionTaskPreviewKeyValuePropertiesObject -Key "Last-Modified" -Value "Wed, 07 Jun 2023 05:23:29 GMT"
$etag = New-AzStorageActionTaskPreviewKeyValuePropertiesObject -Key "Etag" -Value "0x8DB67175454D36D"
$contentLength = New-AzStorageActionTaskPreviewKeyValuePropertiesObject -Key "Content-Length" -Value "38619"
$contentType = New-AzStorageActionTaskPreviewKeyValuePropertiesObject -Key "Content-Type" -Value "text/xml"
$contentEncoding = New-AzStorageActionTaskPreviewKeyValuePropertiesObject -Key "Content-Encoding" -Value ""
$contentLanguage = New-AzStorageActionTaskPreviewKeyValuePropertiesObject -Key "Content-Language" -Value ""
$contentCRC64 = New-AzStorageActionTaskPreviewKeyValuePropertiesObject -Key "Content-CRC64" -Value ""
$contentMD5 = New-AzStorageActionTaskPreviewKeyValuePropertiesObject -Key "Content-MD5" -Value "njr6iDrmU9+FC89WMK22EA=="
$cacheControl = New-AzStorageActionTaskPreviewKeyValuePropertiesObject -Key "Cache-Control" -Value ""
$contentDisposition = New-AzStorageActionTaskPreviewKeyValuePropertiesObject -Key "Content-Disposition" -Value ""
$blobType = New-AzStorageActionTaskPreviewKeyValuePropertiesObject -Key "BlobType" -Value "BlockBlob"
$accessTier = New-AzStorageActionTaskPreviewKeyValuePropertiesObject -Key "AccessTier" -Value "Hot"
$accessTierInferred = New-AzStorageActionTaskPreviewKeyValuePropertiesObject -Key "AccessTierInferred" -Value "true"
$leaseStatus = New-AzStorageActionTaskPreviewKeyValuePropertiesObject -Key "LeaseStatus" -Value "unlocked"
$leaseState = New-AzStorageActionTaskPreviewKeyValuePropertiesObject -Key "LeaseState" -Value "available"
$serverEncrypted = New-AzStorageActionTaskPreviewKeyValuePropertiesObject -Key "ServerEncrypted" -Value "true"
$tagCount = New-AzStorageActionTaskPreviewKeyValuePropertiesObject -Key "TagCount" -Value "1"
$metadata = New-AzStorageActionTaskPreviewKeyValuePropertiesObject -Key "mKey1" -Value "mValue1"
$tags = New-AzStorageActionTaskPreviewKeyValuePropertiesObject -Key "tKey1" -Value "tValue1"
$blob1 = New-AzStorageActionTaskPreviewBlobPropertiesObject -Name 'folder1/file1.txt' -Metadata $metadata -Property $creationTime -Tag $tags
#create second blob
$creationTime2 = New-AzStorageActionTaskPreviewKeyValuePropertiesObject -Key "Creation-Time" -Value "Wed, 06 Jun 2023 05:23:29 GMT"
$metadata2 = New-AzStorageActionTaskPreviewKeyValuePropertiesObject -Key "mKey2" -Value "mValue2"
$tags2 = New-AzStorageActionTaskPreviewKeyValuePropertiesObject -Key "tKey2" -Value "tValue2"
$blob2 = New-AzStorageActionTaskPreviewBlobPropertiesObject -Name 'folder2/file1.txt' -Metadata $metadata2 -Property $creationTime2 -Tag $tags2

$conmetadata = New-AzStorageActionTaskPreviewKeyValuePropertiesObject -Key "mContainerKey1" -Value "mContainerValue1"
Invoke-AzStorageActionTaskPreviewAction -Location eastus2euap -ActionElseBlockExist -Blob $blob1,$blob2 -ContainerMetadata $conmetadata -ContainerName firstContainer -IfCondition "[[equals(AccessTier, 'Hot')]]"

ActionElseBlockExist : True
Blob                 : {{
                         "name": "folder1/file1.txt",
                         "properties": [
                           {
                             "key": "Creation-Time",
                             "value": "Wed, 07 Jun 2023 05:23:29 GMT"
                           },
                           {
                             "key": "Last-Modified",
                             "value": "Wed, 07 Jun 2023 05:23:29 GMT"
                           },
                           {
                             "key": "Etag",
                             "value": "0x8DB67175454D36D"
                           },
                           {
                             "key": "Content-Length",
                             "value": "38619"
                           },
                           {
                             "key": "Content-Type",
                             "value": "text/xml"
                           },
                           {
                             "key": "Content-Encoding",
                             "value": ""
                           },
                           {
                             "key": "Content-Language",
                             "value": ""
                           },
                           {
                             "key": "Content-CRC64",
                             "value": ""
                           },
                           {
                             "key": "Content-MD5",
                             "value": "njr6iDrmU9+FC89WMK22EA=="
                           },
                           {
                             "key": "Cache-Control",
                             "value": ""
                           },
                           {
                             "key": "Content-Disposition",
                             "value": ""
                           },
                           {
                             "key": "BlobType",
                             "value": "BlockBlob"
                           },
                           {
                             "key": "AccessTier",
                             "value": "Hot"
                           },
                           {
                             "key": "AccessTierInferred",
                             "value": "true"
                           },
                           {
                             "key": "LeaseStatus",
                             "value": "unlocked"
                           },
                           {
                             "key": "LeaseState",
                             "value": "available"
                           },
                           {
                             "key": "ServerEncrypted",
                             "value": "true"
                           },
                           {
                             "key": "TagCount",
                             "value": "1"
                           }
                         ],
                         "metadata": [
                           {
                             "key": "mKey1",
                             "value": "mValue1"
                           }
                         ],
                         "tags": [
                           {
                             "key": "tKey1",
                             "value": "tValue1"
                           }
                         ],
                         "matchedBlock": "If"
                       }, {
                         "name": "folder2/file1.txt",
                         "properties": [
                           {
                             "key": "Creation-Time",
                             "value": "Wed, 06 Jun 2023 05:23:29 GMT"
                           },
                           {
                             "key": "Last-Modified",
                             "value": "Wed, 06 Jun 2023 05:23:29 GMT"
                           },
                           {
                             "key": "Etag",
                             "value": "0x6FB67175454D36D"
                           }
                         ],
                         "metadata": [
                           {
                             "key": "mKey2",
                             "value": "mValue2"
                           }
                         ],
                         "tags": [
                           {
                             "key": "tKey2",
                             "value": "tValue2"
                           }
                         ],
                         "matchedBlock": "Else"
                       }}
ContainerMetadata    : {{
                         "key": "mContainerKey1",
                         "value": "mContainerValue1"
                       }}
ContainerName        : firstContainer
IfCondition          : [[equals(AccessTier, 'Hot')]]

このコマンドは、入力オブジェクトのメタデータ プロパティに対して入力条件を実行し、一致するオブジェクトを指定します。

パラメーター

-ActionElseBlockExist

else ブロックが条件に存在するかどうかを指定します。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

PreviewExpanded
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
PreviewViaIdentityExpanded
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Blob

プレビュー アクションとの一致をテストするコンテナー内の一部のサンプル BLOB のプロパティ。

パラメーターのプロパティ

型:

IStorageTaskPreviewBlobProperties[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

PreviewExpanded
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
PreviewViaIdentityExpanded
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Confirm

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

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ContainerMetadata

指定された条件との一致についてテストするメタデータ キー値ペア。

パラメーターのプロパティ

型:

IStorageTaskPreviewKeyValueProperties[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

PreviewExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
PreviewViaIdentityExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ContainerName

テスト コンテナーの名前

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

PreviewExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
PreviewViaIdentityExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DefaultProfile

DefaultProfile パラメーターは機能しません。 別のサブスクリプションに対してコマンドレットを実行する場合は、使用可能な場合は SubscriptionId パラメーターを使用します。

パラメーターのプロパティ

型:PSObject
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:AzureRMContext, AzureCredential

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-IfCondition

一致のテスト対象となるストレージ タスクの条件。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

PreviewExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
PreviewViaIdentityExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-InputObject

IDENTITY パラメーター

パラメーターのプロパティ

型:IStorageActionIdentity
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

PreviewViaIdentityExpanded
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-JsonFilePath

プレビュー操作に指定された Json ファイルのパス

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

PreviewViaJsonFilePath
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-JsonString

プレビュー操作に指定された Json 文字列

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

PreviewViaJsonString
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Location

アクションのプレビューを実行する場所。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

PreviewExpanded
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
PreviewViaJsonString
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
PreviewViaJsonFilePath
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-SubscriptionId

ターゲット サブスクリプションの ID。 値は UUID である必要があります。

パラメーターのプロパティ

型:String
規定値:(Get-AzContext).Subscription.Id
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

PreviewExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
PreviewViaJsonString
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
PreviewViaJsonFilePath
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:ウィスコンシン

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

入力

IStorageActionIdentity

出力

IStorageTaskPreviewAction