次の方法で共有


Get-AzStorageContainer

ストレージ コンテナーを一覧表示します。

構文

ContainerName (既定)

Get-AzStorageContainer
    [[-Name] <String>]
    [-MaxCount <Int32>]
    [-ContinuationToken <BlobContinuationToken>]
    [-IncludeDeleted]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [<CommonParameters>]

ContainerPrefix

Get-AzStorageContainer
    -Prefix <String>
    [-MaxCount <Int32>]
    [-ContinuationToken <BlobContinuationToken>]
    [-IncludeDeleted]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [<CommonParameters>]

説明

Get-AzStorageContainer コマンドレットは、Azure のストレージ アカウントに関連付けられているストレージ コンテナーを一覧表示します。

例 1: 名前で Azure Storage コンテナーを取得する

Get-AzStorageContainer -Name container*

この例では、ワイルドカード文字を使用して、コンテナーで始まる名前を持つすべてのコンテナーの一覧を返します。

例 2: コンテナー名プレフィックスで Azure Storage コンテナーを取得する

Get-AzStorageContainer -Prefix "container"

この例では、Prefix パラメーターを使用して、コンテナーで始まる名前を持つすべてのコンテナーの一覧を返します。

例 3: Azure Storage コンテナーを一覧表示し、削除されたコンテナーを含める

$containers =  Get-AzStorageContainer -IncludeDeleted -Context $ctx

$containers

   Storage Account Name: storageaccountname

Name                 PublicAccess         LastModified                   IsDeleted  VersionId
----                 ------------         ------------                   ---------  ---------
testcon              Off                  8/28/2020 10:18:13 AM +00:00
testcon2                                  9/4/2020 12:52:37 PM +00:00    True       01D67D248986B6DA

$c[1].BlobContainerProperties

LastModified                   : 9/4/2020 12:52:37 PM +00:00
LeaseStatus                    : Unlocked
LeaseState                     : Expired
LeaseDuration                  :
PublicAccess                   :
HasImmutabilityPolicy          : False
HasLegalHold                   : False
DefaultEncryptionScope         : $account-encryption-key
PreventEncryptionScopeOverride : False
DeletedOn                      : 9/8/2020 4:29:59 AM +00:00
RemainingRetentionDays         : 299
ETag                           : "0x8D850D167059285"
Metadata                       : {}

この例では、ストレージ アカウントのすべてのコンテナー (削除されたコンテナーを含む) を一覧表示します。 次に、削除されたコンテナーのプロパティ (DeletedOn、RemainingRetentionDays など) を表示します。 削除されたコンテナーは、Enable-AzStorageBlobDeleteRetentionPolicy を使用してコンテナー の論理的な削除を有効にした後にのみ存在します。

パラメーター

-ClientTimeoutPerRequest

1 つのサービス要求に対するクライアント側のタイムアウト間隔を秒単位で指定します。 指定した間隔で前の呼び出しが失敗した場合、このコマンドレットは要求を再試行します。 間隔が経過する前にこのコマンドレットが正常な応答を受け取らない場合、このコマンドレットはエラーを返します。

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

型:

Nullable<T>[Int32]

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

パラメーター セット

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

-ConcurrentTaskCount

同時ネットワーク呼び出しの最大数を指定します。 このパラメーターを使用すると、同時ネットワーク呼び出しの最大数を指定することで、ローカル CPU と帯域幅の使用量を調整するコンカレンシーを制限できます。 指定した値は絶対カウントであり、コア数には乗算されません。 このパラメーターは、1 秒あたり 100 キロビットなどの低帯域幅環境でのネットワーク接続の問題を減らすのに役立ちます。 既定値は 10 です。

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

型:

Nullable<T>[Int32]

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

パラメーター セット

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

-Context

ストレージ コンテキストを指定します。 これを作成するには、New-AzStorageContext コマンドレットを使用できます。 クエリ コンテナーのアクセス許可にはストレージ アカウント キーのアクセス許可が必要であるため、SAS トークンから作成されたストレージ コンテキストを使用する場合、コンテナーのアクセス許可は取得されません。

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

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

パラメーター セット

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

-ContinuationToken

BLOB リストの継続トークンを指定します。

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

型:Microsoft.Azure.Storage.Blob.BlobContinuationToken
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

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

-DefaultProfile

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

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

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

パラメーター セット

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

-IncludeDeleted

削除されたコンテナーを含める。既定では、リスト コンテナーには削除されたコンテナーは含まれません

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

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

パラメーター セット

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

-MaxCount

このコマンドレットが返すオブジェクトの最大数を指定します。

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

型:

Nullable<T>[Int32]

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

パラメーター セット

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

-Name

コンテナー名を指定します。 コンテナー名が空の場合、コマンドレットはすべてのコンテナーを一覧表示します。 それ以外の場合は、指定した名前または通常の名前パターンに一致するすべてのコンテナーが一覧表示されます。

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

型:String
規定値:None
ワイルドカードのサポート:True
DontShow:False
Aliases:N, コンテナ

パラメーター セット

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

-Prefix

取得するコンテナーの名前で使用されるプレフィックスを指定します。 これを使用すると、"my" や "test" など、同じ文字列で始まるすべてのコンテナーを検索できます。

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

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

パラメーター セット

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

-ServerTimeoutPerRequest

要求のサービス側のタイムアウト間隔を秒単位で指定します。 サービスが要求を処理する前に指定した間隔が経過すると、ストレージ サービスはエラーを返します。

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

型:

Nullable<T>[Int32]

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

パラメーター セット

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

CommonParameters

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

入力

String

IStorageContext

出力

AzureStorageContainer