다음을 통해 공유

Get-AzStorageContainer

  • 참조
모듈:
Az.Storage

스토리지 컨테이너를 나열합니다.

구문

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>]

Description

Get-AzStorageContainer cmdlet은 Azure의 스토리지 계정과 연결된 스토리지 컨테이너를 나열합니다.

예제

예제 1: 이름으로 Azure Storage 컨테이너 가져오기

Get-AzStorageContainer -Name container*

이 예제에서는 와일드카드 문자를 사용하여 컨테이너로 시작하는 이름의 모든 컨테이너 목록을 반환합니다.

예제 2: 컨테이너 이름 접두사로 Azure Storage 컨테이너 가져오기

Get-AzStorageContainer -Prefix "container"

이 예제에서는 접두사 매개 변수를 사용하여 컨테이너로 시작하는 이름의 모든 컨테이너 목록을 반환합니다.

예제 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를 사용하여 컨테이너 softdelete를 사용하도록 설정한 후에만 존재합니다.

매개 변수

-ClientTimeoutPerRequest

하나의 서비스 요청에 대한 클라이언트 쪽 제한 시간 간격(초)을 지정합니다. 이전 호출이 지정된 간격으로 실패하면 이 cmdlet은 요청을 다시 시도합니다. 이 cmdlet이 간격이 경과하기 전에 성공적인 응답을 받지 못하면 이 cmdlet은 오류를 반환합니다.

형식:Nullable<T>[Int32]
별칭:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ConcurrentTaskCount

최대 동시 네트워크 호출을 지정합니다. 이 매개 변수를 사용하여 동시 네트워크 호출의 최대 수를 지정하여 로컬 CPU 및 대역폭 사용을 제한하는 동시성을 제한할 수 있습니다. 지정된 값은 절대 개수이며 코어 수를 곱하지 않습니다. 이 매개 변수는 초당 100킬로비트와 같은 낮은 대역폭 환경에서 네트워크 연결 문제를 줄이는 데 도움이 될 수 있습니다. 기본값은 10입니다.

형식:Nullable<T>[Int32]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Context

스토리지 컨텍스트를 지정합니다. 만들려면 New-AzStorageContext cmdlet을 사용할 수 있습니다. 쿼리 컨테이너 권한에는 스토리지 계정 키 권한이 필요하기 때문에 SAS 토큰에서 만든 스토리지 컨텍스트를 사용하는 경우 컨테이너 권한이 검색되지 않습니다.

형식:IStorageContext
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ContinuationToken

Blob 목록에 대한 연속 토큰을 지정합니다.

형식:BlobContinuationToken
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:IAzureContextContainer
별칭:AzureRmContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-IncludeDeleted

삭제된 컨테이너 포함, 기본적으로 목록 컨테이너에는 삭제된 컨테이너가 포함되지 않습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-MaxCount

이 cmdlet이 반환하는 최대 개체 수를 지정합니다.

형식:Nullable<T>[Int32]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Name

컨테이너 이름을 지정합니다. 컨테이너 이름이 비어 있으면 cmdlet은 모든 컨테이너를 나열합니다. 그렇지 않으면 지정된 이름 또는 일반 이름 패턴과 일치하는 모든 컨테이너가 나열됩니다.

형식:String
별칭:N, Container
Position:0
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:True

-Prefix

가져올 컨테이너 또는 컨테이너의 이름에 사용되는 접두사를 지정합니다. 이를 사용하여 "my" 또는 "test"와 같은 동일한 문자열로 시작하는 모든 컨테이너를 찾을 수 있습니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ServerTimeoutPerRequest

요청에 대한 서비스 쪽 제한 시간 간격(초)을 지정합니다. 서비스에서 요청을 처리하기 전에 지정된 간격이 경과하면 스토리지 서비스가 오류를 반환합니다.

형식:Nullable<T>[Int32]
별칭:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

String

IStorageContext

출력

AzureStorageContainer