Get-AzStorageContainer
ストレージ コンテナーを一覧表示します。
構文
Get-AzStorageContainer
[[-Name] <String>]
[-MaxCount <Int32>]
[-ContinuationToken <BlobContinuationToken>]
[-IncludeDeleted]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>] 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] |
| Aliases: | ClientTimeoutPerRequestInSeconds |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ConcurrentTaskCount
同時ネットワーク呼び出しの最大数を指定します。 このパラメーターを使用すると、同時ネットワーク呼び出しの最大数を指定することで、ローカル CPU と帯域幅の使用量を調整するコンカレンシーを制限できます。 指定した値は絶対カウントであり、コア数には乗算されません。 このパラメーターは、1 秒あたり 100 キロビットなどの低帯域幅環境でのネットワーク接続の問題を減らすのに役立ちます。 既定値は 10 です。
| 型: | Nullable<T>[Int32] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Context
ストレージ コンテキストを指定します。 これを作成するには、New-AzStorageContext コマンドレットを使用できます。 クエリ コンテナーのアクセス許可にはストレージ アカウント キーのアクセス許可が必要であるため、SAS トークンから作成されたストレージ コンテキストを使用する場合、コンテナーのアクセス許可は取得されません。
| 型: | IStorageContext |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ContinuationToken
BLOB リストの継続トークンを指定します。
| 型: | BlobContinuationToken |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。
| 型: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-IncludeDeleted
削除されたコンテナーを含める。既定では、リスト コンテナーには削除されたコンテナーは含まれません
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-MaxCount
このコマンドレットが返すオブジェクトの最大数を指定します。
| 型: | Nullable<T>[Int32] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
コンテナー名を指定します。 コンテナー名が空の場合、コマンドレットはすべてのコンテナーを一覧表示します。 それ以外の場合は、指定した名前または通常の名前パターンに一致するすべてのコンテナーが一覧表示されます。
| 型: | String |
| Aliases: | N, Container |
| 配置: | 0 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | True |
-Prefix
取得するコンテナーの名前で使用されるプレフィックスを指定します。 これを使用すると、"my" や "test" など、同じ文字列で始まるすべてのコンテナーを検索できます。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ServerTimeoutPerRequest
要求のサービス側のタイムアウト間隔を秒単位で指定します。 サービスが要求を処理する前に指定した間隔が経過すると、ストレージ サービスはエラーを返します。
| 型: | Nullable<T>[Int32] |
| Aliases: | ServerTimeoutPerRequestInSeconds |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |